Python 如何在Windows中添加到PYTHONPATH，以便可以找到我的模块/包

在本文中，我们将介绍如何在Windows操作系统中添加路径到PYTHONPATH，以便Python可以找到您自己创建的模块和包。PYTHONPATH是一个环境变量，用于告诉Python解释器在哪里寻找用户自定义的模块和包。

什么是PYTHONPATH？

PYTHONPATH是一个包含Python模块搜索路径的环境变量。当您在Python代码中使用import语句导入模块或包时，Python解释器会根据PYTHONPATH的设置查找这些模块和包。

Python解释器在启动时会预先设置一个默认的PYTHONPATH，其中包括Python标准库的路径。然而，有时您可能需要将自己的模块或包添加到PYTHONPATH中，以便Python能够找到它们。

检查当前PYTHONPATH的设置

在开始之前，我们首先来检查当前PYTHONPATH的设置。可以通过在命令提示符下运行以下命令来查看PYTHONPATH的值：

python -c "import sys; print(sys.path)"

这将打印出当前PYTHONPATH中包含的路径列表。

添加路径到PYTHONPATH

要将某个路径添加到PYTHONPATH中，您有几种选择。以下是三种常用的方法：

临时设置PYTHONPATH：
您可以在运行Python脚本之前设置临时PYTHONPATH，让Python解释器在运行时能够找到您的模块或包。在命令提示符下，使用以下命令设置PYTHONPATH：
```
set PYTHONPATH=C:\path\to\your\module;C:\path\to\your\package
python your_script.py
```
Bash
在此示例中，我们将C:\path\to\your\module和C:\path\to\your\package添加到PYTHONPATH。
使用.pth文件：
另一种方法是创建.pth文件，其中包含要添加到PYTHONPATH中的路径。.pth文件是一个以路径为内容的文本文件，它告诉Python解释器要搜索的模块和包的路径。

首先，创建一个文本文件，比如mypaths.pth。然后，将要添加的路径逐行写入该文件，例如：

   C:\path\to\your\module
   C:\path\to\your\package
   ```

   将该文件保存到Python安装目录下的site-packages文件夹中。在接下来的Python会话中，Python解释器将自动读取该.pth文件，并将其中的路径添加到PYTHONPATH中。

3. 设置系统环境变量：
   第三种方法是将路径添加到系统的环境变量中，以便Python解释器能够在任何地方都找到您的模块和包。

   - 打开“控制面板”并进入“系统和安全”选项。
   - 点击“系统”选项，然后选择“高级系统设置”。
   - 在弹出的对话框中，点击“环境变量”按钮。
   - 在下面的“系统变量”部分中，找到名为PYTHONPATH的变量。如果没有PYTHONPATH变量，请点击“新建”按钮创建一个名为PYTHONPATH的新变量。
   - 在变量值中，添加您要添加的路径，用分号分隔多个路径。例如，如果要添加路径C:\path\to\your\module和C:\path\to\your\package，变量值设置为：C:\path\to\your\module;C:\path\to\your\package。

   更新完环境变量后，请重新启动您的Python终端或命令行窗口，以使更改生效。

## 验证PYTHONPATH的设置

完成路径添加后，让我们验证一下PYTHONPATH的设置是否成功。可以使用以下代码片段在Python中验证导入自定义模块或包的功能：

```python
import sys

# 添加您的模块/包的路径
sys.path.append('C:\path\to\your\module')
sys.path.append('C:\path\to\your\package')

# 导入您的模块/包
import your_module
from your_package import your_module

# 运行您的代码
your_module.your_function()
your_module.your_class.your_method()

确保将’C:\path\to\your\module’和’C:\path\to\your\package’替换为您实际添加的路径。

如果代码能够成功运行而不出现ImportError或ModuleNotFoundError等错误，那么您已经成功地将模块或包添加到PYTHONPATH中，并且Python解释器可以找到它们。

总结

在Windows操作系统中，要将自定义模块或包添加到PYTHONPATH中，您可以使用临时设置PYTHONPATH、使用.pth文件或设置系统环境变量的方法。通过设置PYTHONPATH，您可以让Python解释器在导入模块或包时找到您的自定义代码。确保验证您的设置是否正确，以确保Python可以成功找到您的模块和包。