自定义模块Helper导入异常：Test Explorer正常但命令行报ModuleNotFoundError

嘿，这个问题我之前也踩过一模一样的坑！核心原因很简单：IDE的Test Explorer会自动把你的项目根目录加到Python的模块搜索路径（sys.path）里，但命令行默认不会，所以才会出现两边运行结果截然不同的情况。

下面给你几个实用的解决方案，按上手难度排序：

1. 临时给命令行添加项目路径（最快见效） #

先假设你的项目结构大概是这样的（如果和你的实际结构不一样，调整对应路径即可）：

你的项目根目录/
├── Helper/
│   ├── __init__.py
│   └── globalHelper.py
└── sampleTest.py

方法A：用PYTHONPATH环境变量 #

打开命令行，先cd到你的项目根目录，然后执行对应系统的命令：

# Windows cmd
set PYTHONPATH=%cd% && python sampleTest.py

# Windows PowerShell
$env:PYTHONPATH = Get-Location; python sampleTest.py

# Linux/macOS
PYTHONPATH=$(pwd) python sampleTest.py

如果用pytest运行测试，就把python sampleTest.py换成python -m pytest sampleTest.py即可。

方法B：在测试文件里手动加路径 #

如果不想每次都输环境变量，可以在sampleTest.py的最顶部加几行代码，强制把项目根目录加到搜索路径里：

import sys
from pathlib import Path

# 路径要根据你的文件位置调整：
# 如果sampleTest.py就在项目根目录下，用Path(__file__).parent
# 如果sampleTest.py在tests文件夹里，就用Path(__file__).parent.parent
project_root = Path(__file__).parent
sys.path.append(str(project_root))

# 现在再导入Helper就没问题了
import Helper

2. 用相对导入（适合规范的项目结构） #

如果你的测试文件和Helper模块在同一个项目层级里，可以改成相对导入。比如sampleTest.py和Helper文件夹在同一目录下，把导入语句改成：

from . import Helper

不过要注意，这种方式必须用包的方式运行测试，比如用python -m pytest或者python -m sampleTest，不能直接python sampleTest.py——直接运行脚本时Python会把它当成顶级模块，相对导入会报错。

3. 最后检查两个容易忽略的细节 #

• 大小写必须一致：Python对模块名大小写敏感！如果你的文件夹叫helper但你写的import Helper，肯定会找不到，这点很容易粗心踩坑。
• init.py的位置要对：确认空的__init__.py确实在Helper文件夹里，而不是项目根目录或者其他地方——只有文件夹里有这个文件，Python才会把它当成可导入的模块。

你可以先在测试文件里加一行print(sys.path)，看看输出里有没有你的项目根目录，要是没有，就说明百分百是路径的问题，用上面的方法解决就行。

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