VS Code Profile导出并迁移一套开发配置的实现方法

换电脑时，最容易遗漏的不是源码，而是 VS Code 里那套已经调顺手的设置、扩展、快捷键和界面布局。把这些内容放进一个 Profile，就能先导出成 .code-profile 文件，再在目标环境的 Profiles 编辑器中导入。关键是不要把“文件已生成”当成迁移完成：导入后还要核对内容并创建 Profile。

官方地址：https://code.visualstudio.com/docs/configure/profiles

步骤一：打开 Profiles 编辑器并确认当前配置

先在源电脑打开 VS Code，点击左下角 Manage（齿轮或当前 Profile 图标）→ Profiles。也可以打开命令面板执行 Profiles: Open Profiles (UI)，但使用 Manage 菜单更容易确认当前窗口上下文。

进入后先看当前 Profile 名称，再展开 Profile Content。这里要决定迁移边界：如果目标只是复刻编辑器习惯，可以保留 Settings、Keyboard Shortcuts 和 UI State；如果还要让项目开箱即用，再勾选 Snippets、Tasks 与 Extensions。配置项越多，导入后的检查量也越大。

看到 Profile 编辑器和内容区，就完成了入口确认。不要直接复制用户目录里的零散配置文件，因为那样容易漏掉扩展和工作区关联。

步骤二：从 Profile 溢出菜单导出本地文件

在要迁移的 Profile 卡片上打开右侧溢出菜单，选择 Export...。在随后出现的导出对话框中输入清晰的 Profile 名称，目标选择本地文件系统，而不是 GitHub gist。选择本地保存后，按提示选择目录并确认文件名。

成功导出的文件扩展名应为 .code-profile。建议使用类似 go-backend.code-profile 的名字，避免把日期、电脑名混进文件名后导致后续难以判断用途。导出完成后只检查文件是否出现在预期目录，不需要手工修改文件内容。

步骤三：在新环境选择 Import Profile

把 .code-profile 文件带到目标电脑后，打开 VS Code 的 Profiles 编辑器，点击 New Profile 旁边的下拉箭头，选择 Import Profile...。在 Import Profile 对话框中选择本地文件位置并确认。

导入成功的标志不是立即出现一个新 Profile，而是打开 Profile creation form，并把文件里的内容预选出来。此时可以取消不需要的设置或扩展，也可以修改 Profile 名称；如果只想复用一套编辑器偏好，不必把源环境的全部扩展一起带走。

步骤四：核对内容后创建并验收迁移结果

在 Profile creation form 中逐项展开 Contents，重点核对 Settings、Keyboard Shortcuts、Snippets、Tasks 和 Extensions。确认后点击 Create。如果想先试用而不影响当前窗口，可以先点 Preview，在新窗口观察配置，再回到表单创建。

创建后点击新 Profile 的 Use this Profile for Current Window。验收看三处：标题栏或 Manage 按钮能识别 Profile 名称；关键扩展在 Extensions 视图中可见；Settings 和快捷键等行为与源环境一致。若打开特定工作区后 Profile 自动变化，检查 Profiles 编辑器里的 Folders & Workspaces 关联，这是按工作区生效的正常机制。

还要注意一个边界：Settings Sync 可以同步 Profile，但连接到 SSH、Dev Container 或 WSL 等远程窗口时，扩展不会按同样方式从远程窗口同步。远程开发场景应把“Profile 内容已导入”和“远程扩展已安装”拆成两个验收项。

常见问题

导出的文件为什么不是 settings.json？

Profile 是一组配置集合，官方本地导出格式是 .code-profile。settings.json 只代表设置的一部分，不能替代 Profile 导出。

导入后为什么还要点击 Create？

Import Profile 先把内容加载到创建表单，用户可以调整范围；点击 Create 才会把这套内容落成目标环境中的 Profile。

换了工作区后 Profile 变了怎么办？

Profile 可以和文件夹或工作区关联。到 Profiles 编辑器查看 Folders & Workspaces，确认当前工作区的绑定关系，再按需要切换 Profile。