Mac如何在访达里预览SVG格式文件

答案是通过安装qlsvg插件并执行qlmanage -r命令实现：先用brew install qlsvg安装（或手动下载qlsvg.qlgenerator放入~/Library/QuickLook），再运行qlmanage -r刷新服务，最后选中SVG文件按空格键即可原生预览。

在Mac访达中直接预览SVG文件，避免每次双击都跳转到浏览器或启动其他应用，是设计师和前端开发者高频使用的刚需操作。系统原生不支持SVG缩略图与快速预览，必须通过启用Quick Look插件或配置终端命令实现，否则只能看到空白图标或默认文档图标。

启用SVG Quick Look插件（推荐）

第一步：打开终端，粘贴并执行以下命令安装qlsvg插件：

brew install qlsvg

这一步依赖Homebrew。若未安装Homebrew，需先执行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"；跳过则命令会报错退出。

第二步：安装完成后，运行以下命令刷新Quick Look服务：

qlmanage -r

【必须执行此步】否则访达仍无法识别SVG缩略图，重启访达也不生效。

第三步：任意找一个SVG文件，在访达中选中→按空格键。此时应立刻显示清晰矢量预览，支持缩放、平移，且保持原始路径精度。

手动启用Quick Look支持（无Homebrew环境）

方法一：下载编译好的qlsvg release包

前往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 version="1.0" encoding="UTF-8"?>且包含合法<svg根标签；损坏或缺少XML声明的SVG无法被任何Quick Look插件渲染。

重启访达：在Dock中右键点击访达图标→“重新开启”。