代码收藏家技术教程 2025-02-24

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

什么是 PYTHONPATH？

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

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

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

打开终端。
使用文本编辑器打开您的 shell 配置文件。根据您的 shell 和系统，这可能是 .bashrc、.bash_profile 或 .profile 文件。例如，如果您使用的是 bash，可以编辑 .bashrc 文件：
```
vi ~/.bashrc
```
在打开的配置文件中，添加以下行来设置或更新 PYTHONPATH：
```
export PYTHONPATH="${PYTHONPATH}:/path/to/your/module1:/path/to/your/module2"
```
这里的 /path/to/your/module1 和 /path/to/your/module2 应该替换为您想要添加到 PYTHONPATH 中的实际路径。
保存并关闭文件。
为了让更改立即生效，您需要重新加载配置文件。可以通过以下命令完成：
```
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 的指南：

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

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

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

作者：shengchao0920