如何阻止PyCharm与Python将运行文件目录添加至sys.path头部

原因说明 #

直接运行单个.py文件时，Python会默认把该文件所在目录添加到sys.path最前端，这是Python的原生行为，并非PyCharm的特殊设置——你在终端中得到相同结果也验证了这一点。

解决方法 #

终端环境处理 #

不要直接执行文件，改用-m参数以模块方式运行，同时切换到项目根目录（projects/project）：

cd projects/project
PYTHONPATH=/projects/project:/projects/dependency python -m app.main

这种方式下，sys.path的头部会是当前工作目录projects/project，而非projects/project/app。

PyCharm环境配置调整 #

1. 打开「运行/调试配置」（Run/Debug Configurations）
2. 在「Configuration」标签页的「Execution」区域，勾选 "Run with Python -m module name"
3. 在「Module name」输入框中填写app.main
4. 保持「Working directory」设置为projects/project
5. 保存配置后重新运行

通过模块方式启动，PyCharm会遵循Python的模块导入规则，不再自动将app目录添加到sys.path头部。

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