Linux Mint 21.3下VS Code 1.89.1集成终端无法使用Zsh 5.8.1

问题背景 #

在Linux Mint 21.3系统中使用VS Code 1.89.1时，集成终端无法正常调用Zsh 5.8.1，尝试多种配置方案均无效，具体表现包括：

• 系统终端执行which zsh正常，但VS Code的bash/sh终端中无输出
• 自定义Bash启动Zsh的脚本配置失效
• 配置terminal.integrated.env.linux的PATH参数无效果
• 添加Zsh配置项未生效
• VS Code终端中执行cd usr提示目录不存在

解决方案 #

1. 正确配置Zsh终端Profile #

新版本VS Code已使用terminal.integrated.profiles.linux替代旧的terminal.integrated.shell.linux，需将Zsh配置完整写入该项并设为默认：

"terminal.integrated.profiles.linux": {
    "Zsh": {
        "path": "/usr/bin/zsh", // 替换为`which zsh`得到的实际路径
        "args": ["-l"]
    }
},
"terminal.integrated.defaultProfile.linux": "Zsh"

保存配置后重启VS Code，尝试打开终端。

2. 启用环境变量继承 #

VS Code默认可能会隔离系统环境变量，导致终端无法找到Zsh路径。添加以下配置让终端继承系统环境：

"terminal.integrated.inheritEnv": true

3. 检查VS Code权限与安装方式 #

如果VS Code是通过Snap安装的，沙箱机制可能限制了目录访问和环境变量读取：

• 临时测试：在系统终端执行code --no-sandbox启动VS Code，若Zsh恢复正常，说明是Snap权限问题
• 永久解决：卸载Snap版本的VS Code，安装Deb包版本；或给Snap版VS Code添加目录访问权限：

sudo snap connect code:home :home

4. 修复自定义启动脚本（若使用） #

之前的启动脚本格式错误，正确的脚本需换行并添加执行权限：

1. 编写脚本start_zsh.sh：

#!/bin/bash
exec /usr/bin/zsh

2. 赋予执行权限：

chmod +x /home/username/start_zsh.sh

3. 重新配置VS Code的Profile：

"terminal.integrated.profiles.linux": {
    "CustomBashWithZsh": {
        "path": "/bin/bash",
        "args": ["-c", "/home/username/start_zsh.sh"],
        "icon": "terminal-bash"
    }
},
"terminal.integrated.defaultProfile.linux": "CustomBashWithZsh"

5. 验证终端启动路径 #

执行cd usr失败是因为使用了相对路径，正确的绝对路径应为cd /usr。若需修改终端默认启动路径，可添加配置：

"terminal.integrated.cwd": "/" // 或设置为常用工作目录

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