pytest无法导入自定义模块：从taf_pytest.core导入Client失败求助

问题详情 #

项目结构如下：

app_root
--configs
--rest
--taf_pytest
  --core
    --authentication
    --client
    --config
    __init__.py
  --test_data
  --tests
    --test_1
    --test_2
    __init__.py
  --utils
    --routes
    __init__.py
  __init__.py
--__init__.py

执行测试命令：

python -m pytest .\taf_pytest\tests\

触发导入错误：

taf_pytest\conftest.py:11: in <module>
    from taf_pytest.core import Client
E   ImportError: cannot import name 'Client' from 'taf_pytest.core' (C:\my_path\app_root\taf_pytest\core\__init__.py)

已尝试操作：

• 将项目根目录添加至PYTHONPATH
• 删除tests目录下的__init__.py

排查与解决步骤 #

1. 检查core/__init__.py的导出配置 #

taf_pytest/core/__init__.py需要显式导出Client类，否则无法通过from taf_pytest.core import Client直接导入。根据项目结构，Client位于core/client目录下，需在core/__init__.py中添加对应导入语句：

# taf_pytest/core/__init__.py
# 若Client类在core/client/client.py文件中
from .client.client import Client
# 若client目录的__init__.py已导出Client，可简化为：
# from .client import Client

2. 确认Client类的实际位置 #

检查taf_pytest/core/client目录下的文件，确认Client类所在的具体文件（比如client.py），同时确保类名拼写正确（Python大小写敏感）。

3. 清理Python缓存 #

删除项目中所有__pycache__文件夹，避免缓存的旧代码干扰导入逻辑：

# Windows系统
for /d /r . %d in (__pycache__) do @if exist "%d" rmdir /s /q "%d"

# Linux/macOS系统
find . -type d -name "__pycache__" -exec rm -rf {} +

4. 验证导入路径 #

在项目根目录启动Python交互环境，手动测试导入是否正常：

from taf_pytest.core import Client
# 成功导入则路径配置无问题，失败会给出更明确的错误提示

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