python面试题：PYTHONPATH环境变量的目的是什么？

如果你在用 Python 写多模块项目，特别是拆包拆模块搞架构的时候，肯定遇到过那种“模块明明写好了就是导不进去”的情况。然后你一 Google，搜到了 PYTHONPATH。但网上解释五花八门，有说是用来设路径的，有说影响环境的，结果是很多人用着用着就迷糊了。

其实 PYTHONPATH 就是告诉 Python 去哪里找你要导入的模块，它的本质是影响 sys.path ——也就是模块搜索路径的那一串目录。

当你写 import my_module 的时候，Python 会从一系列路径里依次查找 my_module.py 或者对应的包结构。这个路径列表就在 sys.path 里，你运行下面这段代码就能看到当前环境能访问的模块路径：

import sys
print(sys.path)

默认情况下，Python 会从以下几个地方查：

1. 当前运行脚本所在的目录
2. 安装路径下的标准库
3. 虚拟环境（如果你启用了）
4. 一些 .pth 文件配置
5. 最后就是 PYTHONPATH 指定的路径

如果你把某个目录加到 PYTHONPATH，它就会被插入到 sys.path 的开头，Python 在导入模块时会优先查找你指定的这些路径。

举个实际例子。你有一个项目结构如下：

project/
├── app/
│   └── main.py
└── common/
    └── utils.py

你在 main.py 里想写 from common import utils，结果直接报错 ModuleNotFoundError，因为默认 common/ 不在搜索路径中。

这时候你可以设置 PYTHONPATH：

export PYTHONPATH=/path/to/project
python app/main.py

或者在代码里临时插入（虽然不太推荐）：

import sys
sys.path.insert(0, "/path/to/project")

这样 common 就能被成功导入了。

有时候你在开发框架、构建多项目结构、甚至做测试隔离（比如 pytest 单测依赖多个模块）时，都要靠 PYTHONPATH 来让解释器“知道去哪儿找模块”。

但有一点要注意：PYTHONPATH 只是运行时生效，跟你激活虚拟环境没关系，它不会修改 pip install 的安装路径，也不会影响 site-packages。你可以把它理解为一个“临时的模块入口补丁”。

再有就是不同系统、不同终端，设置方式也略有差异。Linux/macOS 下你可以直接 export，Windows 下要用 set 或者配置环境变量界面，IDE（比如 PyCharm）里则可以在 Run Configurations 里单独设置。

所以结论很明确：PYTHONPATH 的作用就是告诉 Python 多去几个地方找模块，解决的是模块导入路径的问题。搞清楚这个之后，你的 import 就不再是靠运气的事儿了。

面试最优回答：

PYTHONPATH 是一个环境变量，用于指定额外的模块搜索路径。当 Python 执行 import 时，会根据 sys.path 的列表查找模块，而 PYTHONPATH 会插入到 sys.path 的前面，优先参与查找。

它常用于多模块项目结构中解决模块无法导入的问题，比如当某个包不在标准路径下时，通过设置 PYTHONPATH 来告诉解释器去哪个目录找。在处理多层架构项目或者做测试环境分离时就经常会用到这个变量。