quicklook插件安装失效主因是未完成「注册→刷新→重启」闭环；推荐拖拽.app安装法（自动注册）、手动复制.qlgenerator文件（精准控制）或homebrew cask一键安装，并务必执行qlmanage -r、重启finder及验证加载。
QuickLook插件装不上？大概率不是插件问题，而是没走完「注册→刷新→重启」闭环。装完不生效是常态，不是例外。
拖拽.app安装法（新手最稳）
适合完全不想碰终端、只要“下载即用”的用户。系统会自动把 QLMarkdown.app 或 BetterZipQL.app 注册进 QuickLook 框架，并处理权限和签名验证。
- 下载目标插件的
.app格式包（注意不是.zip或源码） - 直接拖进
~/Applications（仅当前用户）或/Applications（全系统可用） - 双击运行一次 —— 窗口可能闪退，这是正常行为，表示注册已完成
手动复制.qlgenerator文件（精准控制作用范围）
当你只想让插件对当前账户生效，或需要确认插件是否被正确识别时，这个方法最透明。路径和权限错一个字，qlmanage -r 都白跑。
- 下载纯插件文件，如
QuickLookJSON.qlgenerator、QLColorCode.qlgenerator - 在访达中按
Shift + Command + G，输入~/Library/QuickLook/进入用户级目录 - 粘贴插件文件；若要全局启用，改用
sudo cp -r *.qlgenerator /Library/QuickLook/（需输密码） - 右键插件 → 「显示简介」→ 底部「共享与权限」确认有「读与写」，否则系统会静默忽略
Homebrew Cask一键安装（终端党首选）
适合已装 Homebrew 且常批量管理工具的用户。命令简洁，卸载也明确，但要注意 Cask 名和实际插件名不一定一致 —— 比如 quicklookjson 对应的是 JSON 插件，不是 qljson。
- 确保 Homebrew 已就绪：
brew --version能返回版本号 - 执行：
brew install --cask qlmarkdown quicklookjson betterzipql - 想装更多？查官方列表：
brew search quicklook，常见还有gltfquicklook、webpquicklook
装完必须做的三件事（90%失效问题出在这）
无论哪种安装方式，跳过这步等于没装。系统不会自动重载插件缓存，Finder 也不会感知变化。
- 终端执行：
qlmanage -r，等待输出QuickLook framework restarted. - 立刻重启 Finder：
Option + Command + Esc→ 选中 Finder → 「重新启动」 - 验证是否加载成功：
qlmanage -m | grep quicklook，输出里应出现插件名（如QLMarkdown），没有就说明路径/权限/签名任一环节失败
最容易被忽略的是：文件扩展名大小写敏感（.JSON ≠ .json），以及 macOS 对未公证插件的 Gatekeeper 限制 —— 若插件来自非 Mac App Store 来源，首次使用时可能弹窗提示“已损坏”，需右键「打开」绕过。这不是 bug，是系统在认真工作。
