VS Code 终端怎样固定默认 Profile

如果 VS Code 每次新建集成终端都打开了不想用的 Shell，可以直接固定默认 Terminal Profile。最短路径是：打开终端面板，点击 New Terminal 旁边的下拉箭头，选择 Terminal: Select Default Profile，再点击目标 Shell。以后新建的终端会按这个 Profile 启动。

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

VS Code 官方的终端 Profile 文档：

配置说明：https://code.visualstudio.com/docs/terminal/profiles

固定默认 Profile 只影响之后新建的终端，不会把已经打开的旧终端改成另一个 Shell。若需要固定启动参数或让设置更明确，再打开 settings.json 检查平台对应的 defaultProfile 字段。

下面的界面图是为本文生成的原创操作示意图，用来解释入口和状态关系，不代表真实 VS Code 截图，也不是本机运行证据。

先分清默认 Profile 和已有终端

Terminal Profile 可以理解为一组 Shell 启动配置，包含可执行程序、参数以及可选的环境设置。VS Code 会自动发现一部分系统 Shell，也允许你在终端 Profile 设置中补充或调整它们。

打开默认 Profile 入口

先打开 VS Code 的集成终端。可以使用菜单“查看 → 终端”，也可以直接点击窗口下方的 Terminal 面板。找到面板右上区域的 New Terminal 按钮，点击它旁边的下拉箭头，不要直接点击按钮本身。

在展开菜单中选择 Terminal: Select Default Profile。这个命令也可以从命令面板执行：按下 Command+Shift+P（Windows/Linux 通常是 Ctrl+Shift+P），输入 Terminal: Select Default Profile 并回车。

进入选择列表后，说明入口已经打开。列表里的名称是 Profile 名称，不一定等同于 Shell 的命令名；下一步要选的是已经安装、并且符合当前项目习惯的那一项。

选择需要固定的 Shell Profile

在 Profile 列表中点击要作为默认值的 Shell。例如 macOS 或 Linux 常见的是 zsh、bash，Windows 常见的是 PowerShell、Command Prompt 或 Git Bash。这里不要凭名称猜测路径，优先选择列表中已经被 VS Code 检测到的项。

1. 点击目标 Profile 名称。
2. 等待终端菜单关闭，回到 Terminal 面板。
3. 关闭当前旧终端，避免把旧 Shell 的状态误认为新设置已经生效。

选择完成后，默认值只对以后点击 New Terminal 创建的实例生效。如果目标 Profile 没有出现在列表中，先确认对应 Shell 已安装，再按下一节检查 profiles 配置；不要把一个不存在的名称直接写进 defaultProfile。

需要参数时在 settings.json 中固定

只切换默认 Shell 时，界面命令已经够用；如果还要固定启动参数、环境变量或自定义名称，可以打开命令面板，执行 Preferences: Open User Settings (JSON)。Profile 名称必须先出现在平台对应的 terminal.integrated.profiles.* 中，默认字段再引用同一个名称。

下面以 macOS 为例，JSON 保持严格格式，不在代码块中插入注释。profiles.osx 定义可选 Profile，defaultProfile.osx 指向其中一个名称；Windows 和 Linux 只需把平台后缀换成对应配置。

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

如果没有自定义参数，也可以只保留默认 Profile 字段，但它引用的名称必须是已存在的 Profile。设置保存后，关闭旧终端，再新建一个终端；不要只观察已经打开的终端标签。

新建终端确认默认值

完成界面选择或 JSON 配置后，按下面的顺序确认：

1. 关闭当前旧终端实例。
2. 点击 New Terminal 创建一个新终端。
3. 观察终端标签或终端下拉菜单中的 Profile 名称是否变成目标值。
4. 如果设置了启动参数，观察新终端是否按该参数启动。

确认时最重要的是“新建”这个动作。旧终端已经启动完成，默认 Profile 的改变不会回溯修改它。若新终端仍然使用旧 Shell，先检查当前打开的是 User、Workspace 还是 Remote 设置，并确认没有更具体作用域的配置覆盖用户设置。

默认 Profile 不生效时怎么排查

• 名称不一致：terminal.integrated.defaultProfile.* 的值必须与 terminal.integrated.profiles.* 下的键名完全一致，包括空格和括号。
• Shell 不存在：Profile 的 path 指向的可执行文件必须在当前机器上可用；路径或参数错误会导致终端启动失败。
• 看错设置作用域：用户设置、工作区设置和远程设置可能同时存在，先在设置编辑器顶部确认当前作用域。
• 没有重新创建终端：修改默认值后继续看旧终端，看到的仍然是原来的 Shell。

如果只是想临时试验另一个 Shell，可以在终端下拉菜单中单独选择它，而不立即修改默认值。确认新 Shell 的参数和启动脚本都正常后，再把它设置为默认 Profile。

常见问题

固定默认 Profile 后，已经打开的终端会切换吗？

不会。默认 Profile 只决定以后新建的终端，已经运行的终端需要手动关闭并重新创建。

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

先确认 Shell 的可执行文件确实安装并能被 VS Code 访问，再用 Terminal: Select Default Profile 的配置入口补充 Profile。自定义 Profile 可以使用 path 指向 Shell，并按需要提供 args。

任务和调试终端也一定使用这个默认值吗？

默认情况下，任务和调试功能会使用默认 Profile；如果项目需要更轻量或更兼容的 Shell，可以单独配置平台对应的 terminal.integrated.automationProfile.*，不要为了任务启动而反复切换交互式终端的默认值。

把 VS Code 终端默认 Profile 固定下来，可以记成四步：从 New Terminal 下拉菜单进入选择命令，点击目标 Shell，必要时在 settings.json 明确写入平台字段，最后关闭旧终端并新建实例确认结果。这样既能解决每次启动 Shell 不一致的问题，也能保留对启动参数和任务终端的独立控制。