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——它不处理密码，会直接失败。
