VS Code profiles 按项目隔离扩展与设置

要让不同项目使用不同的扩展和编辑器设置，最稳妥的做法是：为每类项目创建一个 VS Code Profile，再把 Profile 与具体文件夹或工作区关联。关联完成后，重新打开项目时会自动启用对应 Profile，不必每次手动开关扩展。

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

Profile 可以包含设置、扩展、快捷键、代码片段、任务、MCP 服务器和界面布局等内容。它解决的是“我在 VS Code 里采用哪套个人工具配置”；项目仓库中的 .vscode/settings.json 解决的是“这个项目要求哪些项目级设置”。两者配合使用，比把所有配置堆进默认用户设置更清楚。

准备：先列出项目需要隔离的内容

不要从默认 Profile 直接复制全部内容再慢慢删除。先把需求分成三类，创建时会更容易选择：

• 只属于技术栈：例如 Python、Java、前端框架的语言服务、格式化器和测试扩展，应放入对应 Profile。
• 所有项目都要用：例如统一快捷键或通用 Git 工具，可以保留在 Default Profile，或者对该扩展执行“Apply Extension to all Profiles”。
• 仓库必须共享：例如格式化宽度、排除目录、保存时动作，适合写进项目的工作区设置，而不是只保存在个人 Profile。

例如“商城前端”可以只加载 ESLint、Prettier 和前端调试工具；“Python API”只加载 Python、Ruff 与测试工具；“问题排查”则使用 Empty Profile，先排除扩展和自定义设置造成的问题。

创建 Profile：空白起步还是复制现有配置

打开 File > Preferences > Profiles，也可以从活动栏底部的管理菜单进入 Profiles 编辑器。选择 New Profile 后，需要先决定来源：

• Empty Profile：不带现有用户自定义，适合严格隔离、故障排查或从零搭建新技术栈。
• Copy from Existing Profile：复制现有配置的快照，适合已有一套接近目标的配置。复制后不会与来源保持继承关系。
• Profile Template：从官方模板起步，适合 Python、Java 等常见场景，但模板需要联网获取。

创建表单允许只纳入部分配置。如果你希望所有项目共用快捷键，可以在新 Profile 中不包含快捷键，让它继续使用 Default Profile 的该部分配置；扩展和设置则单独保存。创建前使用 Preview 打开预览窗口，确认扩展列表和设置范围，再点击 Create。

把 Profile 关联到当前项目

先打开目标文件夹或 .code-workspace，然后在 Profiles 编辑器中对目标 Profile 选择 Use this Profile for Current Window。VS Code 会把当前文件夹或工作区与该 Profile 关联。以后再次打开同一个项目，关联的 Profile 会自动激活；打开另一个已有绑定的项目时，也会自动切换。

当前 Profile 可以从三个位置核对：窗口标题栏、活动栏管理按钮的悬停文字，以及 Profiles 编辑器。如果使用的是 Default Profile，标题栏可能不显示 Profile 名称，因此不要只靠“看不到名称”判断关联失败。

如果习惯从终端启动项目，也可以显式指定 Profile。目标 Profile 不存在时，VS Code 会以该名称创建一个空 Profile。

# 用 Web Frontend Profile 打开商城前端目录
code "/projects/shop-web" --profile "Web Frontend"

# 用 Python Backend Profile 打开 API 项目
code "/projects/order-api" --profile "Python Backend"

扩展隔离：安装前先看当前 Profile

Profile 激活后，在扩展视图中安装、卸载或禁用扩展，这些变化会记录到当前 Profile。于是前端项目不会因为 Python 分析器而增加启动负担，后端项目也不会自动装入大量浏览器调试工具。

有两类操作容易破坏隔离：

• 对扩展执行 Apply Extension to all Profiles 后，它会出现在所有 Profile 中。这适合真正通用的扩展，不适合语言栈专属工具。
• Settings Sync 开启后，可以同步 Profiles 及其所选数据，但远程 SSH、Dev Container 和 WSL 窗口不会与本地窗口互相同步扩展。远程侧仍要按对应环境管理扩展。

如果项目只想向团队“推荐”扩展，而不是强制个人 Profile 安装，可以把扩展 ID 放入仓库的 .vscode/extensions.json 推荐列表。推荐清单与 Profile 隔离不是同一层：前者属于项目协作提示，后者决定当前用户实际启用的配置集合。

设置边界：Profile 设置与 Workspace 设置怎么配合

切换 Profile 时，VS Code 会应用该 Profile 的用户设置。项目工作区设置位于项目根目录的 .vscode 文件夹，并覆盖相应的用户设置。因此，一个实用分工是：

如果某个设置应该在所有 Profile 中一致，可以在 Settings 编辑器中执行 Apply Setting to all Profiles。之后从任一 Profile 修改该设置，其他 Profile 也会同步更新；取消该操作后才能恢复独立值。

导出、预览与导入 Profile

准备共享时，在 Profiles 编辑器中打开目标 Profile 的更多操作，选择 Export。导出可以保存到 GitHub gist，也可以保存为本地 .code-profile 文件。团队内部通过代码仓库、网盘或工单传递时，本地文件更便于版本留档。

导出前只勾选确实要共享的内容。机器相关设置，例如指向个人电脑绝对路径的配置，不会被导出；这不是丢失，而是为了避免把不可移植配置带到另一台机器。

接收方在 New Profile 的下拉操作中选择 Import Profile，提供 gist URL 或本地文件。导入后会先打开 Profile 创建表单，可以检查设置、扩展、代码片段和任务，取消不需要的内容，再选择 Create。这一步是“基于导入内容创建新 Profile”，不会覆盖发送方，也不会与原文件建立持续继承关系。

提交前核对：确认隔离真的生效

1. 打开项目后，从标题栏或管理按钮确认当前 Profile 名称。
2. 打开 Profiles 编辑器，在 Folders & Workspaces 区域确认项目关联。
3. 进入扩展视图，确认技术栈专属扩展只在目标 Profile 中启用。
4. 在 Settings 中搜索 @modified，检查修改发生在 Profile 用户设置还是 Workspace 设置。
5. 关闭窗口并重新打开同一项目，确认 VS Code 能自动恢复关联。
6. 使用 Empty Profile 重现一次问题，判断故障来自扩展、个人设置还是 VS Code 核心。

异常处理：关联错了或配置互相串了

项目打开后 Profile 不对：在目标窗口重新选择正确 Profile；如果想清除所有本地文件夹关联，运行命令 Developer: Reset Workspace Profiles Associations。该命令只把关联恢复为 Default Profile，不会删除已有 Profile。

多个 Profile 仍出现同一扩展：检查该扩展是否被设置为应用到所有 Profiles；取消后，再分别确认各 Profile 的启用状态。

复制后修改没有同步：这是正常行为。VS Code 当前不提供 Profile 之间的动态继承；从现有 Profile 创建时得到的是副本。真正需要全局一致的设置或扩展，应使用“Apply ... to all Profiles”。

导入后缺少本地路径：机器相关设置不会随 Profile 导出。将团队通用设置放进 Workspace，将个人路径在本机重新配置。

结论

按项目隔离的关键不是“建很多 Profile”，而是把三层职责分开：Profile 保存个人技术栈工具，Workspace 保存项目规则，文件夹或工作区关联负责自动切换。创建时从 Empty Profile 或受控副本起步，关联项目后再安装扩展，最后用导出预览和重新打开项目完成核对，就能避免默认配置越积越乱。

参考资料：VS Code 官方 Profiles、Settings、Settings Sync 与 Extensions 文档。