【Python】如何在 Linux/Windows 系统中设置 PYTHONPATH 环境变量

什么是 PYTHONPATH？

PYTHONPATH 是一个环境变量，它告诉 Python 解释器在哪些目录中查找要导入的模块。这对于包含不在标准目录中的自定义模块非常有用。

Linux 系统中设置 PYTHONPATH 环境变量

在 Python 开发环境中，正确设置 PYTHONPATH 环境变量对于确保 Python 解释器能够找到并导入自定义模块至关重要。以下是如何在 Linux 系统中设置或更新 PYTHONPATH 的简洁指南。

如何设置 PYTHONPATH？

以下是在 Linux 系统中设置 PYTHONPATH 的步骤：

1. 打开终端。
2. 使用文本编辑器打开您的 shell 配置文件。根据您的 shell 和系统，这可能是 .bashrc、.bash_profile 或 .profile 文件。例如，如果您使用的是 bash，可以编辑 .bashrc 文件：

   vi ~/.bashrc
   

3. 在打开的配置文件中，添加以下行来设置或更新 PYTHONPATH：

   export PYTHONPATH="${PYTHONPATH}:/path/to/your/module1:/path/to/your/module2"
   

   这里的 /path/to/your/module1 和 /path/to/your/module2 应该替换为您想要添加到 PYTHONPATH 中的实际路径。
4. 保存并关闭文件。
5. 为了让更改立即生效，您需要重新加载配置文件。可以通过以下命令完成：

   source ~/.bashrc
   

   或者，如果您编辑的是 .bash_profile 或 .profile，则使用：

   source ~/.bash_profile
   

   或

   source ~/.profile
   

示例

假设您有两个模块目录 /home/user/my_project/libs 和 /home/user/other_project/libs，您想要将它们添加到 PYTHONPATH 中，您可以这样操作（路径之间用冒号隔开）：

export PYTHONPATH="${PYTHONPATH}:/home/user/my_project/libs:/home/user/other_project/libs"

这行代码会追加新的路径到现有的 PYTHONPATH 变量中，而不会覆盖原有的设置。

小贴士

• 使用 ${PYTHONPATH} 可以确保您不会丢失任何现有的 PYTHONPATH 设置。
• 如果您使用的是其他 shell（如 zsh 或 fish），则配置文件可能是 .zshrc 或 config.fish。
• 更改 PYTHONPATH 后，新启动的终端会话或脚本将使用新的设置。
  通过以上步骤，您可以轻松地管理 PYTHONPATH，以便 Python 解释器能够正确地找到您的模块。

在 Windows 系统中设置 PYTHONPATH 环境变量的步骤与 Linux 系统有所不同。以下是在 Windows 中设置 PYTHONPATH 的指南：

Windows 系统中设置 PYTHONPATH

操作

1. 打开系统属性对话框：
   • 您可以通过右键点击“此电脑”或“我的电脑”图标，然后选择“属性”来打开系统属性。
   • 或者，您可以在开始菜单中搜索“系统”并点击它。
2. 点击“高级系统设置”：
   • 在系统属性窗口中，找到并点击“高级”标签页。
   • 在“高级”标签页中，点击“环境变量”按钮。
3. 编辑系统变量：
   • 在环境变量窗口中，您会在下方看到“系统变量”和“用户变量”两个部分。
   • 在“系统变量”部分，找到名为 PYTHONPATH 的变量（如果没有，则点击“新建”来创建一个）。
   • 如果找到了 PYTHONPATH，双击它进行编辑；如果需要新建，点击“新建”，然后输入 PYTHONPATH 作为变量名。
4. 设置或更新变量值：
   • 在变量值字段中，输入您的模块路径。如果之前已经有值，确保不要覆盖它们，而是用分号（;）分隔每个路径。
   • 例如：C:\path\to\your\module1;C:\path\to\your\module2
5. 点击“确定”保存更改：
   • 您需要点击每个打开的对话框的“确定”按钮来保存更改。
6. 重启资源管理器或重启计算机：
   • 为了让环境变量生效，您可能需要重启文件资源管理器（按 Ctrl + Shift + Esc 打开任务管理器，右键点击“文件资源管理器”并选择“重新启动”）或者重启计算机。

示例

假设您有两个模块目录 C:\Users\YourUsername\myproject\libs 和 C:\Users\YourUsername\otherproject\libs，您想要将它们添加到 PYTHONPATH 中，您可以按照以下步骤操作：

1. 打开环境变量窗口。
2. 找到或创建 PYTHONPATH 变量。
3. 设置变量值为 C:\Users\YourUsername\myproject\libs;C:\Users\YourUsername\otherproject\libs。
   通过以上步骤，您就可以在 Windows 系统中设置 PYTHONPATH 环境变量了。