工作区配置必须依附于.code-workspace文件存在;备份独立开发环境需分别处理工作区结构、文件夹级设置和Profile级配置;直接复制.vscode/settings.json无效,因其不包含多文件夹拓扑、顶层共享设置、调试/构建逻辑及扩展启用状态,且可能被Profile覆盖。

工作区配置本身不能直接“导出”,它必须依附于 .code-workspace 文件存在;想备份独立开发环境,得拆开处理三层东西:工作区结构、文件夹级设置、以及 Profile 级扩展与用户设置。
为什么直接复制 .vscode/settings.json 不行
这个文件只控制单个文件夹的行为,不包含以下关键信息:
-
.code-workspace里定义的多文件夹拓扑(folders数组)、顶层共享设置(如terminal.integrated.cwd) - 每个子项目自己
.vscode/launch.json或tasks.json的调试/构建逻辑 - 扩展启用状态(
esbenp.prettier-vscode.enable这类开关)只在 settings 中生效,但插件是否已安装、是否被推荐,不在其中 - 如果你用了 Profile,
.vscode/settings.json甚至可能被 Profile 的用户级设置覆盖——此时它根本没机会起效
.code-workspace 文件就是你的工作区“快照”
它本质是 JSON,手动保存后即具备可迁移性。但要注意几个硬约束:
- 必须通过
File → Save Workspace As…生成,不能靠“添加文件夹到工作区”后另存——后者会丢失folders字段或写成单对象而非数组 -
folders字段必须是数组,哪怕只有一个路径:"folders": [{"path": "backend"}],写成"folder"或漏掉方括号会导致整个文件静默失效 -
path值建议用相对路径(相对于.code-workspace所在目录),否则换机器后所有路径断裂 - 不要把敏感信息(如 API Key、本地服务地址
http://127.0.0.1:3000)硬编码进settings字段——这些该由 Profile 或环境变量注入
Profile 是真正能“一键备份整套环境”的机制
VSCode 的 Profiles 功能才是面向独立开发环境的完整封装,它打包了:
- 用户级
settings.json(含快捷键、UI 布局、编辑器默认行为) - 已安装的扩展列表(不是推荐列表,是真实启用状态)
- 全局键盘快捷键绑定(
keybindings.json) - 甚至包括活动的侧边栏视图状态(比如是否展开搜索、源代码管理面板是否打开)
导出方法很简单:Cmd+Shift+P → 输入 Profiles: Export Profile → 选中目标 Profile → 保存为一个 .code-profile 文件。这个文件可安全提交到私有仓库或发给同事,导入时执行 Profiles: Import Profile 即可还原全部状态。
最容易被忽略的点:环境变量和终端路径不是“配一次就完事”
你在 .vscode/settings.json 里写的 terminal.integrated.env.linux 只影响 Linux 终端,Windows/macOS 需对应字段;而 terminal.integrated.cwd 如果写在 .code-workspace 里,它决定的是整个工作区的默认终端根路径——但如果你开了多个集成终端,第二个终端不会自动继承第一个的路径,除非你显式配置 terminal.integrated.defaultLocation。更麻烦的是:这些路径变量在 Profile 导入后不会自动重载,必须手动执行 Developer: Reload Window 才生效。


















