vscode 终端支持多 shell 的关键是配置 terminal.integrated.profiles.* 和 defaultprofile.*，需按系统平台在 settings.json 中手动添加绝对路径的 profile，确认路径有效、键名不冲突，并重启 vscode；项目级可使用工作区设置覆盖环境变量或启动脚本。
vscode 的终端集成默认只启用系统默认 shell，要支持多种 shell（比如 zsh、fish、pwsh 或特定虚拟环境下的 bash），关键不在“安装插件”，而在正确配置 terminal.integrated.profiles.* 和 terminal.integrated.defaultprofile.* 两项设置。
如何添加自定义 Shell 配置（Windows/macOS/Linux 通用）
VSCode 不会自动发现所有已安装的 Shell，必须手动声明可选 profile。打开设置（Ctrl+, 或 Cmd+, ），切到「JSON」视图（右上角 `{}` 图标），编辑 settings.json：
- Windows 用户常见需求：添加
pwsh（PowerShell Core）或 Git Bash："terminal.integrated.profiles.windows": { "PowerShell": { "source": "PowerShell" }, "Git Bash": { "path": "C:\Program Files\Git\bin\bash.exe" } } - macOS 用户若用
zsh但系统未将其设为默认（如仍为bash），需显式添加："terminal.integrated.profiles.osx": { "zsh": { "path": "/bin/zsh" } } - Linux 用户若装了
fish，路径通常是/usr/bin/fish，注意确认存在："terminal.integrated.profiles.linux": { "fish": { "path": "/usr/bin/fish" } }
⚠️ 注意：path 必须是可执行文件的**绝对路径**；用 which fish 或 Get-Command pwsh 确认；Windows 上路径反斜杠要双写或改用正斜杠。
为什么新 Shell 在下拉菜单里不出现？
即使加了 profile，也不一定立刻显示——VSCode 会根据当前平台过滤 profiles 字段（.windows 只在 Windows 生效），且要求键名（如 "zsh"）和 path 指向的程序能被正常调用。
- 检查拼写：字段名必须是
terminal.integrated.profiles.windows，不是profile或profilesWin - 验证路径有效性：在系统终端中直接运行该路径，看是否启动对应 Shell（例如
/usr/bin/fish --version） - 重启 VSCode：修改
settings.json后需完全退出再重开，热重载不刷新终端 profile 列表 - 避免重复键名：如果
"zsh"已存在于默认 profile 中，自定义同名项会被忽略（VSCode 优先用内置）
怎样为项目级终端指定 Shell 或环境变量？
全局设置无法区分项目，但可通过工作区设置（.vscode/settings.json）覆盖终端行为，尤其适合 Python 虚拟环境或 Node.js 特定版本场景：
- 让终端自动激活 venv：
"terminal.integrated.env.osx": { "PATH": "/path/to/venv/bin:$PATH" }（macOS/Linux） - Windows 下启动时执行脚本：
"terminal.integrated.profiles.windows": { "Python Env": { "path": "cmd.exe", "args": ["/c", "call C:\myproject\venv\Scripts\activate.bat && cmd"] } } - 更可靠的做法是配合
terminal.integrated.shellArgs.*传参，比如 zsh 启动时加载特定配置："terminal.integrated.shellArgs.osx": ["-i", "-c", "source ~/.zshrc; exec zsh"]
⚠️ 注意：shellArgs 是数组，不能写成字符串；env 设置会影响所有终端实例，慎用于 PATH 修改。
使用 WSL2 时终端无法连接或卡住？
WSL 集成依赖 VSCode 的 Remote - WSL 扩展，但即使没装扩展，也能在本地 VSCode 中调用 WSL Shell（如 wsl.exe -d Ubuntu-22.04）。问题多出在路径与权限：
- 确保 WSL 发行版已初始化完成（首次运行过
wsl命令） - Windows 路径写法：用
wsl.exe全路径（C:\Windows\System32\wsl.exe）或简写wsl（需加入 PATH） - 避免在
shellArgs中传入交互式命令（如-e bash），这会导致终端无法接收输入；应让 WSL 自启默认 Shell - 若终端空白或秒退，检查 WSL 中是否缺少
loginshell 配置（chsh -s /bin/bash）
真正麻烦的是跨环境路径映射和信号转发（比如 Ctrl+C 在 WSL 终端中失效），这些不是配置能彻底解决的，得接受它和原生终端的行为差异。
