Mac访达中预览SVG格式文件的操作方法

在Mac访达中直接预览SVG文件，看似简单，实际操作却常令人困扰。由于系统原生不支持，每次双击SVG文件要么跳转到浏览器，要么自动打开编辑器——这对设计师和前端开发者而言，几乎是日常工作中的小麻烦。要实现访达内的原生预览，主要有两种主流方法。

通过Quick Look插件启用SVG预览（推荐方案）

最直接的方式是通过Homebrew安装qlsvg插件。

打开终端，执行以下命令：

brew install qlsvg

注意：此操作需要预先安装Homebrew。如果尚未安装，请先执行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，否则命令将直接报错并退出。

安装完成后，最关键的一步是刷新Quick Look服务，否则所有工作都将白费：

qlmanage -r

这一步绝对不能省略。许多用户安装插件后发现仍无法预览，正是忽略了此操作。重启访达也无济于事，必须执行该命令。

验证方法非常简单：任意选择一个SVG文件，在访达中选中后按下空格键。如果操作正确，你将立即看到清晰的矢量预览，支持缩放和平移，路径精度完全保留。

手动配置Quick Look预览支持（无需Homebrew环境）

如果你不想安装Homebrew，或者环境受限制，还有两种途径可供选择。

方法一：下载预编译的qlsvg发布包

前往GitHub仓库 https://github.com/whitewhidow/qlsvg/releases ，下载最新版qlsvg.qlgenerator。解压后，将文件拖入 ~/Library/QuickLook/ 文件夹。如果该目录不存在，请手动创建。

方法二：开启系统隐藏的SVG预览功能（仅适用于macOS Sonoma及更新版本）

在终端中执行defaults write -g QLPreviewEnabledSVG -bool YES，随后执行qlmanage -r。该隐藏选项在Ventura及更早版本中无效，强制写入也不会产生任何效果。

验证方法与故障排查

打开访达，依次点击“前往”→“前往文件夹”，输入~/Library/QuickLook并回车，确认qlsvg.qlgenerator文件存在且修改日期为最新。

如果空格预览仍然失败，不要急于怀疑插件有问题——先检查SVG文件本身是否有效。使用VS Code打开文件，确认首行为，并且包含合法的根标签。那些损坏或缺少XML声明的SVG文件，任何Quick Look插件都无法呈现。