macos原生quick look不支持压缩包内容预览，因系统未内置解析zip/rar/7z等格式的.qlgenerator插件；需安装betterzipql插件并重启finder方可实现空格键展开查看。

空格键预览压缩包为什么默认不工作

macOS 原生 Quick Look 对 ZIP、RAR、7Z 等压缩包只显示图标，不展开内容——这不是你操作错了，是系统根本没内置这个能力。它连 unzip -l 都不调用，纯粹靠文件扩展名匹配预览规则，而压缩格式不在白名单里。

• 常见错误现象：按下空格键后只看到一个大图标，右下角写着“无法预览”或直接空白
• 根本原因：系统没加载能解析压缩包结构的 .qlgenerator 插件
• 兼容性影响：macOS 14–15（Sequoia）对插件签名要求更严，~/Library/QuickLook/ 下未公证的插件可能被静默禁用
• 验证方式：终端运行 qlmanage -m | grep quicklook，若输出中不含 BetterZipQL 或 QLStephen，说明插件未生效

安装 BetterZipQL 是最稳的压缩包预览方案

它不是“BetterZip 软件”，而是其配套的轻量 .qlgenerator 插件，专为 Quick Look 设计，支持 ZIP、RAR、7Z、TAR.GZ 等主流格式，且能渲染缩略图（比如压缩包里的 PNG/JPG）。

• 实操步骤：下载 BetterZip → 打开 App → 菜单栏选 BetterZip → 安装 Quick Look 插件 → 终端执行 qlmanage -r → Option+右键 Finder 图标 → 重新开启
• 为什么推荐它：比手动凑一堆插件更可靠；支持点击子文件二次预览（比如点开 ZIP 里的 PDF，再按空格看内容）
• 容易踩的坑：安装插件后没重启 Finder，或误把插件拖进了 /System/Library/QuickLook/（系统目录不可写，会失败）
• 性能提示：首次预览大型压缩包（>500 个文件）会有 1–2 秒延迟，这是正常解析开销，非卡顿

代码文件预览靠 QLColorCode + QLMarkdown 组合

原生 Quick Look 只能粗略显示 .py/.js 等文本，无语法高亮、无行号、不渲染 Markdown 表格——这些必须靠插件补足。

• QLColorCode：支持 Python、Rust、TypeScript 等 60+ 语言，高亮准确，但不处理注释折叠或跳转
• QLMarkdown：实时渲染 .md 文件，支持表格、代码块、数学公式（需启用 MathJax）
• 安装路径必须是 ~/Library/QuickLook/（当前用户），不能放错成 /Library/QuickLook/（需管理员密码且 macOS 15 可能拒绝加载）
• 常见失效场景：文件没有扩展名（如脚本 deploy）→ 此时要配 QLStephen；文件编码是 GBK → 会乱码，需先转 UTF-8

命令行快速验证比 GUI 更快

当你不确定预览是否真生效，或需要批量检查一堆压缩包内容时，终端命令比反复按空格更直接、可复现。

• unzip -l archive.zip：列出 ZIP 内所有路径与大小，不含嵌套目录树
• tar -tzf archive.tar.gz | head -20：查看 TAR 类前 20 行，避免长列表刷屏
• 7z l archive.7z：7-Zip 格式需先 brew install p7zip
• 关键区别：Quick Look 插件只做展示，不改变文件；命令行输出可管道过滤、重定向、写入脚本
• 容易忽略的点：tar -t 不支持 .zip，unzip -l 不支持 .tar.gz —— 格式和命令必须严格对应

插件装完不重启 Finder 就等于没装；命令行命令记混格式就会报错；还有，别试图让 Quick Look 预览加密 ZIP——它不处理密码，会直接失败。