MacOS QuickLook插件支持扩展空格键预览，推荐新手拖拽.app安装、终端用户用Homebrew、进阶者手动复制.qlgenerator至对应路径，并务必执行qlmanage -r刷新缓存。
MacOS 的 QuickLook 插件能让空格键预览支持更多文件类型，安装不难，关键是选对方式、放对位置、及时刷新。
三种主流安装方式怎么选
新手推荐拖拽.app安装：下载插件包（如 QLMarkdown.app 或 BetterZipQL.app），直接拖进 应用程序 文件夹，双击运行一次即可自动注册，无需命令行。
习惯终端的用户用 Homebrew 最省心：
brew install --cask qlmarkdown quicklookjson betterzipql
一条命令装多个，后续卸载也只需 brew uninstall --cask。
手动安装适合精准控制：下载 .qlgenerator 文件（例如 QLColorCode.qlgenerator），复制到以下任一路径：
• 当前用户专用：~/Library/QuickLook/
• 全系统可用：/Library/QuickLook/（需管理员密码）
装完必须做的关键一步
无论哪种方式，安装后都要刷新系统缓存，否则插件不会生效：
- 打开终端，输入 qlmanage -r，回车
- 等待返回 "QuickLook framework restarted." 即成功
- 建议顺手重启 Finder：按 Option + Command + Esc，选 Finder → 重新启动
常见格式扩展效果一览
装好插件后，这些文件类型就能直接空格预览了：
- 代码类：.json（格式化+高亮）、.md / .markdown（渲染成网页样式）、.py / .js / .java（语法着色）、无后缀文本（如 README）
- 压缩包：.zip、.rar、.7z、.tar.gz（显示内部文件列表，不需解压）
- 专业格式：.webp（现代图片）、.gltf（3D 模型）、.fb2（电子书）、.ase（Adobe 色板）
- 其他实用支持：.avi / .mkv（视频缩略帧+播放）、.fit（运动设备数据）、.xml（结构化展开）
插件没反应？快速排查三步
预览不出现或显示乱码，按顺序检查：
- 确认文件扩展名是否完全匹配插件说明（比如 .JSON 大写可能不识别，应为小写 .json）
- 查看插件是否真在 ~/Library/QuickLook/ 目录下，且权限正常（右键 → 显示简介 → 共享与权限里有“读与写”）
- 执行 qlmanage -m | grep quicklook，看输出中是否列出对应插件名（如 QLMarkdown），没有就说明未加载成功
