VS Code 创建项目专用 Profile 并只同步需要的配置

项目专用 Profile 的核心做法是：新建 Profile 时只把“设置、扩展”等确实需要隔离的配置纳入该 Profile，其余类别继续使用 Default Profile；随后在 Settings Sync 中只启用 Profiles 以及要跨设备同步的数据类别。这样既能让项目自动切换到自己的开发环境，也不会把所有快捷键、任务和无关扩展一起带走。

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

本文以一个前端项目为例：它需要 ESLint、Prettier 和项目专用格式化设置，但不想改变日常 Go 项目的扩展与布局。菜单名称以英文界面为主，中文界面位置一致，个别文字会随版本和语言包略有差异。

开始前先决定哪些内容要独立

VS Code Profile 可以包含 Settings、Keyboard Shortcuts、MCP Servers、Snippets、Tasks、Extensions 和界面布局等内容。创建时没有纳入的配置类别会继续使用 Default Profile，因此“只同步需要的配置”要分两层理解：

• Profile 内容层：只让这个 Profile 独立保存设置和扩展，其他类别沿用默认配置。
• Settings Sync 层：只同步 Profiles、Settings、Extensions 等选定数据类别。
• 单项排除层：对个别设置或扩展使用排除同步操作，避免本机路径或机器专用工具跨设备传播。

建议先列出项目真正需要的扩展和设置。不要直接复制完整默认环境，否则新 Profile 很快又会变成第二个杂乱的 Default Profile。

步骤一：创建只包含必要内容的 Profile

路径：File → Preferences → Profiles；也可以点击 Activity Bar 底部的 Manage 齿轮，再打开 Profiles。进入 Profiles 编辑器后，选择 New Profile。

在 New Profile 表单中填写名称，例如“Web Project”，选择一个容易识别的图标。来源可以选 Empty Profile，也可以从 Default Profile 或模板复制。为了减少污染，本例选择 Empty Profile，然后在 Contents 中只启用 Settings 与 Extensions。Keyboard Shortcuts、Snippets、Tasks 和 MCP Servers 暂不纳入，继续使用默认配置。

可见状态：Contents 区域只保留 Settings 和 Extensions 为选中状态，Profile 名称和图标已经填写。此时先不要急着创建，继续点击各内容旁的 Open 检查预览。

步骤二：预览、创建并绑定当前项目

路径：New Profile → Preview → Create。点击 Preview 后，VS Code 会打开一个应用该 Profile 的新窗口。确认扩展列表简洁、主题与设置符合预期，再回到创建表单点击 Create。

创建或选择 Profile 时，它会和当前文件夹或工作区建立关联。以后再次打开这个项目，VS Code 会自动激活对应 Profile。你可以从窗口标题栏、Manage 按钮的图标或字母徽标，以及 Profiles 编辑器中的 Current 标记确认当前状态。

可见状态：当前窗口显示“Web Project”标识，Profiles 编辑器的 Folders & Workspaces 区域能看到当前文件夹。若仍显示 Default Profile，应选择 Use this Profile for Current Window 后再确认。

步骤三：只在专用 Profile 中配置扩展与设置

确认 Web Project 已激活后，打开 Extensions 视图，安装 ESLint、Prettier 等当前项目需要的扩展。再打开 Settings，调整格式化、保存行为和编辑器布局。此时发生的安装、禁用和设置修改会记录在当前 Profile 中。

如果某个扩展或设置希望所有 Profile 共用，可在对应操作菜单中选择 Apply Extension to all Profiles 或 Apply Setting to all Profiles。这和“复制另一个 Profile 后持续继承”不同：VS Code 可以在创建时复制内容，但不会维护父子 Profile 的动态继承链。

可见状态：切换回 Default Profile 后，项目专用扩展不应自动出现在默认环境；重新切回 Web Project，它们应恢复为启用状态。这个来回切换是最直观的隔离检查。

步骤四：在 Settings Sync 中只选择需要的类别

首次开启路径：Manage → Backup and Sync Settings...。选择要同步的数据类别，然后使用 Microsoft 或 GitHub 账号登录。若已经开启同步，则运行命令 Settings Sync: Configure...，或者从 Manage → Settings Sync is On → Settings Sync: Configure... 进入。

本例只勾选 Profiles、Settings 与 Extensions。如果不需要跨设备同步快捷键、用户级 Tasks、Snippets、MCP Servers、UI State、Prompts and Instructions，就保持它们关闭。Profiles 打开后，选中数据类别对应的 Profile 内容会在同步设备上可用；官方文档说明最多可同步 20 个 Profile。

可见状态：配置选择器里只有三个类别处于选中状态，登录后 Manage 菜单显示 Settings Sync is On。若首次合并发生冲突，应使用冲突编辑器比较 Local 与 Remote，再决定保留哪一侧。

步骤五：排除机器专用设置和扩展

数据类别启用后，仍可以排除单项。设置可从 Settings 编辑器的操作菜单排除，或写入 settingsSync.ignoredSettings；扩展可从 Extensions 视图的操作菜单排除，或写入 settingsSync.ignoredExtensions。

适合排除的内容包括仅在一台机器存在的工具路径、公司内网扩展、操作系统专用辅助扩展，以及不应带到个人设备的本地工作配置。不要把密码、Token 或私密路径写进 Profile 或同步设置。

可见状态：被排除项目显示不同的同步状态，Settings Sync 仍保持开启。完成后可运行 Settings Sync: Show Synced Data 查看远端备份和同步记录。

在另一台设备完成最终确认

1. 使用同一 Microsoft 或 GitHub 账号开启 Settings Sync，并确认 Profiles、Settings、Extensions 已启用。
2. 打开 Profiles 编辑器，检查 Web Project 是否出现。
3. 打开对应项目文件夹，选择 Web Project，并确认当前窗口显示 Profile 标识。
4. 检查项目扩展与设置是否到位，机器专用排除项是否没有同步。
5. 若使用 SSH、Dev Container 或 WSL 远程窗口，注意 VS Code 不会把扩展同步到或从远程窗口同步；需要在对应远程环境单独管理扩展。

常见问题

Profile 和 Workspace Settings 有什么区别？

Profile 管理一组用户级自定义，包括设置、扩展和界面布局，并可关联多个文件夹；Workspace Settings 保存在工作区中，只在该工作区生效。团队共享项目设置适合 Workspace Settings，个人工具组合更适合 Profile。

为什么创建 Profile 后快捷键也变了？

检查创建表单是否把 Keyboard Shortcuts 纳入了 Profile。如果不希望独立维护快捷键，重新编辑 Profile 内容或创建一个只包含 Settings 与 Extensions 的新 Profile。

能否只同步某一个 Profile？

Settings Sync 的 Profiles 类别用于同步 Profile 及所选数据类别。更实用的控制方式是先精简每个 Profile 的内容，再关闭不需要的数据类别，并对单项设置或扩展做排除。

如何解除项目与 Profile 的关联？

把当前项目切回 Default Profile 即可。若要清除所有本地文件夹关联，可运行 Developer: Reset Workspace Profiles Associations；它不会删除已有 Profile。

完成以上设置后，项目环境、跨设备同步和机器专用排除就形成了清晰边界：项目打开时自动切换，必要配置随账号同步，本地差异不会被无意带到其他设备。