每次重装 VS Code 或换新电脑,最头疼的是什么?不是代码,而是那些精心配置的 MCP 服务器和 Skills。重新添加、反复测试、核对配置……一上午就没了。今天分享一套完整的备份与恢复方案,让你告别重复劳动。
为什么需要备份 MCP 配置?
MCP(Model Context Protocol)服务器和 Skills 的配置,直接关系到 AI 编程助手的效率和准确性。比如你配置了数据库查询、API 调试等 MCP 服务器,或者自定义了代码审查、测试生成的 Skills,这些都是一点点积累的“数字资产”。
但 VS Code 默认不会自动备份这些配置。一旦系统崩溃、重装软件,或者换台电脑,所有配置都得从头再来。
备份的核心:理解配置文件位置
VS Code 的 MCP 配置存储在用户级别的 settings.json 文件中,具体路径因操作系统而异:
- Windows:
%APPDATA%\Code\User\settings.json - macOS:
~/Library/Application Support/Code/User/settings.json - Linux:
~/.config/Code/User/settings.json
Skills 则通常以文件夹形式存放在工作区或用户目录下。
三步完成备份
-
导出配置:打开 VS Code,按
Ctrl+Shift+P(Mac 为Cmd+Shift+P),输入“Preferences: Open User Settings (JSON)”,找到包含mcp.server和skills的配置块。 -
复制关键配置:将整个配置块复制到一个安全位置。建议同时导出为
.json文件,并备注日期和用途。 -
备份 Skills 文件夹:找到 Skills 存放目录(通常在用户目录下),压缩后存储到云盘或移动硬盘。
恢复三步走
-
安装 VS Code 并登录账号:确保使用相同版本或兼容版本,登录 Microsoft 账号以同步基础设置。
-
粘贴配置:打开
settings.json,将备份的 MCP 配置块粘贴到合适位置,保存后重启 VS Code。 -
验证连接:在 MCP 管理面板检查服务器状态,确认 Skills 是否被识别,并运行一次简单测试。
进阶:用 GitHub Gist 实现自动化备份
手动备份容易遗忘,推荐用 GitHub Gist 配合脚本自动备份。你可以写一个简单的 PowerShell 或 Bash 脚本,定期将 settings.json 上传到私有 Gist,实现“云同步”。
## 示例:使用 gh CLI 上传配置到 Gist
gist_id="your_gist_id"
cp "$HOME/.config/Code/User/settings.json" ./settings_backup.json
gh gist edit $gist_id ./settings_backup.json
这样每次改动配置后,手动跑一次脚本,或者设置定时任务,就能保证最新配置不丢失。
国内用户怎么看
国内开发者常用 VS Code 的远程开发或内网环境,备份时注意路径差异。另外,如果使用 Gist 需要网络畅通,建议备份到国内云盘或自建 Git 仓库。
总结
备份 MCP 配置和 Skills 并不复杂,关键是要养成习惯。建议每两周或每次重大配置变更后,都执行一次备份。这样,无论环境怎么变,你的 AI 助手都能“原地复活”。




