VSCode 如何设置终端的默认 shell 类型 VSCode 终端默认 shell 类型的设置步骤

絕刀狂花

发布时间：2025-08-11 18:35:02

789人浏览过

来源于php中文网

原创

要设置 vscode 终端的默认 shell 类型，1. 打开设置界面（ctrl+, 或 cmd+,）；2. 搜索 terminal.integrated.defaultprofile；3. 在对应操作系统的下拉菜单中选择目标 shell（如 powershell、git bash、zsh 等）；4. 若未列出所需 shell，点击编辑 settings.json，添加 terminal.integrated.profiles. 定义其路径，并在 terminal.integrated.defaultprofile. 中指定该配置名称；5. 保存文件后重启终端即可生效。此操作可提升开发效率与环境一致性，适用于适配个人习惯、项目需求或增强功能支持，最终实现终端环境的个性化与高效化。

VSCode 如何设置终端的默认 shell 类型 VSCode 终端默认 shell 类型的设置步骤

在 VSCode 中设置终端的默认 shell 类型，核心操作是通过修改用户或工作区设置中的

terminal.integrated.defaultProfile.

属性来实现。这能让你指定 VSCode 启动新终端时，默认使用你偏好的命令行工具，比如 PowerShell、Git Bash、WSL 的某个发行版，或是 Zsh 等。

解决方案

要设置 VSCode 终端的默认 shell 类型，请按照以下步骤操作：

打开设置：
- 在 VSCode 中，按下
```
Ctrl + ,
```
  (Windows/Linux) 或
```
Cmd + ,
```
  (macOS) 打开设置界面。
- 或者，通过菜单栏选择
```
文件(File)
```
  >
```
首选项(Preferences)
```
  >
```
设置(Settings)
```
  。
搜索终端设置：
- 在设置搜索框中输入
```
terminal.integrated.defaultProfile
```
  。
选择或配置默认配置文件：
- 你会看到针对不同操作系统的设置项，例如
```
Terminal > Integrated > Default Profile: Windows
```
  、
```
Linux
```
  或
```
macOS
```
  。
- 点击你操作系统对应的下拉菜单，VSCode 通常会列出它自动检测到的常见 shell 类型，比如 PowerShell、Command Prompt、Git Bash (如果你安装了 Git)、或者你安装的 WSL 发行版等。直接选择你想要的即可。

手动配置（如果自动检测不满足需求）：

如果下拉列表中没有你想要的 shell，或者你需要更精确的控制，你可以点击该设置项旁边的“在 settings.json 中编辑”链接（一个小齿轮图标）。
这会打开你的
```
settings.json
```
文件。你需要找到或添加类似以下的代码块：

{
    "terminal.integrated.defaultProfile.windows": "PowerShell", // 或 "Git Bash", "WSL:Ubuntu" 等
    "terminal.integrated.profiles.windows": {
        "PowerShell": {
            "source": "PowerShell",
            "icon": "terminal-powershell"
        },
        "Command Prompt": {
            "path": [
                "${env:windir}\\System32\\cmd.exe"
            ],
            "args": [],
            "icon": "terminal-cmd"
        },
        "Git Bash": {
            "path": "C:\\Program Files\\Git\\bin\\bash.exe", // 确保路径正确
            "icon": "terminal-bash"
        },
        "WSL:Ubuntu": { // 假设你安装了 Ubuntu
            "path": "C:\\Windows\\System32\\wsl.exe",
            "args": [
                "-d",
                "Ubuntu"
            ],
            "icon": "terminal-linux"
        }
        // 你也可以添加自定义的 shell 配置
    },
    "terminal.integrated.defaultProfile.linux": "bash", // 或 "zsh", "fish" 等
    "terminal.integrated.profiles.linux": {
        "bash": {
            "path": "/bin/bash"
        },
        "zsh": {
            "path": "/bin/zsh"
        }
    },
    "terminal.integrated.defaultProfile.osx": "zsh", // 或 "bash"
    "terminal.integrated.profiles.osx": {
        "bash": {
            "path": "/bin/bash",
            "args": [
                "-l"
            ],
            "icon": "terminal-bash"
        },
        "zsh": {
            "path": "/bin/zsh",
            "args": [
                "-l"
            ],
            "icon": "terminal-zsh"
        }
    }
}

在
```
terminal.integrated.defaultProfile.
```
中，你需要填入你在
```
terminal.integrated.profiles.
```
中定义的某个 shell 配置的名称（即冒号前的字符串，如 "PowerShell"、"Git Bash"、"WSL:Ubuntu"）。
保存
```
settings.json
```
文件，新打开的终端就会使用你设置的默认 shell 了。

为什么需要更改 VSCode 终端的默认 Shell 类型？

说实话，VSCode 默认的终端 shell 对很多人来说已经够用。比如 Windows 上是 PowerShell 或 CMD，macOS 和 Linux 上是 Bash 或 Zsh。但“够用”和“好用”之间，总还是有些距离的。我觉得，更改默认 shell 类型，更多是出于以下几个考虑：

首先，个人习惯和偏好。如果你像我一样，习惯了在 Linux 上用 Zsh 配合 Oh My Zsh 带来的各种便利，比如命令补全、历史记录搜索、主题美化，那么在 Windows 上使用 Git Bash 或 WSL 中的 Zsh/Bash，会让你感觉更自在，命令敲起来也更顺手。这种“顺手”直接影响你的工作效率和心情。

其次，项目或工具链的特定需求。有些开发项目可能对特定的 shell 环境有隐性或显性要求。比如，一些 Node.js 或 Python 项目的脚本，可能在 Bash 环境下运行得更稳定，或者某些工具在 PowerShell 下有特定的 cmdlet 支持。如果你经常需要在不同项目间切换，或者你的团队有统一的开发环境要求，那么统一终端 shell 就很有必要了。

再者，功能和效率的提升。不同的 shell 有不同的特性集。PowerShell 在 Windows 系统管理方面有天然优势，Git Bash 提供了一套类 Unix 环境，非常适合进行 Git 操作和运行一些跨平台的脚本。WSL 更是直接把一个完整的 Linux 环境带到了 Windows 上，对于需要 Linux 开发环境的开发者来说，直接在 VSCode 终端里启动 WSL，比来回切换虚拟机方便太多了。选择一个功能更强大、更符合你工作流的 shell，能显著提升你的开发效率。

总的来说，这不仅仅是技术设置，更是一种工作流的优化和个人舒适度的提升。当你的工具能更好地适应你的习惯和需求时，那种流畅感是实实在在的。

VSCode 中常用的 Shell 类型有哪些，它们的路径通常在哪里？

在 VSCode 中，你可以配置多种不同的 shell 类型作为默认终端，这取决于你的操作系统以及你安装了哪些命令行工具。了解它们的常见路径，对于手动配置

settings.json

至关重要。

Windows 系统上常见的 Shell 类型及其路径：

PowerShell： 这是 Windows 默认的现代化命令行工具，功能强大。
- 路径： 通常无需手动指定，VSCode 会自动识别。如果需要，其主执行文件路径大致在
```
C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
```
  。
- 在
  settings.json
  中配置：
```
terminal.integrated.defaultProfile.windows": "PowerShell"
```
  (推荐使用其配置文件名)

Command Prompt (CMD)： Windows 的传统命令行工具。

路径：
```
C:\Windows\System32\cmd.exe
```
。

在
settings.json
中配置：

terminal.integrated.defaultProfile.windows": "Command Prompt"

Git Bash： 随 Git for Windows 安装，提供了一个模拟 Unix 环境的 Bash shell，非常适合 Git 操作和运行 Bash 脚本。

uBrand
一站式AI品牌创建平台，在线品牌设计，AI品牌策划，智能品牌营销；uBrand帮助创业者轻松打造个性品牌！

下载
- 路径：
```
C:\Program Files\Git\bin\bash.exe
```
  (这是默认安装路径，如果你的 Git 安装在其他位置，请相应调整)。
- 在
  settings.json
  中配置：
```
terminal.integrated.defaultProfile.windows": "Git Bash"
```

WSL (Windows Subsystem for Linux)： 允许你在 Windows 上运行一个完整的 Linux 环境，例如 Ubuntu、Debian 等。

路径：
```
C:\Windows\System32\wsl.exe
```
(这是 WSL 的启动器，你需要通过参数指定具体发行版)。

在
settings.json
中配置：

"terminal.integrated.defaultProfile.windows": "WSL:Ubuntu", // 假设你安装了 Ubuntu
"terminal.integrated.profiles.windows": {
    "WSL:Ubuntu": {
        "path": "C:\\Windows\\System32\\wsl.exe",
        "args": ["-d", "Ubuntu"], // 指定启动 Ubuntu 发行版
        "icon": "terminal-linux"
    }
}

如果你有多个 WSL 发行版，可以创建多个类似的配置。

macOS 和 Linux 系统上常见的 Shell 类型及其路径：

Bash： 许多 Linux 发行版和 macOS (macOS Catalina 之前) 的默认 shell。

路径：
```
/bin/bash
```
。

在
settings.json
中配置：

terminal.integrated.defaultProfile.linux": "bash"

或

terminal.integrated.defaultProfile.osx": "bash"

Zsh： macOS Catalina 之后的默认 shell，许多 Linux 用户也喜欢使用。

路径：
```
/bin/zsh
```
。

在
settings.json
中配置：

terminal.integrated.defaultProfile.linux": "zsh"

或

terminal.integrated.defaultProfile.osx": "zsh"

Fish： 一个用户友好的 shell，提供强大的自动补全和语法高亮功能。

路径： 通常在
```
/usr/bin/fish
```
(如果已安装)。

在
settings.json
中配置：

"terminal.integrated.defaultProfile.linux": "fish",
"terminal.integrated.profiles.linux": {
    "fish": {
        "path": "/usr/bin/fish"
    }
}

配置时，务必确保你提供的路径是正确的，并且对应的 shell 已经安装在你的系统上。VSCode 能够自动检测大部分常见的 shell，但对于一些自定义安装或不常见的 shell，手动指定路径是必要的。

设置 Shell 后遇到问题怎么办？VSCode 终端的高级配置技巧

设置完默认 shell 后，有时可能会遇到一些小问题，或者你希望对终端有更精细的控制。这部分内容会帮你解决常见问题，并介绍一些高级配置技巧。

常见问题及排查：

终端打不开或报错 "The terminal process failed to launch"：
- 检查路径是否正确： 这是最常见的问题。你可能输入了错误的 shell 执行文件路径。仔细核对
```
settings.json
```
  中
```
path
```
  字段的值，确保它指向的是实际存在的
```
.exe
```
  或可执行文件。比如，Git Bash 的路径很多人容易搞错，不是
```
git-bash.exe
```
  而是
```
bash.exe
```
  。
- Shell 是否已安装： 确保你尝试设置的 shell 已经正确安装在你的系统上。比如，你想用 Fish shell，但系统里根本没安装。
- 权限问题： 极少数情况下，可能是 VSCode 没有足够的权限启动该 shell。尝试以管理员身份运行 VSCode（Windows）。
- 重启 VSCode： 有时候，简单的重启 VSCode 就能解决一些缓存或状态问题。
设置后没有生效：
- 保存
  settings.json
  文件了吗？确保你修改后保存了文件。
- 是否修改了用户设置而不是工作区设置？ 如果你在工作区设置中覆盖了用户设置，那么用户设置的更改可能不会生效。检查
```
.vscode/settings.json
```
  文件。
- 确认
  defaultProfile
  名称是否与
  profiles
  中的定义一致：如果你手动在
```
profiles
```
  中定义了一个 shell，
```
defaultProfile
```
  的值必须是这个定义的名称，而不是实际的路径。
WSL 终端启动慢或不正确：
- 确保你的 WSL 发行版已正确安装且可以独立运行。
- 检查
```
args
```
  参数是否正确，例如
```
-d Ubuntu
```
  确保指定了正确的发行版名称。

VSCode 终端的高级配置技巧：

除了设置默认 shell，VSCode 终端还有很多实用的高级配置，能让你的开发体验更上一层楼。

定义和切换多个终端配置文件 (
```
profiles
```
)：你可以定义多个自定义的终端配置文件，方便在不同场景下快速切换。
- 在
```
settings.json
```
  中，通过
```
terminal.integrated.profiles.
```
  定义它们。
- 例如，在 Windows 上，你可能需要一个用于 Git 操作的 Git Bash，一个用于系统管理的 PowerShell，以及一个用于 Linux 开发的 WSL Ubuntu。
- 定义后，你可以通过
```
Ctrl+Shift+P
```
  (或
```
Cmd+Shift+P
```
  ) 打开命令面板，输入 "Terminal: Select Default Profile" 来临时切换默认终端，或者点击终端旁边的
```
+
```
  号旁边的下拉箭头选择要打开的终端类型。
```
"terminal.integrated.profiles.windows": {
    "MyGitBash": {
        "path": "C:\\Program Files\\Git\\bin\\bash.exe",
        "icon": "terminal-bash"
    },
    "MyPowerShell": {
        "source": "PowerShell",
        "icon": "terminal-powershell"
    },
    "MyWSLUbuntu": {
        "path": "C:\\Windows\\System32\\wsl.exe",
        "args": ["-d", "Ubuntu"],
        "icon": "terminal-linux"
    }
},
"terminal.integrated.defaultProfile.windows": "MyWSLUbuntu"
```
设置终端的起始目录 (
```
cwd
```
)：默认情况下，VSCode 终端会以当前工作区根目录作为起始目录。如果你想让新终端在特定目录启动，可以使用
```
terminal.integrated.cwd
```
。
- 例如：
```
"terminal.integrated.cwd": "${workspaceFolder}/src"
```
  会让终端在项目的
```
src
```
  目录下启动。
为终端设置环境变量 (
```
env
```
)：有时你可能需要在终端启动时就设置一些特定的环境变量，例如 PATH 变量或自定义的工具路径。
- 使用
```
terminal.integrated.env.
```
  来实现。
- 例如：
```
"terminal.integrated.env.windows": {
    "MY_CUSTOM_VAR": "hello_world",
    "PATH": "${env:PATH};C:\\MyCustomTools" // 在原有 PATH 基础上添加
}
```
  这在需要特定环境变量才能运行某些脚本或工具时非常有用。
自定义终端字体和光标样式： 虽然不是功能性的设置，但美观和舒适度也很重要。
- ```
terminal.integrated.fontFamily
```
  : 设置终端字体。
- ```
terminal.integrated.fontSize
```
  : 设置字体大小。
- ```
terminal.integrated.cursorStyle
```
  : 设置光标样式（如
```
block
```
  ,
```
line
```
  ,
```
underline
```
  ）。