VS Code 怎样为终端选择默认 Shell Profile

在 VS Code 里固定项目使用的 Shell，最直接的入口是终端面板右上角新建终端按钮旁的下拉菜单，选择 Select Default Profile，再点选目标 Shell。选择只改变后续新建的集成终端，已经打开的旧终端不会被原地转换，所以最后一定要重新创建一个终端确认。

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

第1步：从新建终端入口打开 Profile 列表

先打开 VS Code 的 Terminal 面板。点击面板右上角的 New Terminal 下拉箭头，在菜单底部选择 Select Default Profile。也可以按 ⌘⇧P（macOS）或 Ctrl+Shift+P（Windows、Linux）打开命令面板，再输入 Terminal: Select Default Profile。

这一步不要把 Terminal: Create New Terminal 和选择默认 Profile 混在一起：前者只负责创建实例，后者才决定今后创建实例时使用哪个 Shell。

第2步：选择项目需要的 Shell Profile

在列表中选择目标项，例如 zsh、bash、PowerShell 或 Git Bash。VS Code 会优先展示自动检测到的标准 Shell。macOS 和 Linux 通常从 $SHELL 推断默认 Shell，Windows 常见默认项是 PowerShell。

如果项目依赖登录脚本、特定别名或环境变量，优先选择与项目脚本一致的 Shell。不要只看名称判断成功，Windows 上的 PowerShell、PowerShell 7 和 Git Bash 的命令语法与启动文件都不同。

第3步：新建终端确认 Profile 已切换

选择完成后，关闭旧终端，再点击 New Terminal 创建新实例。查看终端标签、提示符和当前目录，确认它们符合目标 Shell。旧终端仍保持原来的进程，这是正常行为；如果只在旧标签里观察，容易误以为选择没有生效。

可以用下面的设置结构理解 VS Code 保存的关系。它是配置示例，不是必须手写的步骤；其中 terminal.integrated.defaultProfile.* 的值必须和 Profile 名称完全一致：

{
  "terminal.integrated.profiles.linux": {
    "zsh (login)": {
      "path": "zsh",
      "args": ["-l"]
    }
  },
  "terminal.integrated.defaultProfile.linux": "zsh (login)"
}

这里的 path 指向 Shell 可执行文件，args 传递启动参数；最后一项只是选择已定义的 Profile。若名称拼写不一致，列表里可能看得到配置，但新终端仍不会按预期启动。

第4步：列表没有目标 Shell 时检查配置范围

再次执行 Terminal: Select Default Profile，点击列表中的配置入口或 Configure Terminal Settings，确认当前打开的是正确的 Settings scope。用户设置、工作区设置和远程窗口设置可能不是同一份配置。

需要自定义 Profile 时，VS Code 官方支持用 path 或 Windows 下的 source 定义它。比如自定义启动参数时，重点检查三件事：可执行文件是否存在、参数是否属于该 Shell、默认 Profile 的名称是否与定义一致。Windows 上检测到不安全路径的 Shell 时，VS Code 还可能先显示警告，需要明确配置后才出现在可用列表中。

第5步：不要把默认终端和任务终端混为一谈

日常终端默认项使用 terminal.integrated.defaultProfile.。如果只想让 Tasks 或 Debug 使用轻量的 POSIX Shell，可以单独设置 terminal.integrated.automationProfile.，这样不会改变手动打开的终端。

例如，默认终端可以保留 zsh，而自动化任务使用 /bin/sh。这能避免任务脚本误加载复杂的交互式启动文件，也能保留日常开发需要的别名。修改后分别新建手动终端、运行一个任务，按使用场景检查结果。

常见问题：为什么选择后旧终端没变化

选择 Profile 后需要重启 VS Code 吗？

通常不需要。关闭旧终端并重新点击 New Terminal 即可验证；旧终端进程不会被默认设置强制替换。

为什么列表里没有安装的 Shell？

先检查 Shell 可执行文件和当前 Settings scope，再通过 Configure Terminal Settings 创建带有正确 path 的自定义 Profile。远程窗口还要确认 Shell 实际安装在远端环境。

任务运行时为什么没有使用刚选的 Shell？

Tasks 和 Debug 可以使用 terminal.integrated.automationProfile.。若该项已设置，它可能有意覆盖日常终端的默认 Profile。

完成这项配置后，验收标准很简单：新建终端的 Shell 与项目约定一致，旧终端仍按原进程运行，Tasks/Debug 若有独立需求则有单独的 automation Profile。