VS Code 怎样为工作区设置默认终端配置文件

如果每个项目都要使用不同的 shell，最稳妥的做法是把终端 profile 和默认 profile 写进当前工作区，而不是改全局用户设置。打开项目后，在终端面板的下拉菜单中选择 Select Default Profile，再把对应的配置保存到项目的 .vscode/settings.json；以后这个工作区新建的集成终端就会优先使用该 profile。

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

官方文档：https://code.visualstudio.com/docs/terminal/profiles

关键是分清两个动作：profile 定义“用什么 shell、带哪些参数”，defaultProfile 指定“新终端默认选哪个已定义的 profile”。已有终端不会因为保存设置而自动切换。

先确认配置写在哪个工作区

先打开目标项目文件夹，再执行命令面板中的 Preferences: Open Workspace Settings (JSON)。单文件夹工作区通常会打开项目根目录下的 .vscode/settings.json；多根工作区则可能把工作区设置写在 .code-workspace 文件中。

不要误选 Preferences: Open User Settings (JSON)。User 设置会影响所有 VS Code 实例，Workspace 设置只在当前项目打开时生效，并且会覆盖同名的 User 设置。涉及可执行文件路径时，建议只给可信项目启用工作区配置，并确认右下角没有处于受限信任状态。

通过终端下拉菜单选择默认 profile

在底部打开 TERMINAL 面板，点击新建终端按钮旁边的下拉箭头，选择 Select Default Profile。从列表中选择已经检测到的 shell；如果需要自定义参数，可在目标 profile 右侧进入配置入口，再回到 settings.json 微调。

这一步的验收点是菜单中出现目标 profile，并且它被设置为默认选择。这里只决定“新终端选什么”，不会改变已经打开的终端进程。

把 profile 和默认值保存到工作区

如果项目需要让团队成员共享同一套终端入口，可以在工作区的 settings.json 中写入下面的最小配置。示例使用 macOS/Linux 风格的 zsh；Windows 项目应把键名改成 windows，并使用适合本机的 path 或 Windows 可检测的 source。

{
  "terminal.integrated.profiles.osx": {
    "Project Zsh": {
      "path": "/bin/zsh",
      "args": ["-l"]
    }
  },
  "terminal.integrated.defaultProfile.osx": "Project Zsh"
}

这段严格 JSON 没有加入注释：terminal.integrated.profiles.osx 定义 profile，path 指向 shell，args 让 zsh 以登录 shell 启动；terminal.integrated.defaultProfile.osx 的值必须与 profile 名称完全一致。官方 profile 文档也支持使用变量、env、icon 和 color 等可选字段，但不要把与本项目无关的个人路径提交进去。

新建终端，按三个位置核对是否生效

1. 看终端标签：关闭或保留旧终端都可以，再新建一个终端，标签应显示配置后的 profile 名称或对应 shell。
2. 看设置作用域：在 Settings 搜索框输入 @modified terminal.integrated，确认配置出现在 Workspace，而不是 User。
3. 看项目文件：重新打开项目，确认 .vscode/settings.json 或工作区文件仍包含 profile 定义和默认值。

如果任务或调试器仍使用另一套 shell，不要马上认定默认 profile 失效。VS Code 允许通过 terminal.integrated.automationProfile. 为任务和调试单独指定 profile，它与普通新建终端的默认值可以不同。

没有生效时先查这四项

• 平台键名：macOS 使用 osx，Linux 使用 linux，Windows 使用 windows；键名写错时配置不会落到当前平台。
• 名称是否一致：defaultProfile 的值必须与 profile 对象名完全相同，大小写和空格都不能错。
• 文件是否在正确范围：项目设置应位于当前工作区，旧窗口或另一个根目录中的 settings.json 不会影响当前窗口。
• 可执行文件是否存在：path 和 args 只描述启动方式；如果 shell 路径不存在，先修正路径，再重新新建终端。

需要回退时，删除工作区中的这两个键，或者在设置编辑器中对对应项执行 Reset Setting，然后重新打开一个终端确认回到系统默认 profile。

常见问题

只选择 profile，不写 settings.json 可以吗？可以。选择命令会改变当前配置，但如果希望项目在其他机器上复用，应把必要的 profile 定义和默认值保存到工作区设置中。

为什么旧终端没有切换？默认 profile 只影响新建实例。旧终端已经启动了进程，关闭后重新创建才能看到新的 shell。

为什么任务终端和普通终端不一样？任务和调试可以使用 automation profile。先分别检查普通默认 profile 与 automation profile，避免把两个入口混为一谈。

总结一下：在当前工作区打开终端下拉菜单选择 profile，用 terminal.integrated.profiles. 定义它，再用 terminal.integrated.defaultProfile. 指定默认项，最后通过新建终端、Workspace 作用域和项目设置文件三处确认结果。