Mac系统VSCode中如何将脚本添加至PATH？pip安装包后命令失效

什么是PATH？ #

PATH是系统环境变量，它指定终端查找可执行命令（比如pip、pytest）的目录列表。如果安装包的脚本所在目录不在PATH里，终端就找不到对应命令，会弹出command not found报错，同时pip会给出路径未在PATH的警告。

一、给zsh终端添加PATH（解决终端命令找不到问题） #

你的pip脚本目录是/Users/landonbragg/Library/Python/3.8/bin，按以下步骤添加到PATH：

• 打开终端，执行命令打开zsh配置文件：

  open ~/.zshrc
  

• 在文件末尾添加一行配置：

  export PATH="/Users/landonbragg/Library/Python/3.8/bin:$PATH"
  

• 保存文件后，回到终端执行命令让配置生效：

  source ~/.zshrc
  

• 验证：输入echo $PATH，查看输出中是否包含/Users/landonbragg/Library/Python/3.8/bin。之后再运行pytest或pip就不会报错。

如果你的终端是bash（老版本Mac默认终端），则编辑~/.bash_profile或~/.bashrc文件，添加相同的export命令，再执行source ~/.bash_profile生效。

二、Mac系统VSCode中配置PATH #

VSCode集成终端默认继承系统PATH，若仍有问题，可手动配置：

• 打开VSCode，按Cmd + Shift + P打开命令面板，输入Preferences: Open Settings (JSON)打开设置文件。
• 在JSON配置中添加以下内容：

  "terminal.integrated.env.osx": {
      "PATH": "/Users/landonbragg/Library/Python/3.8/bin:$PATH"
  }
  

• 保存设置，重启VSCode终端，即可正常运行安装的脚本。

额外提示 #

若只是想临时屏蔽pip的警告，安装包时可添加参数：

pip install pytest --no-warn-script-location

但更推荐添加PATH的方式，避免后续安装其他包时重复遇到相同问题。

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