mac上可通过安装qlcolorcode插件实现quick look代码文件语法高亮;需用homebrew或手动安装插件,执行qlmanage -r重载服务,并验证注册、权限与缓存后,即可预览python、js等代码的彩色高亮效果。

在Mac上用空格键快速查看(Quick Look)预览代码文件时,默认不支持语法高亮,需借助第三方开源插件实现;该方案依赖QuickLook插件机制,需手动安装、注册并启用插件,不修改系统文件,不影响系统稳定性。
安装quicklook-json与qlmarkdown等基础插件
打开终端,依次执行以下命令安装常用QuickLook扩展:
brew install --cask quicklook-json qlmarkdown suspicious-package quicklookase
这一步会安装JSON、Markdown、压缩包、ASE色彩文件等格式的预览支持,其中qlmarkdown后续可复用其语法高亮渲染逻辑,为代码插件打下基础。
安装核心代码高亮插件——QLColorCode
QLColorCode是专为Quick Look设计的开源代码高亮插件,支持C、Python、JavaScript、Shell、YAML等主流语言。
方法一:通过Homebrew安装(推荐)
brew install --cask qlcolorcode
方法二:手动下载安装
访问 GitHub 仓库 https://github.com/anthonygelibert/QLColorCode/releases → 下载最新版 QLColorCode.qlgenerator → 双击安装(自动复制到 ~/Library/QuickLook/)
【必须重启QuickLook服务】 否则空格预览仍无高亮:在终端运行 qlmanage -r,输出 Resetting QuickLook 即成功。
验证并强制刷新插件注册状态
第一步:确认插件已注册
在终端运行:qlmanage -m | grep "QLColorCode"
若返回一行含 QLColorCode.qlgenerator 的路径,说明已注册;若无输出,说明插件未生效。
第二步:检查插件目录权限
进入 ~/Library/QuickLook/,确保 QLColorCode.qlgenerator 文件存在且非只读。右键显示简介→“共享与权限”中,当前用户需有“读与写”权限。
第三步:强制重建插件缓存
执行:qlmanage -r cache → 再次运行 qlmanage -r → 关闭所有Finder窗口,重新打开一个新窗口。
测试不同代码文件的空格预览效果
新建测试文件夹,放入以下任意文件:
test.py(含print("Hello")和缩进)、style.css(含选择器与花括号)、Dockerfile(含FROM/RUN指令)、.env(含KEY=VALUE)
在Finder中选中任一文件 → 按空格键 → 观察是否出现带颜色的关键字、字符串、注释等高亮样式。
如仍为纯文本显示,请检查文件扩展名是否被系统识别为对应类型(例如 .js 必须是小写;.PY 不会被识别);【QuickLook仅根据扩展名匹配语法,不解析文件内容】。











