当python项目结构涉及多级目录（如tests与framework并列），直接import同级或上级包会因sys.path未包含对应路径而报错modulenotfounderror，需通过调整python模块搜索路径来解决。
当python项目结构涉及多级目录（如tests与framework并列），直接import同级或上级包会因sys.path未包含对应路径而报错modulenotfounderror，需通过调整python模块搜索路径来解决。
在Python项目开发中，常见的目录结构（如C:utomation ramework与C:utomation estsunit-tests并列）容易引发跨包导入失败问题。即使framework/下已正确放置__init__.py，执行pytest时仍出现ModuleNotFoundError: No module named 'framework'，其根本原因在于：Python解释器默认只在sys.path所列路径中查找模块，而当前工作目录（通常是tests/unit-tests/）及其父目录并不自动包含framework所在路径。
✅ 验证问题根源
运行以下代码确认framework路径是否在搜索路径中：
import sys
for p in sys.path:
print(p)若输出中未出现C:utomation ramework或C:utomation，则证实路径缺失。
✅ 推荐解决方案（按优先级排序）
1. 启动时指定根目录（推荐 · 临时但安全）
在项目根目录（C:utomation）下运行pytest，并确保该目录为当前工作目录：
立即学习“Python免费学习笔记（深入）”；
cd C:utomation pytest testsunit-tests est_myunittest.py
此时Python会将当前目录（C:utomation）自动加入sys.path，from framework import constants即可正常解析。
2. 使用-p参数或PYTHONPATH环境变量（开发友好）
运行前设置环境变量（Windows）：
set PYTHONPATH=C:utomation pytest testsunit-tests
或在Linux/macOS中：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
export PYTHONPATH=/path/to/automation pytest tests/unit-tests/
该方式无需修改代码，且对所有子进程生效。
3. 修改sys.path（仅限调试，不推荐生产）
在测试文件开头动态添加路径（注意转义反斜杠或使用原始字符串）：
import sys import os # 将项目根目录加入路径（更健壮：基于当前文件位置推导） sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..', '..'))) from framework import constants
⚠️ 注意：此法硬编码路径，降低可移植性；且每次运行需重新加载，不适用于CI/CD。
4. 安装为可编辑包（长期项目首选）
在C:utomation（即包含framework/和tests/的根目录）下创建setup.py：
from setuptools import setup, find_packages
setup(
name="automation-framework",
packages=find_packages(),
)然后以开发模式安装：
pip install -e .
此后任何位置运行pytest均可直接导入framework——这是符合PEP 517/518的最佳实践。
⚠️ 重要注意事项
- ❌ 避免在代码中硬写
sys.path.append("C:\automation\framework")：路径耦合严重，跨平台失效（Linux用正斜杠），且无法被IDE智能识别。 - ❌ 不要依赖
.pth文件进行项目级配置：它作用于全局Python环境，污染其他项目，且不易版本控制。 - ✅ 始终确保
framework/和tests/同级目录下存在__init__.py（即使为空），否则Python不视其为包。 - ✅ 在
pytest.ini中配置python_paths（Pytest ≥ 6.0）可声明额外路径：[tool:pytest] python_paths = ..
综上，以项目根目录为工作路径运行pytest，或通过PYTHONPATH/可编辑安装方式管理路径，是兼顾可维护性、可移植性与团队协作的最优解。 模块导入问题本质是路径可见性问题，而非语法错误，理清sys.path机制即可一劳永逸。
