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

要在 macOS 的访达中直接按空格键预览所有代码源文件(如 .py、.rs、.dart、.ts、.vue 等),并看到带语法高亮的彩色代码,必须安装 QLColorCode 插件,并完成系统级适配——仅靠双击打开编辑器或默认 QuickLook 无法实现高亮渲染,且部分后缀 macOS 根本不识别。
用 Homebrew 安装 QLColorCode
这一步是基础,也是最稳定可控的方式:打开“终端”,粘贴执行:
brew install --cask qlcolorcode
如果提示 brew 命令未找到,先运行安装命令:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。安装过程约 10~30 秒,完成后不要关闭终端。
解除插件隔离属性(Catalina 及更新系统必需)
macOS 从 10.15 Catalina 开始,默认阻止未签名的 QuickLook 插件运行,即使安装成功,空格键预览也会静默失败——你只会看到空白窗口或纯文本无高亮。
执行以下命令清除隔离属性:
xattr -d -r com.apple.quarantine ~/Library/QuickLook/
【若提示目录不存在,请先手动创建】:mkdir -p ~/Library/QuickLook
这条命令必须运行,否则后续所有配置都无效。它不是可选项,而是系统强制要求的安全绕过步骤。
刷新 QuickLook 缓存并重启访达
安装和解隔离后,系统缓存仍指向旧状态,必须强制刷新:
qlmanage -r
然后重启访达:按 Option + Command + Esc → 在“强制退出”窗口中选中“访达” → 点击“重新启动”。
这一步不能跳过,也不能用关闭再打开访达窗口代替——只有进程级重启才能加载新插件。
添加自定义后缀支持(如 .dart、.ts、.vue)
QLColorCode 默认支持 Python、Rust、Go、Java 等 100+ 主流语言,但对 Dart、TypeScript、Vue 单文件组件等,macOS 不会自动将其识别为“源代码类型”,导致空格键仍显示纯文本或无响应。
第一步:确认目标文件的真实 UTI 类型
在终端中运行:mdls -name kMDItemContentType ./example.dart(把 example.dart 换成你本地任意一个该后缀文件)
第二步:编辑插件配置文件
执行:open ~/Library/QuickLook/QLColorCode.qlgenerator/Contents/Info.plist
在打开的 Xcode 或文本编辑器中,定位到:CFBundleDocumentTypes → Item 0 → LSItemContentTypes
点击右侧 ➕ 按钮新增一行,填入上一步查到的 UTI(例如 public.dart-source 或 public.typescript-source,不是 .dart 或 .ts)
第三步:保存文件,再次执行 qlmanage -r 刷新缓存
现在选中对应后缀文件,按空格键即可看到语法高亮预览。

















