PYTHONPATH是Python模块搜索路径的环境变量，用于添加自定义模块查找目录。它在import时扩展搜索路径，支持导入非标准位置的模块，适用于大型项目结构管理。可通过系统环境变量配置：Windows使用分号分隔路径，macOS/Linux使用冒号，并通过修改shell配置文件如~/.zshrc设置export PYTHONPATH。验证方式为打印sys.path内容，确认自定义路径已加载。需注意路径格式正确、避免过多路径导致冲突，且IDE可能不完全依赖该变量。临时设置可直接在终端运行命令，推荐结合虚拟环境与良好包结构管理项目依赖。
PYTHONPATH 是 Python 解释器用来查找模块的环境变量。它告诉 Python 在哪些目录中搜索要导入的模块或包，除了默认的系统路径之外，还可以通过 PYTHONPATH 添加自定义路径，让 Python 能够找到你写的代码文件。
PYTHONPATH 的作用
当你在代码中使用 import 语句时，Python 会按照一定的顺序在多个目录中查找对应的模块。这些目录包括当前目录、标准库路径、第三方库安装路径等。而 PYTHONPATH 允许你将额外的目录加入这个搜索路径列表中。
它的主要用途包括：
- 导入位于非标准位置的自定义模块
- 开发大型项目时组织多个包的引用
- 避免频繁修改 sys.path 来添加路径
如何配置 PYTHONPATH
可以在不同操作系统中通过设置环境变量来配置 PYTHONPATH。以下是常见系统的配置方法：
立即学习“Python免费学习笔记（深入）”；
Windows 系统- 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”
- 在“用户变量”或“系统变量”中点击“新建”
- 变量名输入：PYTHONPATH
- 变量值填写你要添加的路径，多个路径用分号 ; 分隔，例如：
C:\myproject\lib;D:\python\modules - 保存后重启终端或 IDE 生效
- 打开终端，编辑 shell 配置文件（如 ~/.bashrc、~/.zshrc 或 ~/.profile）
- 添加以下内容（以 zsh 为例）：
export PYTHONPATH="$PYTHONPATH:/your/project/path:/another/module/dir"
- 保存文件后运行命令使其生效：
-
source ~/.zshrc（或对应配置文件）
验证 PYTHONPATH 是否生效
在 Python 中可以通过以下代码查看当前的模块搜索路径：
import sysfor path in sys.path: print(path)
如果看到你添加的目录出现在输出中，说明 PYTHONPATH 已正确加载。
注意事项
- 路径格式要正确，Linux/macOS 使用冒号 : 分隔，Windows 使用分号 ;
- 避免在 PYTHONPATH 中添加过多路径，可能引发模块冲突或性能问题
- 某些 IDE（如 PyCharm、VSCode）有自己的路径管理机制，可能不完全依赖 PYTHONPATH
- 临时设置可在终端中执行（仅当前会话有效）：
Linux/macOS：PYTHONPATH=/my/path python myscript.py
