在 macos 中需安装 qlcolorcode 插件并执行三步:用 homebrew 安装、运行 qlmanage -r 刷新缓存、用 xattr -d 清除隔离属性;部分后缀如 .dart 需手动添加 uti 类型至 info.plist。
要在 macos 中让空格键预览源代码文件并显示语法高亮,核心是安装并正确配置 qlcolorcode 插件。它原生支持 python、javascript、rust、go、java 等 100+ 种语言,但需完成安装、解除系统隔离、刷新缓存三步,部分后缀(如 .dart、.ts)还需手动添加类型识别。
用 Homebrew 一键安装 QLColorCode
这是最稳定、易维护的方式:
- 打开“终端”,运行:
brew install --cask qlcolorcode - 若提示命令不存在,先安装 Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装完成后立即执行:
qlmanage -r刷新 QuickLook 缓存
解除 macOS 隔离属性(Catalina 及更新系统必需)
macOS 会阻止未签名插件运行,导致预览无反应:
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流:PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景:(1) "安装我的自动化服务",(2) "部署所有 Automato...
- 运行:
xattr -d -r com.apple.quarantine ~/Library/QuickLook/ - 如果目录不存在,先创建:
mkdir -p ~/Library/QuickLook - 再重启 Finder:按 Option + Command + Esc → 选中“访达” → “重新启动”
添加自定义后缀支持(如 .dart、.ts、.vue)
QLColorCode 默认不识别某些新语言或小众后缀,需手动注册其 UTI 类型:
- 打开配置文件:
open ~/Library/QuickLook/QLColorCode.qlgenerator/Contents/Info.plist - 定位到
CFBundleDocumentTypes → Item 0 → LSItemContentTypes - 点击 ➕ 添加新行,填入对应 UTI(不是后缀名),例如:
public.dart-source或public.typescript-source - 不确定 UTI?在终端运行:
mdls -name kMDItemContentType 示例.dart查看实际类型 - 保存后再次执行:
qlmanage -r
验证与搭配建议
配置完成后即可测试:
- 在访达中选中一个
.py或.rs文件,按空格键——应看到带颜色的高亮代码 - 推荐同步安装
qlmarkdown(brew install --cask qlmarkdown)用于预览.md和.mdx文档 - 如仍显示纯文本,检查是否遗漏
qlmanage -r或隔离属性未清除










