Mac如何设置文件快速预览？QL插件管理技巧-MAC-PHP中文网

Mac如何设置文件快速预览？QL插件管理技巧

看不見的法師

发布： 2025-08-16 08:31:01

原创

968人浏览过

mac上的文件快速预览（quick look）可通过安装第三方ql插件扩展支持格式，推荐使用homebrew cask或手动将.qlgenerator文件放入~/library/quicklook/或/library/quicklook/目录；安装后若不生效，需在终端执行qlmanage -r cache刷新缓存；常用插件包括qlcolorcode（代码高亮）、qlstephen（无扩展名文本预览）、quicklookjson（json格式化）、qlvideo（视频格式支持）、webpquicklook（webp图片预览）和suspiciouspackage（pkg包内容查看）；管理插件可通过手动删除或移动插件文件禁用，或使用brew uninstall --cask [插件名]卸载，操作后均需刷新缓存，且不应修改系统内置插件目录。

Mac如何设置文件快速预览？QL插件管理技巧

Mac上的文件快速预览，也就是我们常说的Quick Look，其实是系统自带的一个非常方便的功能。如果你想让它能预览更多奇奇怪怪的文件格式，那就得给它装上一些QL插件。管理这些插件，通常就是找到它们，然后丢到正确的地方，或者用些小工具来辅助一下。

解决方案

Mac上设置文件快速预览，核心就是利用好系统内置的Quick Look功能，并通过安装第三方QL插件来扩展其支持的文件类型。

基础操作： 选中任意文件后，按下键盘上的空格键，文件内容就会以快速预览的形式展现出来。这是最基本的用法，系统已经支持大部分常见的文件格式，比如图片、PDF、纯文本、视频、音频等。
安装QL插件：
- 寻找插件： 很多优秀的QL插件都可以在GitHub上找到，或者通过Homebrew Cask来安装，后者是我个人非常推荐的方式，因为它简化了安装和管理流程。
- 手动安装： 下载到的QL插件通常是
```
.qlgenerator
```
  登录后复制
  格式的文件。你需要将这些文件放到以下两个目录中的一个：
  - ```
  ~/Library/QuickLook/
```
  登录后复制
  (只对当前用户生效)
- ```
/Library/QuickLook/
```
    登录后复制
    (对所有用户生效，需要管理员权限)
- Homebrew Cask安装： 如果你已经安装了Homebrew，直接使用
```
brew install --cask [插件名称]
```
  登录后复制
  命令即可，比如
```
brew install --cask qlcolorcode
```
  登录后复制
  。这种方式会自动处理文件放置和权限问题，非常省心。
刷新Quick Look缓存： 安装或卸载插件后，Quick Look可能不会立即识别到变化。这时，你需要打开“终端”（Terminal）应用，输入命令
```
qlmanage -r cache
```
登录后复制
并回车。这个命令会强制Quick Look重建其插件缓存，之后新安装的插件就能正常工作了。

Mac QL插件去哪里找？有哪些值得推荐的实用插件？

寻找Mac QL插件，最常用的地方无疑是GitHub和Homebrew Cask。GitHub上有很多开发者分享的开源插件，通常你搜索“QuickLook plugin”或者“QL plugin”就能找到一堆。而Homebrew Cask则是一个非常方便的包管理器，它集成了许多常用的应用和插件，安装起来非常简单，命令行一敲就行。我个人更倾向于用Homebrew，因为它能帮你管理依赖和更新，省去不少麻烦。

至于哪些插件值得推荐，我用下来觉得下面几个是真香：

QLColorCode： 对于开发者来说简直是神器。它能让Quick Look在预览代码文件时，自动进行语法高亮。你再也不用为了看几行代码就打开一个臃肿的IDE了。
QLStephen： 有时候我们会遇到一些没有文件扩展名的纯文本文件，或者一些特殊格式的日志文件。QLStephen能让Quick Look正确地预览这些文件，而不会显示乱码或者直接拒绝预览。
QuickLookJSON： 当你处理JSON数据时，这个插件能把原始的JSON字符串格式化得非常漂亮，带缩进和颜色，一目了然。
QLVideo： Mac原生Quick Look对一些视频格式的支持有限，比如MKV。QLVideo能扩展Quick Look对更多视频和音频格式的预览支持，非常实用。
WebPQuickLook： 如果你经常接触WebP格式的图片（尤其是在网页开发中），这个插件能让你直接预览WebP图片，省去了转换或者用浏览器打开的步骤。
SuspiciousPackage： 这个插件能让你直接预览
```
.pkg
```
登录后复制
安装包里的内容，看看里面到底有些什么文件，对于排查问题或者了解安装包结构很有帮助。

这些插件装上后，你会发现Mac的文件预览体验会提升好几个档次。

安装QL插件后，为什么有时不生效？如何正确刷新Quick Look缓存？

安装了QL插件，却发现它们不工作，这确实是个让人头疼的问题。我第一次遇到的时候也懵了，以为是插件坏了。其实，这通常不是插件本身的问题，而更多是Quick Look的缓存没有及时更新，或者插件放置的位置不对。

不生效的常见原因有：

缓存问题： Quick Look会维护一个插件缓存列表。当你安装新插件时，它可能没有立即更新这个列表，导致新插件无法被识别。
文件路径错误： 插件没有被放置在
```
~/Library/QuickLook/
```
登录后复制
或
```
/Library/QuickLook/
```
登录后复制
这两个标准路径下。Mac系统只会在这些特定目录中查找QL插件。
权限问题： 如果插件放在了
```
/Library/QuickLook/
```
登录后复制
目录下，但权限设置不正确，系统可能无法读取。
插件不兼容： 某些旧的QL插件可能不支持最新版本的macOS，导致无法正常加载。

解决不生效问题的关键一步就是刷新Quick Look缓存。操作很简单：

巧文书

巧文书是一款AI写标书、AI写方案的产品。通过自研的先进AI大模型，精准解析招标文件，智能生成投标内容。

查看详情

打开“终端”（Terminal）应用。
输入命令：
```
qlmanage -r cache
```
登录后复制
按下回车键执行。

这个命令会强制Quick Look清除并重建其内部的插件缓存和索引。通常，执行完这个命令后，新安装的插件就能立即生效了。

如果你想确认某个插件是否被Quick Look加载了，可以在终端输入

qlmanage -m plugins

登录后复制

。这个命令会列出所有当前Quick Look加载的插件及其路径，你可以通过它来检查你的插件是否成功被识别。

如何管理已安装的QL插件？可以禁用或卸载它们吗？

管理已安装的QL插件，其实并没有一个统一的图形界面工具，更多的是一种“手动”操作，但好在它并不复杂。你可以很方便地禁用或卸载它们。

管理插件主要通过以下几种方式：

手动删除/移动：
- 卸载： 找到你安装的
```
.qlgenerator
```
  登录后复制
  文件（它们通常在
```
~/Library/QuickLook/
```
  登录后复制
  或
```
/Library/QuickLook/
```
  登录后复制
  这两个目录下），直接将它们拖到废纸篓，然后清空废纸篓即可。
- 禁用： 如果你只是想暂时禁用某个插件，而不是彻底删除，可以把它从
```
QuickLook
```
  登录后复制
  目录移动到另一个非系统识别的文件夹里，比如你桌面上的一个“QL插件备份”文件夹。这样，Quick Look就不会加载它了。
- 完成删除或移动后，别忘了在终端执行
```
qlmanage -r cache
```
  登录后复制
  来刷新Quick Look的缓存，确保系统移除了对这些插件的引用。
通过Homebrew Cask卸载： 如果你是通过Homebrew Cask安装的插件，卸载就更简单了。直接在终端输入
```
brew uninstall --cask [插件名称]
```
登录后复制
即可，比如
```
brew uninstall --cask qlcolorcode
```
登录后复制
。Homebrew会处理好文件删除和清理工作，之后你再手动刷新一下Quick Look缓存就行。
注意事项：
- 系统内置插件： 不要随意删除或修改
```
/System/Library/QuickLook/
```
  登录后复制
  目录下的文件，这些是macOS系统自带的Quick Look组件，删除它们可能会导致系统功能异常。
- 权限： 如果你要操作
```
/Library/QuickLook/
```
  登录后复制
  目录下的文件，可能需要管理员密码。
- 定期清理： 我个人习惯是，如果某个插件用了一段时间发现不怎么用，或者它导致了某些预览问题，我就会直接把它删掉。保持插件列表的精简，也能让Quick Look更稳定。