Mac终端zsh: command not found问题求助（修改VS Code路径后）

临时恢复命令可用性 #

先在VS Code终端中执行以下命令，手动添加系统默认路径，让命令临时正常运行：

export PATH=/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:$PATH

执行后可测试pip --version或ls，验证命令是否恢复。

永久修复步骤 #

1. 检查VS Code终端环境配置 #

打开VS Code设置（快捷键Cmd+,），搜索terminal.integrated.env.osx：

• 若存在自定义PATH配置，删除错误配置，或修改为包含系统默认路径的配置：

  "terminal.integrated.env.osx": {
    "PATH": "/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:$PATH"
  }
  

• 若无相关配置，直接跳过此步。

2. 修复zsh配置文件 #

打开zsh的用户配置文件~/.zshrc（可通过终端命令code ~/.zshrc打开）：

• 查找文件中export PATH=开头的行，若发现直接覆盖PATH而非追加的配置（如export PATH=/xxx），修改为追加模式，确保系统默认路径被包含：

  export PATH=/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:$PATH
  

• 若未找到PATH相关配置，直接在文件末尾添加上述代码。
  保存文件后，执行source ~/.zshrc使配置生效，重启VS Code终端验证。

3. 重置VS Code终端集成设置 #

若以上方法无效，重置VS Code终端相关设置：

• 打开VS Code设置，点击右上角的「打开设置(JSON)」图标
• 删除所有以terminal.integrated开头的配置项，保存后重启VS Code

额外排查方向 #

打开Mac自带的Terminal.app（非VS Code内嵌终端），执行echo $PATH：

• 若系统终端同样出现命令找不到的问题，说明是系统zsh配置异常，需重点修复~/.zshrc或系统级配置文件/etc/zshrc
• 若系统终端正常，问题则集中在VS Code的终端集成配置上，重新检查VS Code的终端设置即可

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