### PyCharm 运行 Python 代码时 ModuleNotFoundError 的解决方案 在使用 PyCharm 运行 Python 代码时，如果出现 `ModuleNotFoundError` 错误，这通常意味着程序尝试导入一个模块，但解释器无法找到该模块。以下是可能的原因及解决方法： #### 1. 检查虚拟环境配置 PyCharm 默认会为项目创建一个虚拟环境。如果未正确配置虚拟环境，可能导致模块未被安装到当前环境中。可以通过以下方式检查和修复： - 打开 **File > Settings > Project: <project_name> > Python Interpreter**。 - 确保选择了正确的解释器。如果没有合适的解释器，可以点击齿轮图标添加新的解释器[^1]。 - 如果模块确实未安装，可以在 PyCharm 的终端中运行以下命令进行安装： ```bash pip install <module_name> ``` #### 2. 验证模块名称拼写 错误的模块名称拼写也会导致 `ModuleNotFoundError`。例如，尝试导入 `numpy` 但拼写成 `numpi` 会导致错误。确保模块名称与官方文档或 PyPI 中的名称一致[^2]。 #### 3. 检查模块路径 如果模块是自定义模块（非标准库或第三方模块），需要确保模块所在的目录已包含在 `PYTHONPATH` 中。可以通过以下方式添加路径： - 在 PyCharm 中打开 **Run/Debug Configurations**。 - 在 **Environment variables** 中添加或修改 `PYTHONPATH`，将其指向模块所在目录[^3]。 #### 4. 使用绝对导入代替相对导入 相对导入可能导致模块加载失败，尤其是在不同文件夹结构下运行代码时。将相对导入改为绝对导入可以避免此类问题。例如： ```python # 相对导入（可能导致错误） from .module import MyClass # 绝对导入（推荐） from project.submodule.module import MyClass ``` #### 5. 检查多版本冲突 在同一系统中安装多个 Python 版本时，可能会导致模块安装到错误的 Python 解释器中。可以通过以下命令验证模块是否安装在当前使用的 Python 版本中： ```bash python -m pip show <module_name> ``` 如果模块未安装在当前解释器中，请明确指定解释器安装模块： ```bash /path/to/python -m pip install <module_name> ``` #### 6. 重启 PyCharm 和缓存清理 有时，PyCharm 的缓存可能导致模块识别问题。可以尝试以下操作： - **File > Invalidate Caches / Restart > Invalidate and Restart**。 - 清理缓存后重新启动 PyCharm 并再次运行代码[^4]。 --- ### 示例代码：验证模块是否存在 以下是一个简单的脚本，用于检测模块是否已正确安装并可导入： ```python import importlib module_name = "numpy" # 替换为需要检测的模块名 try: importlib.import_module(module_name) print(f"模块 {module_name} 已成功导入") except ModuleNotFoundError: print(f"模块 {module_name} 未找到，请安装") ``` ---