何时需将当前工作目录（cwd）加入PYTHONPATH？

首先得明确Python查找模块的核心逻辑：Python会按顺序在sys.path列表中的路径里搜索你要导入的模块。你的问题本质就是**不同环境下，当前工作目录（项目根目录）是否被自动加入了sys.path**的差异。

先搞懂Python默认会把哪些路径加入sys.path #

正常情况下，Python启动时会自动添加以下路径到sys.path：

• Python标准库的安装路径
• 第三方包的site-packages目录
• 如果是直接运行脚本文件（比如python my_script.py），会把脚本所在的目录加入sys.path（不是你运行命令时的当前目录，除非脚本就在当前目录）
• 如果是交互模式启动（直接打python进入命令行）或者用python -c "..."执行单行代码，会把当前工作目录加入sys.path的开头

为什么你的环境会出现差异？ #

结合你的场景（始终在项目根目录，PYTHONPATH未设置），可能的原因有这几个：

1. Python环境的sys.path初始化被修改 #

某些定制化的Python环境可能会改变默认行为，移除当前工作目录的自动添加：

• 部分系统为了安全，修改了Python的启动配置，默认不把当前目录加入sys.path（防止当前目录下的恶意模块覆盖标准库）
• 某些虚拟环境工具或系统包管理器（比如特定版本的apt、brew）在安装Python时，可能调整了启动脚本，导致这个行为变化

2. Python版本的细微行为调整 #

虽然你觉得不是版本问题，但Python 2.7.13和2.7.12之间确实存在一些小的行为修正。比如，某些边缘场景下（比如当前目录存在特殊文件或权限问题），2.7.13可能不会把当前目录加入sys.path，而2.7.12会。

3. 启动方式的隐性差异 #

有没有可能你在能正常运行的环境里是用交互模式执行导入，而在不能运行的环境里是通过脚本执行？比如：

• 交互模式下sys.path会自动加当前目录
• 但如果脚本不在项目根目录（哪怕你在根目录下运行python subdir/script.py），sys.path只会加脚本所在的subdir目录，而不是根目录——不过你说始终在根目录，这个可能性较低，但可以排查下。

怎么验证？ #

最直接的方式是在每个环境里运行以下代码，查看输出：

import sys
print(sys.path)

对比输出结果，看你的项目根目录是否在sys.path列表中。如果能正常运行的环境里存在这个路径，而不能运行的环境里不存在，就完全能解释你的问题了。

总结 #

当Python的默认sys.path不包含你的项目根目录时，你就需要手动设置PYTHONPATH=.来把它加入搜索路径。你遇到的差异就是不同环境下sys.path初始化逻辑的不同导致的。

内容的提问来源于stack exchange，提问作者blueFast