当您在安装或更新python包时遇到“warning: the scripts pip, pip3 and pip3.10 are installed in ... which is not on path”警告时，这意味着您的系统无法直接通过命令名称找到这些python脚本。本教程将深入解释此警告的含义、不处理的后果，并提供将python脚本目录添加到系统path环境变量的详细步骤，确保您的`pip`及相关工具能够被正确识别和执行，提升开发效率。
理解Python脚本PATH警告
在使用pip安装或升级Python包时，您可能会遇到一个警告信息，指出pip、pip3和pip3.10等脚本被安装在一个特定目录（例如/usr/local/python/3.10.8/bin），但该目录并未包含在系统的PATH环境变量中。
什么是PATH环境变量？
PATH是一个系统环境变量，它包含了一系列目录路径。当您在命令行中输入一个命令（例如ls、cd或pip）时，操作系统会按照PATH变量中列出的顺序，在这些目录中查找对应的可执行文件。如果找到了，就执行它；如果遍历完所有目录仍未找到，就会提示“命令未找到”。
警告的含义
立即学习“Python免费学习笔记（深入）”；
这个警告明确告诉您，尽管pip及其相关脚本已成功安装在指定位置，但由于该位置不在PATH中，系统无法像处理ls或cd那样直接通过名称找到并执行这些脚本。这意味着，您无法直接在终端输入pip来运行它。
不处理警告的后果
如果您选择忽略这个警告而不进行任何配置更改，将会遇到以下问题：
- 无法直接执行命令： 您将无法直接在终端中输入pip、pip3或pip3.10来运行这些命令。
- 需要完整路径： 每次需要使用这些脚本时，您都必须输入它们的完整绝对路径，例如/usr/local/python/3.10.8/bin/pip install some-package，这无疑会大大降低操作效率。
- 工具发现困难： 像which pip这样的命令将无法找到pip的安装位置。同时，命令行自动补全功能（通过Tab键）也无法识别这些脚本。
为什么值得修复？
修复这个PATH问题不仅是一个“问题”的解决，更是一种提升开发体验和效率的优化。将其添加到PATH是Python环境管理的标准实践，能够带来以下便利：
- 操作便捷性： 无需记住或输入冗长的路径，直接输入命令名称即可执行。
- 命令可发现性： 方便使用which等工具查找命令路径，并利用Shell的自动补全功能。
- 遵循最佳实践： 确保您的Python开发环境配置符合行业标准和预期行为。
解决方案：将脚本目录添加到PATH
有两种主要方法来处理这个警告：将脚本目录添加到PATH环境变量（推荐）或使用--no-warn-script-location参数（不推荐）。
1. 推荐方案：修改PATH环境变量
这是最推荐和最根本的解决方案。通过将Python脚本的安装目录添加到PATH中，系统就能自动找到并执行pip等命令。
步骤概述：
- 确定Python脚本的安装路径（警告信息中已给出，例如/usr/local/python/3.10.8/bin）。
- 编辑您的Shell配置文件（如.bashrc、.zshrc或.profile）。
- 添加或修改export PATH语句。
- 使更改生效。
具体操作示例（适用于Bash/Zsh用户）：
假设您的Python脚本路径是/usr/local/python/3.10.8/bin。
-
打开Shell配置文件：
- 如果您使用Bash Shell（Linux默认或macOS较早版本），打开~/.bashrc或~/.bash_profile：
nano ~/.bashrc # 或者 vi ~/.bashrc
- 如果您使用Zsh Shell（macOS Catalina及更高版本默认），打开~/.zshrc：
nano ~/.zshrc # 或者 vi ~/.zshrc
- 在某些情况下，您可能需要编辑~/.profile，尤其是在您希望PATH设置对所有Shell会话（包括非交互式Shell）都生效时。通常，.bashrc或.zshrc会从.profile中加载。
- 如果您使用Bash Shell（Linux默认或macOS较早版本），打开~/.bashrc或~/.bash_profile：
-
添加或修改PATH变量： 在文件末尾添加以下行，或者如果您已经有export PATH行，则将新的路径追加到现有路径中。
export PATH="/usr/local/python/3.10.8/bin:$PATH"
解释：
- export：使变量在子进程中也可用。
- PATH="..."：设置PATH变量。
- "/usr/local/python/3.10.8/bin"：这是您的Python脚本目录。
- :$PATH：这是一个关键部分，它将新的目录添加到现有PATH变量的前面。这样做可以确保您的特定Python版本脚本优先于系统可能存在的其他Python版本脚本被找到。如果您想让系统默认路径优先，可以写成export PATH="$PATH:/usr/local/python/3.10.8/bin"。
保存并关闭文件。
-
使更改生效： 在终端中运行以下命令，以加载更新后的配置文件：
source ~/.bashrc # 或者 source ~/.zshrc
或者，您可以关闭当前终端窗口并重新打开一个新的终端。
-
验证： 运行以下命令检查pip是否已被正确识别：
which pip pip --version
如果输出显示了正确的pip路径和版本信息，则表示配置成功。
2. 不推荐方案：使用 --no-warn-script-location
这个参数的作用是抑制警告信息，而不是解决根本问题。它告诉pip：“我知道脚本不在PATH中，但请不要再提醒我了。”
何时使用：
- 在自动化脚本中，您可能不希望看到警告信息，并且已经通过其他方式确保了脚本的可执行性（例如，通过完整路径调用）。
- 作为临时解决方案，但强烈建议最终还是修复PATH。
使用方法：
在运行pip install或其他pip命令时，添加此参数：
pip install some-package --no-warn-script-location
或者，您可以在pip的配置文件中全局设置此选项。
与PATH修复的区别：
- PATH修复： 解决了脚本无法被系统直接找到和执行的根本问题，提升了便利性和可发现性。
- --no-warn-script-location： 仅仅是隐藏了警告信息，脚本仍然不在PATH中，您仍然需要使用完整路径来执行它们（除非您通过其他方式解决了这个问题）。
总结与建议
PATH环境变量的正确配置对于任何开发环境都至关重要，尤其是在Python生态系统中。当您遇到“scripts are not on PATH”的警告时，最明智和推荐的做法是将其对应的目录添加到您的系统PATH环境变量中。这不仅能消除烦人的警告，更能显著提升您的开发效率和命令行操作体验。
虽然--no-warn-script-location参数可以暂时隐藏警告，但它并未解决潜在的可用性问题，因此不建议作为长期解决方案。花几分钟时间正确配置PATH，将为您的未来开发工作带来长期的便利。
