modulenotfounderror报错时，先确认模块是否真的没装；多数情况是模块未安装或装在错误环境，需检查pip list、python解释器路径、虚拟环境激活状态，并验证python 3.12兼容性及wheel构建是否成功。
ModuleNotFoundError报错时，先确认模块是否真的没装
Python 3.12本身不改变模块查找逻辑，但升级后常因环境隔离或pip版本差异导致误判“模块不存在”。实际多数情况是模块根本没装，或装在了别的Python环境里。
- 运行
python -m pip list | grep requests（把requests换成你要查的模块名），确认是否出现在输出中 - 检查当前Python解释器路径：
which python（macOS/Linux）或where python（Windows），再对比pip对应的是不是同一个环境——常见坑是用系统Python跑脚本，却用conda或pyenv的pip装包 - 如果用venv，确保已激活：
source venv/bin/activate（Linux/macOS）或venv\Scripts\activate（Windows）
pip install后仍报ModuleNotFoundError，检查Python 3.12兼容性
部分包尚未适配Python 3.12，安装时看似成功，实则wheel不匹配或源码编译失败，最终import失败。错误信息里若含ERROR: Could not find a version that satisfies the requirement或静默跳过编译步骤，就得手动验证。
- 安装时加
--verbose参数：pip install --verbose some-package，观察最后是否有Successfully installed且无failed building wheel - 某些包（如
pywin32、mysqlclient）需额外依赖或预编译二进制，Python 3.12刚发布时官方wheel可能还没跟上，可临时降级到3.11验证是否为版本问题 - 用
pip show some-package查看Location路径，再手动进入该目录，确认存在__init__.py和对应模块文件
sys.path里没有包所在路径，手动追加不解决根本问题
有人遇到ModuleNotFoundError就直接改sys.path.append(...)，这能临时绕过，但掩盖了环境配置缺陷，后续打包、部署或CI中必然失败。
-
sys.path只影响当前Python进程，重启即失效；且顺序敏感——靠前的路径会覆盖同名模块 - 真正该做的是让包被pip正确安装到site-packages：用
python -m pip install -e /path/to/package（开发模式）或确认pip install输出中的Installing collected packages指向当前解释器的site-packages - 检查
python -c "import site; print(site.getsitepackages())"输出，确保你的包确实在这个路径下
PyInstaller或打包工具引发的ModuleNotFoundError
用PyInstaller、cx_Freeze等打包后运行报ModuleNotFoundError，通常不是缺模块，而是自动分析漏掉了动态导入、隐藏导入或数据文件。
- PyInstaller默认不扫描
importlib.import_module或字符串拼接的模块名，需用--hidden-import=xxx显式声明 - 某些包（如
matplotlib、sqlalchemy）有大量子模块和插件机制，必须加--collect-all matplotlib这类参数 - 运行打包后的程序时，用
--debug imports（PyInstaller）看实际加载了哪些模块，比盲目加--hidden-import更可靠
pip list里能看到包名，但import就是失败。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
