当 `unittest` 测试因 `modulenotfounderror` 报错找不到第三方模块（如 `pyscreenshot`）时，问题通常并非安装缺失，而是测试运行时的 python 解释器环境与主程序不一致，导致模块路径解析失败。
在你提供的代码中，screenshoter.py 单独运行正常，说明 pyscreenshot 已正确安装且可被当前 Python 环境识别；但 unittest 执行时却报错，根本原因在于：测试文件的执行路径（working directory）与模块搜索路径（sys.path）不匹配。
默认情况下，Python 仅将当前工作目录（即你运行 python test_file.py 时所在的目录）及标准库路径加入 sys.path。若你的测试文件位于 tests/test_screenshoter.py，而 src/util/screenshoter.py 依赖 pyscreenshot，Python 并不会自动将 src/ 或其上级目录加入路径——更关键的是，pyscreenshot 本身虽已安装，但错误提示实为“误导性线索”：真正的问题常是 src 包未被识别为可导入包，进而导致其内部 import pyscreenshot 在测试上下文中因路径隔离而触发连锁失败（尤其在 IDE 或某些测试启动方式下）。
✅ 正确解法不是反复重装包，而是显式确保项目根目录（含 src/）在 sys.path 中，使 from src.util.screenshoter import Screenshooter 能被正确解析：
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
# tests/test_screenshoter.py
import sys
import os
import unittest
# 将项目根目录（即 src 的父目录）动态添加到 Python 路径
# 假设目录结构为：project_root/src/... 和 project_root/tests/...
root_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
sys.path.insert(0, root_dir)
from src.util.screenshoter import Screenshooter
class TestScreenshoter(unittest.TestCase):
def test_random_test(self):
# 示例：可在此处实例化并验证 Screenshooter 行为
self.assertTrue(True) # 占位断言
if __name__ == "__main__":
unittest.main()⚠️ 注意事项：
立即学习“Python免费学习笔记（深入）”；
- 使用 sys.path.insert(0, root_dir) 而非 append()，确保自定义路径优先于其他路径，避免同名模块冲突；
- os.path.dirname(__file__) 获取当前测试文件所在目录，'..' 回退一级即项目根目录——请根据实际目录结构调整路径层级（如测试文件在 project_root/test/，则需 ../；若在 project_root/tests/，同样适用）；
- 更规范的做法是将 src/ 设为 Python 包：在 src/__init__.py 中添加空文件，并通过 pip install -e . 安装项目为可编辑包（需配置 setup.py 或 pyproject.toml），一劳永逸解决路径问题；
- 避免在生产测试中硬编码路径；CI/CD 环境建议统一使用 -m pytest 或 python -m unittest 并配合 PYTHONPATH=src 环境变量启动。
总结：ModuleNotFoundError 在测试中出现，90% 源于路径隔离而非包未安装。通过动态修正 sys.path 或采用可编辑安装，即可让 unittest 与主程序共享一致的模块解析上下文。
