解决用户安装Python工具的PATH环境变量问题：以Pipenv为例

理解PATH环境变量与警告信息

在linux或macos系统中，path是一个环境变量，它告诉shell在哪些目录中查找可执行程序。当您在终端中输入一个命令（例如pipenv）时，系统会依次在path变量中列出的所有目录中查找该命令对应的可执行文件。如果找不到，就会报告“command not found”错误。

当您使用pip install --user或在某些情况下直接pip install时，Python会将可执行脚本（如pipenv）安装到用户主目录下的特定位置，通常是~/.local/bin。如果这个目录没有包含在您的PATH环境变量中，系统就无法直接找到这些新安装的工具，从而导致类似以下警告：

WARNING: The scripts pipenv and pipenv-resolver are installed in '/home/sina/.local/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.
Successfully installed pipenv-2023.11.15 setuptools-69.0.2

这意味着pipenv已经成功安装，但您的系统还不知道去哪里找到它。

解决方案一：修改Shell配置文件（推荐）

这是最常见的解决方案，通过将~/.local/bin目录添加到PATH环境变量中，使系统能够识别用户安装的工具。

1. 确定要修改的配置文件

在Linux系统中，常见的shell配置文件有~/.bashrc、~/.profile、~/.zshrc等。

立即学习“Python免费学习笔记（深入）”；

• ~/.bashrc：主要用于交互式非登录shell，即您打开的大多数终端窗口。
• ~/.profile：用于登录shell，通常在用户登录时执行一次。它通常会调用~/.bashrc（如果存在且是bash shell）。对于PATH这种需要全局生效的环境变量，~/.profile通常是更推荐的修改位置，因为它能确保在所有类型的shell会话中都生效。
• ~/.zshrc：如果您使用的是Zsh，则应修改此文件。

对于大多数Ubuntu用户，修改~/.bashrc通常也能解决问题，因为它在新的交互式终端会话中会被加载。但从最佳实践来看，修改~/.profile更具普适性。我们将以~/.bashrc为例，同时说明~/.profile的用法。

2. 编辑配置文件

打开您选择的配置文件。您可以使用nano、vim或其他任何文本编辑器。

使用Nano编辑器修改 ~/.bashrc：

nano ~/.bashrc

使用Nano编辑器修改 ~/.profile：

nano ~/.profile

3. 添加PATH环境变量

在文件的末尾添加以下行。这行代码的含义是将~/.local/bin添加到现有的PATH变量中。

商汤商量

商汤科技研发的AI对话工具，商量商量，都能解决。

36

查看详情

export PATH="$PATH:$HOME/.local/bin"

解释：

• export: 使变量在子进程中也可用。
• PATH="$PATH:/home/sina/.local/bin": 将$PATH（当前PATH的值）与/home/sina/.local/bin用冒号:连接起来。$HOME是一个环境变量，代表当前用户的主目录，使用$HOME比硬编码/home/sina更具通用性。

4. 保存并退出

• 如果您使用的是nano，按Ctrl + O保存，然后按Enter确认文件名，最后按Ctrl + X退出。

5. 应用更改

为了使更改立即生效，您需要重新加载配置文件或重启终端。

重新加载配置文件：

source ~/.bashrc
# 或
source ~/.profile

执行source命令后，您就可以尝试运行pipenv --version来验证是否成功。

解决方案二：通过系统包管理器安装（替代方案）

在某些情况下，如果您的Linux发行版提供了pipenv的官方包，您也可以选择通过系统包管理器进行安装。这种方式通常会将pipenv安装到系统级的路径（如/usr/bin），这些路径通常已经包含在PATH中，因此无需手动修改。

以Ubuntu为例：

sudo apt update
sudo apt install pipenv

注意事项：

• 使用系统包管理器安装的pipenv版本可能不是最新的。
• 这种方法会将pipenv安装为系统级工具，可能需要sudo权限。

总结与最佳实践

将用户安装的Python工具目录添加到PATH环境变量是解决“command not found”警告的关键。

• 首选方法： 修改~/.profile文件，添加export PATH="$PATH:$HOME/.local/bin"。这确保了在所有类型的shell会话中PATH变量都能正确配置。
• 次选方法： 修改~/.bashrc文件，添加相同的行。适用于主要使用交互式bash shell的用户。
• 替代方案： 如果您希望pipenv作为一个系统级工具，并且不介意可能不是最新版本，可以通过系统包管理器安装。

无论选择哪种方法，在修改配置文件后，务必使用source命令重新加载配置，或者简单地关闭并重新打开终端，以使更改生效。通过这些步骤，您将能够顺畅地使用pipenv及其他用户安装的Python工具。

以上就是解决用户安装Python工具的PATH环境变量问题：以Pipenv为例的详细内容，更多请关注php中文网其它相关文章！