MacOS系统VSCode提示Python目录不在PATH且pip命令不可用

原始警告信息：

WARNING: The scripts pip, pip3 and pip3.8 are installed in "/Users/my_name/Library/Python/3.8/bin" which is not on PATH. Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.

• 第一步：验证当前shell实际生效的PATH配置
  执行命令echo $PATH，检查输出结果中是否包含/Users/my_name/Library/Python/3.8/bin路径。

  • 注意：/etc/paths属于系统全局配置，改动后需要重启终端或者重新加载shell配置才能生效；另外用户级shell配置文件（~/.zshrc/~/.bash_profile/~/.zprofile）的PATH配置优先级高于全局配置，若这些文件中存在覆盖PATH的逻辑，会导致/etc/paths中的配置不生效。

• 第二步：手动将路径添加到用户级shell配置
  MacOS Catalina及后续版本默认使用zsh作为默认shell，执行以下操作：

  1. 编辑zsh配置文件：nano ~/.zshrc
  2. 在文件末尾添加一行：export PATH="/Users/my_name/Library/Python/3.8/bin:$PATH"，注意替换路径中的用户名和Python版本为你实际的对应值
  3. 保存退出后执行source ~/.zshrc让配置立即生效
     若你使用的是bash，将上述操作中的配置文件替换为~/.bash_profile即可。

• 第三步：排查VSCode终端环境变量继承问题
  VSCode集成终端默认存在环境隔离逻辑，可按以下操作校验：

  1. 打开VSCode设置，搜索terminal.integrated.inheritEnv选项，确认该选项处于开启状态，保证VSCode终端可以继承系统环境变量
  2. 重启VSCode集成终端，或直接重启整个VSCode后重试pip命令。

• 第四步：验证pip可执行文件是否真实存在
  执行命令ls /Users/my_name/Library/Python/3.8/bin | grep pip，确认对应目录下确实存在pip相关可执行文件。

  • 可直接执行全路径命令验证功能是否正常：/Users/my_name/Library/Python/3.8/bin/pip --version，如果能正常输出版本信息，可100%确定问题出在PATH配置上。

• 第五步：排查多版本Python冲突问题
  若设备上同时存在系统自带Python、Homebrew安装的Python、版本管理工具（如pyenv）安装的Python，执行which python3查看当前生效的Python路径，确认对应pip的安装目录和你添加到PATH的路径匹配，避免添加错其他版本Python的pip目录。

• 补充：pip命令别名配置
  若配置完成后只有pip3可以正常使用，但pip命令仍提示不存在，可执行软连接命令映射：ln -s /Users/my_name/Library/Python/3.8/bin/pip3 /Users/my_name/Library/Python/3.8/bin/pip，映射后即可直接使用pip命令。

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