当 `unittest` 测试因 `modulenotfounderror` 报错（如找不到 `pyscreenshot`）而失败，但源文件单独运行正常时，问题通常源于测试执行时的 python 模块搜索路径（`sys.path`）与实际项目结构不匹配。
在你的项目中，screenshoter.py 能正常运行，说明 pyscreenshot 已正确安装且当前环境可识别；但 unittest 执行时抛出 ModuleNotFoundError: No module named 'pyscreenshot'，这看似矛盾——实则暴露了一个关键事实：报错并非来自 pyscreenshot 本身未安装，而是测试模块未能正确导入 src.util.screenshoter 所依赖的上下文环境（例如相对导入、包结构或工作目录差异）。更准确地说，常见真实原因是：测试文件运行时的工作目录或 sys.path 未包含项目根目录，导致 from src.util.screenshoter import Screenshooter 失败，进而使 import pyscreenshot 的导入链在错误上下文中被触发（例如因 __init__.py 缺失或包结构未被识别）。
✅ 正确解决路径问题的推荐做法如下：
确保项目具备合法的 Python 包结构：在 src/ 目录下添加空文件 src/__init__.py（即使为空），并确认 src/util/__init__.py 也存在。否则 src.util 不会被识别为有效包，from src.util.screenshoter import ... 将失败。
-
统一执行入口与模块解析路径：
❌ 不推荐直接运行测试文件（如 python test_screenshoter.py），因其默认以当前文件所在目录为 sys.path[0]，易导致包路径混乱。
✅ 推荐使用 python -m unittest 方式，并从项目根目录（即 src/ 的同级目录）执行：# 假设目录结构为：./myproject/src/util/screenshoter.py 和 ./myproject/tests/test_screenshoter.py cd /path/to/myproject python -m unittest tests.test_screenshoter
此方式会将当前目录（myproject/）自动加入 sys.path，使 src 可被顶层导入。
立即学习“Python免费学习笔记（深入）”；
-
若必须在测试文件内动态修正路径（如需 IDE 点击运行），可在测试文件开头显式扩展 sys.path：
import sys import os # 将项目根目录（src 的父目录）加入 Python 路径 PROJECT_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) sys.path.insert(0, PROJECT_ROOT) # 使用 insert(0, ...) 优先于其他路径 import unittest from src.util.screenshoter import Screenshooter class TestScreenshoter(unittest.TestCase): def test_random_test(self): self.assertTrue(True) # 替换为实际断言 if __name__ == "__main__": unittest.main()
⚠️ 注意事项：
- 避免在生产代码或 screenshoter.py 中硬编码 sys.path.append()，这会破坏模块封装性；路径修复应仅存在于测试启动层。
- pip install pyscreenshot 必须在当前 Python 环境中执行（检查 which python 与 pip --version 是否匹配），虚拟环境未激活是常见疏漏。
- 若使用 pytest，可通过 pyproject.toml 或 setup.py 配置 packages，或设置 PYTHONPATH=. 环境变量，但 unittest 原生支持更依赖结构合规性。
总结：根本解法不是“重装库”，而是让 Python 在测试时能像运行主脚本一样正确识别 src 为包——通过规范包结构（__init__.py）、统一执行方式（-m unittest + 正确工作目录）或可控路径注入，即可彻底规避此类 ModuleNotFoundError。
