Clash Verge 配置文件位置:Windows、macOS、Linux 怎么找
简答:Clash Verge Rev 的配置通常在应用数据目录:Windows 和 macOS 可直接进入官方列出的目录,Linux 要区分 verge.yaml 与 profiles 所在位置。最稳妥的判断标准是以当前版本实际生成的文件和目录为准。
定义:Clash Verge 配置文件位置,是指客户端保存主配置、订阅配置、运行配置和应用状态文件的应用数据目录,而不是安装程序所在目录。
先试这一步:按系统打开 Clash Verge Rev 的配置目录
本文是第三方使用指南,不代表任何客户端项目的官方页面。若你使用的是 Clash Verge Rev,先不要在安装目录里盲目搜索。官方文档把 Windows、macOS、Linux 的应用数据拆成配置文件、工作目录、订阅目录和缓存目录;其中真正需要备份的通常是主配置与 profiles,而不是 WebView 缓存。
| 系统 | 主配置文件 verge.yaml | 订阅配置目录 profiles | 应用工作目录 |
|---|---|---|---|
| Windows | %APPDATA%\io.github.clash-verge-rev.clash-verge-rev\verge.yaml | %APPDATA%\io.github.clash-verge-rev.clash-verge-rev\profiles\ | %APPDATA%\io.github.clash-verge-rev.clash-verge-rev\ |
| macOS | ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev/verge.yaml | ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev/profiles/ | ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev/ |
| Linux | ~/.config/io.github.clash-verge-rev.clash-verge-rev/verge.yaml | ~/.local/share/io.github.clash-verge-rev.clash-verge-rev/profiles/ | ~/.local/share/io.github.clash-verge-rev.clash-verge-rev/ |
以上路径来自 Clash Verge Rev Docs 的相关文件及目录说明。如果当前版本的界面提供“打开配置目录”或类似入口,优先以该入口显示的实际路径为准;如果没有,就按下面的系统步骤查找。
Windows:从 %APPDATA% 进入,而不是先看安装目录
- 按
Win + R打开“运行”。 - 输入
%APPDATA%并确认。 - 进入
io.github.clash-verge-rev.clash-verge-rev文件夹。 - 需要找主设置时查看
verge.yaml;需要找订阅或本地配置时进入profiles文件夹。
也可以在 PowerShell 中验证目录是否存在:
$base = Join-Path $env:APPDATA 'io.github.clash-verge-rev.clash-verge-rev'
Test-Path $base
Get-ChildItem -Force $base官方项目源码把 verge.yaml 定义为应用主配置,把 config.yaml 定义为 Clash 配置,并把 profiles.yaml 定义为 profiles 索引;订阅文件本身则由 profiles 目录保存。相关字段和路径可对照 官方源码中的目录定义。
如果你看到的是旧版目录,例如 %APPDATA%\clash-verge,不要直接把它当作当前 Rev 目录。它可能是旧版 Clash Verge 的残留,也可能来自便携版或其他安装方式。先确认文件夹里是否同时存在 verge.yaml、profiles.yaml 和 profiles,再决定是否迁移。
macOS:显示隐藏的 Library,再进入 Application Support
- 在 Finder 中打开“前往”菜单,按住
Option后选择“资源库”。 - 进入
Application Support。 - 打开
io.github.clash-verge-rev.clash-verge-rev。 - 主配置查看
verge.yaml,订阅配置进入profiles。
也可以在“终端”中只读查看:
base="$HOME/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev"
ls -la "$base"
ls -la "$base/profiles"macOS 的缓存目录位于 ~/Library/Caches/ 下,官方文档将它与应用数据目录分开列出。找不到配置时,优先查 Application Support,不要把 Caches 当作备份来源。目录和文件用途以 官方目录说明 为准。
Linux:不要把 .config、.local/share 和内核目录混为一谈
Linux 是最容易被旧教程混淆的平台。官方卸载文档将 verge.yaml 列在 ~/.config/io.github.clash-verge-rev.clash-verge-rev/,但把应用工作目录和 profiles 列在 ~/.local/share/io.github.clash-verge-rev.clash-verge-rev/。因此,查找主配置和查找订阅文件要分开进行。
- 先检查主配置:
~/.config/io.github.clash-verge-rev.clash-verge-rev/verge.yaml。 - 再检查工作目录:
~/.local/share/io.github.clash-verge-rev.clash-verge-rev/。 - 最后进入工作目录下的
profiles,查找订阅配置文件。
config_dir="$HOME/.config/io.github.clash-verge-rev.clash-verge-rev"
data_dir="$HOME/.local/share/io.github.clash-verge-rev.clash-verge-rev"
ls -la "$config_dir"
ls -la "$data_dir"
ls -la "$data_dir/profiles"官方隐私说明又以更高层次的方式表示,Linux 应用数据位于 $XDG_DATA_HOME/io.github.clash-verge-rev.clash-verge-rev,通常对应 ~/.local/share/。这两份资料并非在回答同一个层级:卸载文档按文件类型列出 verge.yaml 的配置目录,隐私说明概括应用数据的主要存储位置。需要找哪个文件,就按文件名和用途查找,不要用“所有文件都在同一目录”来推断。
如果你使用的是便携版、开发版或曾安装过旧版,实际目录可能不同。官方源码还区分了普通应用标识与开发版应用标识,因此出现多个相似文件夹时,应以当前运行版本实际生成的文件为准。
这些文件分别是什么:改哪个才可能生效?
| 文件或目录 | 用途 | 适合怎么处理 |
|---|---|---|
verge.yaml | Clash Verge Rev 的应用主配置,例如界面、内核选择和部分客户端设置。 | 修改前先退出客户端并备份;不确定字段时不要直接删除。 |
config.yaml | 项目源码定义的 Clash 配置文件名,具体内容取决于当前版本和配置流程。 | 先确认它是否是当前配置来源,不要只凭文件名判断。 |
profiles.yaml | 记录 profiles 的索引、当前项以及相关配置关系。 | 迁移 profiles 时通常要与 profiles 目录一起保存。 |
profiles/ | 保存远程订阅或本地配置文件。 | 备份订阅配置时优先复制整个目录。 |
clash-verge.yaml 或同类运行文件 | 可能是当前 profile、Merge 或脚本处理后生成的运行配置,不一定是长期保存源。 | 用于排查“当前实际运行了什么”,不要把它误当作唯一备份文件。 |
logs/ | 应用日志目录。 | 排查连接问题时按需保留,分享前检查敏感信息。 |
官方源码明确列出 config.yaml、verge.yaml 和 profiles.yaml 的文件名,并将 profiles 文件写入应用 profiles 目录;verge.yaml 的字段结构可参考 官方 verge 配置源码。如果你改了文件但重启后又恢复,优先检查当前 profile、Merge 或脚本是否会重新生成运行配置。
找不到目录时:按这份顺序排查
- 先确认客户端类型。旧版 Clash Verge、Clash Verge Rev、便携版和开发版可能使用不同的应用标识或目录结构。
- 确认客户端至少成功启动过一次。没有生成过应用数据时,按路径搜索自然找不到文件。
- 搜索应用标识。Windows 搜索
io.github.clash-verge-rev,macOS 或 Linux 可在对应用户目录中搜索同名关键字。 - 搜索文件名。优先查找
verge.yaml、profiles.yaml和config.yaml,再判断它们是否位于同一个应用数据根目录。 - 检查是否有多个用户账户。不同系统账户的
AppData、Library或 Home 目录彼此独立。 - 检查便携版或开发版。如果程序是从其他目录直接运行,或目录名带有开发版标识,不要强行套用普通安装版路径。
官方隐私说明给出了 Windows、macOS 和 Linux 的应用数据根目录,适合用来确认当前版本的大范围位置;官方目录说明则适合进一步区分缓存、主配置、工作目录和 profiles。
备份与迁移:不要只复制一个 YAML 文件
- 完全退出 Clash Verge Rev,确认托盘区也没有继续运行。
- 复制应用数据根目录,至少保留
verge.yaml、profiles.yaml、profiles/,以及你实际使用的 Merge、脚本和规则文件。 - 如果需要迁移到另一台电脑,同时记录订阅来源和当前使用的 profile;不要只复制运行时生成文件。
- 迁移后先启动客户端,再检查当前 profile、规则、DNS、TUN 和系统代理状态。
- 如果出现配置不生效,先恢复备份,再逐项导入,而不是一次覆盖全部目录。
订阅 URL 可能包含 Token,配置文件也可能包含节点地址、密码、UUID、代理凭据或日志信息。上传截图、发送压缩包或提交排障信息前,应先删除或打码这些内容。若配置中出现无法确认的字段,保留原文件并以当前版本文档或客户端界面为准。
一句话判断:你应该找哪个位置?
只想修改客户端自身设置,先找 verge.yaml;想备份订阅和本地配置,找 profiles.yaml 与 profiles/;想确认当前实际运行内容,再查看生成的运行配置。Windows 和 macOS 主要围绕应用支持目录查找,Linux 则要同时检查 ~/.config 与 ~/.local/share。
如果你下一步是处理订阅导入、规则直连或客户端连接异常,建议先保留原配置副本,再进行单项修改,避免把“路径问题”和“网络问题”混在一起。
常见问题
Clash Verge 的配置文件通常在哪里?
Clash Verge Rev 通常保存在应用数据目录。Windows 是 %APPDATA%\io.github.clash-verge-rev.clash-verge-rev,macOS 是 ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev,Linux 需要分别检查 ~/.config 和 ~/.local/share。
verge.yaml 和 profiles.yaml 有什么区别?
verge.yaml 主要是客户端自身的应用配置;profiles.yaml 用于记录 profiles 索引和当前配置关系。订阅或本地配置文件通常还要查看 profiles 目录,不能只备份其中一个文件。
为什么我找不到 Clash Verge Rev 的配置目录?
常见原因包括客户端没有成功启动过、使用了旧版 Clash Verge、便携版或开发版、系统账户不同,或者你只搜索了安装目录。请按应用标识和 verge.yaml、profiles.yaml 文件名搜索。
Linux 上应该查 ~/.config 还是 ~/.local/share?
两处都要查。官方目录说明将 verge.yaml 列在 ~/.config 下,将工作目录和 profiles 列在 ~/.local/share 下;官方隐私说明则用 XDG 数据目录概括应用数据位置。查找时按文件名和用途判断。
备份 Clash Verge 配置时只复制 config.yaml 可以吗?
不建议只复制一个文件。至少同时检查 verge.yaml、profiles.yaml、profiles 目录,以及实际使用的 Merge、脚本和规则文件;订阅 URL、密码、UUID 和日志可能含敏感信息,分享前要脱敏。
相关阅读
参考资料
- Clash Verge Rev Docs:卸载软件与相关文件及目录(clashverge.dev)
- Clash Verge Rev 官方源码:目录与文件名定义
- Clash Verge Rev 官方源码:verge.yaml 配置结构
- Clash Verge Rev 官方隐私说明:各平台应用数据目录
- 旧版 Clash Verge 官方 Wiki:便携版与旧配置目录说明