VSCode通过SSH连接远程Linux主机时Mac无法创建本地集成终端

问题原因 #

VSCode在远程SSH会话中，本地终端的shell配置默认继承了远程主机的设置，但你的本地机器未安装zsh，或者zsh的路径并非/usr/bin/zsh，导致终端启动失败。

解决方案 #

方法1：修改VSCode本地终端的shell配置

1. 按Ctrl+,（Windows/Linux）或Cmd+,（Mac）打开VSCode设置界面。
2. 在搜索框输入对应系统的终端配置项：
   • Linux本地：搜索terminal.integrated.shell.linux
   • Mac本地：搜索terminal.integrated.shell.osx
   • Windows本地：搜索terminal.integrated.shell.windows
3. 将默认的/usr/bin/zsh替换为本地已安装的shell路径：
   • Linux/Mac本地bash路径：/bin/bash
   • Windows本地Git Bash路径：C:\Program Files\Git\bin\bash.exe
   • Windows本地PowerShell路径：C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
4. 保存设置后重启VSCode，再打开本地终端即可。

方法2：临时切换本地终端的shell配置

1. 打开VSCode的终端面板，点击右上角的下拉箭头。
2. 选择「选择默认配置文件」，在列表中挑选本地已安装的shell（如Bash、PowerShell等）。
3. 关闭当前终端，重新打开新终端即可生效。

方法3：在本地安装zsh（如果需要使用zsh）

• Linux本地（Debian/Ubuntu系）：执行sudo apt install zsh
• Linux本地（RHEL/CentOS系）：执行sudo dnf install zsh
• Mac本地：若未自带zsh，执行brew install zsh
• Windows本地：通过WSL安装zsh，或为Git Bash安装zsh插件

内容的提问来源于stack exchange，提问作者Nick