需安装并配置 QLColorCode 插件:用 brew install --cask qlcolorcode 安装,执行 qlmanage -r 刷新,再运行 xattr -d -r com.apple.quarantine ~/Library/QuickLook 解除隔离;对 .dart 等不支持后缀,需手动在 Info.plist 的 LSItemContentTypes 中添加对应 UTI(如 public.dart-source),保存后再次 qlmanage -r 生效。

在 macOS 中让 QuickLook 支持源代码高亮预览,核心是安装并配置 QLColorCode 插件。它原生支持 100+ 种编程语言(如 Python、JavaScript、Rust、Go),但默认不包含所有后缀(比如 .dart、.ts、.vue),需要手动扩展识别范围。
安装 QLColorCode 插件
推荐使用 Homebrew 命令一键安装(稳定、易管理):
- 终端运行:
brew install --cask qlcolorcode - 若提示
brew cask已弃用,改用:brew install --cask qlcolorcode(Homebrew 4.0+ 已统一命令) - 安装完成后执行:
qlmanage -r刷新 QuickLook 缓存
解决 Catalina 及更新系统(10.15+)的隔离限制
macOS 会阻止未签名插件运行,需清除隔离属性:
- 运行:
xattr -d -r com.apple.quarantine ~/Library/QuickLook/ - 如果插件目录不存在,先创建:
mkdir -p ~/Library/QuickLook - 重启 Finder(按
Option + Command + Esc,选 Finder → 重新启动)
添加自定义文件类型(如 .dart、.ts、.mdx)
QLColorCode 默认不识别某些冷门或新语言后缀,需手动注册其 UTI 类型:
- 打开配置文件:
open ~/Library/QuickLook/QLColorCode.qlgenerator/Contents/Info.plist - 定位到
CFBundleDocumentTypes → Item 0 → LSItemContentTypes - 点击 ➕ 添加新行,填入对应 UTI(不是后缀名);例如:
public.dart-source或com.apple.dt.document.swift - 不确定 UTI?终端运行:
mdls -name kMDItemContentType 文件名.dart查看实际类型 - 保存后再次执行
qlmanage -r
验证与常用搭配
配置完成即可测试:
- 在 Finder 中选中任意支持的源码文件(如
main.py),按空格键查看高亮效果 - 建议同步安装
QLMarkdown(brew install --cask qlmarkdown)预览 README - JSON 文件推荐加装
QuickLookJSON,结构化显示更清晰


















