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，是系统在认真工作。