Python报ModuleNotFoundError或ImportError的本质是解释器找不到模块，主因是未安装或不在sys.path中；需确认Python与pip环境一致、检查sys.path并合理管理虚拟环境。
运行 Python 脚本时报 ModuleNotFoundError 或 ImportError，本质是 Python 解释器在当前环境里找不到你要导入的模块。核心原因就两个：模块没装，或者装了但不在 Python 的搜索路径（sys.path）里。
在命令行中执行：
pip list | grep 模块名 # Linux/macOS pip list | findstr 模块名 # Windows
或者更直接地测试导入：
python -c "import requests; print(requests.__version__)"
如果报错，说明确实没装。用 pip install 模块名 安装即可。注意：确保你用的是和运行脚本**同一个 Python 环境**的 pip（比如用了 python3.9 -m pip install，就别用系统默认的 pip）。
立即学习“Python免费学习笔记（深入）”；
常见陷阱：你用 python script.py 运行，但 pip install 装到了另一个 Python 版本下。验证方法：
python -c "import sys; print(sys.executable)"
pip -V（会显示“from xxx/pythonxx/site-packages”）python -m pip install 模块名
Python 只在 sys.path 列出的目录里找模块。临时查看：
python -c "import sys; print('\n'.join(sys.path))"
如果你的模块在某个自定义路径（比如项目里的 lib/），但该路径不在 sys.path 中，有几种办法：
python -c "import sys; sys.path.insert(0, '/path/to/your/module'); import mymodule"
PYTHONPATH=/path/to/your/module python script.py
import sys; sys.path.append('/path/to/your/module')
如果你在虚拟环境中开发，但忘了激活，或用错了环境，就会“明明装了却找不到”。确认方式：
(venv)）which python（macOS/Linux）或 where python（Windows），路径是否指向虚拟环境目录source venv/bin/activate（Linux/macOS）或 venv\Scripts\activate（Windows）基本上就这些。重点盯住“用的是哪个 Python”、“pip 装到哪儿去了”、“模块路径在不在 sys.path 里”这三点，90% 的问题都能快速定位。
以上就是命令行运行python时找不到模块怎么解决的详细内容，更多请关注php中文网其它相关文章！
python怎么学习？python怎么入门？python在哪学？python怎么学才快？不用担心，这里为大家提供了python速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
563
收藏
