需安装第三方QuickLook插件:一、QLColorCode实现代码语法高亮;二、DWG QuickLook预览CAD图纸;三、iPreview支持全格式(含DWG、IPYNB、MD等);四、BetterZipQL链式预览压缩包内CAD文件;五、用qlmanage -m验证插件注册状态。

如果您希望在 macOS 中通过空格键一键预览 CAD 图纸或各类代码文件,但系统原生 Quick Look 无法识别 DWG、DXF 或高亮显示编程语言,则需借助第三方 QuickLook 插件扩展能力。以下是多种可立即生效的解决方案:
一、安装QLColorCode实现代码语法高亮预览
QLColorCode 是专为开发者设计的插件,支持 Java、Python、C++、Swift、JavaScript、Rust、Go 等数十种语言的实时语法着色渲染,让空格键预览代码时结构清晰、语义可辨。
1、打开终端,执行命令:brew install --cask qlcolorcode
2、安装完成后,在终端中运行:qlmanage -r 刷新 QuickLook 插件缓存
3、在 Finder 中选中任意 .py、.java、.js 等源码文件,按下空格键,即可看到带颜色标识的代码内容
二、部署DWG QuickLook插件预览CAD图纸
原生 macOS 不支持 DWG、DXF 等 CAD 工程图纸格式预览,DWG Tools 提供轻量级 .qlgenerator 插件,可直接渲染二维 CAD 文件缩略图与基础几何结构,无需启动 AutoCAD。
1、访问官方项目页面下载 DWGQuickLook.qlgenerator 文件
2、将该文件复制到用户级插件目录:~/Library/QuickLook/
3、在终端中运行:qlmanage -r 强制重载插件注册表
4、在 Finder 中选中 .dwg 或 .dxf 文件,按空格键即可查看图纸轮廓与图层基本信息
三、组合安装iPreview获取全栈预览能力
iPreview 是集成化程度最高的 QuickLook 扩展应用,不仅覆盖 DWG 和全部主流代码格式,还支持 Markdown 实时渲染、Jupyter Notebook 预览、WebP/AVIF 图像、字幕文件及 3D 模型(GLTF)等,适合多角色协同工作场景。
1、从 GitHub 发布页下载 iPreview.app 安装包
2、将应用拖入“应用程序”文件夹,并首次运行以完成系统权限授权
3、在终端中执行:qlmanage -r 确保插件服务已加载
4、选中 .dwg、.ipynb、.md、.glb 等任意受支持文件,按空格键启动增强型预览窗口
四、手动启用BetterZipQL预览压缩包内CAD资源
工程团队常将 DWG 文件打包为 ZIP/RAR 分发,BetterZipQL 可在不解压前提下直接浏览压缩包内部结构,并对其中嵌套的 CAD 文件触发对应预览插件,形成链式预览通路。
1、通过 Homebrew 安装:brew install --cask betterzipql
2、安装后运行:qlmanage -r 同步插件索引
3、选中包含 .dwg 的 .zip 文件,按空格键进入压缩包列表视图
4、使用方向键高亮目标 DWG 文件,按回车键直接调用 DWGQuickLook 进行渲染
五、验证与故障响应:快速确认插件是否生效
当某类文件仍无法预览时,需排除插件注册失败或路径冲突问题,此步骤不依赖外部工具,仅用系统原生命令完成诊断。
1、在终端中执行:qlmanage -m | grep -i dwg 查看 DWG 格式是否被任一插件声明支持
2、执行:qlmanage -m | grep -i python 确认 QLColorCode 是否已注册 .py 处理器
3、若无输出,说明对应插件未正确安装或未刷新缓存,需重新执行 qlmanage -r
4、检查插件文件权限:运行 ls -l ~/Library/QuickLook/,确保所有 .qlgenerator 文件具有读取权限










