### 已知问题分析 在 PyCharm 中，即使已经通过 `pip` 或其他方式安装了所需的 Python 包，在运行代码时仍可能提示 `ModuleNotFoundError` 错误。这种现象通常由以下几个原因引起： 1. **虚拟环境未正确配置**：PyCharm 使用的解释器与实际安装包的环境不一致。 2. **PYTHONPATH 配置错误**：某些情况下，源码目录未被正确添加到 `PYTHONPATH` 中。 3. **第三方库依赖冲突**：不同版本的库之间可能存在兼容性问题。 --- ### 解决方案 #### 方法一：确认当前使用的 Python 解释器 确保 PyCharm 当前项目所使用的 Python 虚拟环境或全局环境与安装包的环境一致。 操作步骤如下： - 打开 PyCharm 设置 (`File -> Settings`)。 - 导航至 `Project: <your_project_name> -> Python Interpreter`。 - 检查右侧列表中是否存在目标模块（如 `torch`）。如果不存在，则需重新安装该模块[^4]。 ```bash pip install <module_name> ``` #### 方法二：调整 PYTHONPATH 配置 有时 PyCharm 默认不会将项目的根目录自动加入 `PYTHONPATH`，这可能导致无法找到模块。可以通过以下设置修正此问题： - 打开 PyCharm 设置 (`File -> Settings`)。 - 前往 `Build, Execution, Deployment -> Console -> Python Console`。 - 勾选选项 `Add source roots to PYTHONPATH`[^3]。 #### 方法三：手动指定模块路径 对于一些特殊场景（例如模块位于非标准位置），可以使用以下代码动态添加模块路径： ```python import sys sys.path.append('path_to_your_module') ``` 其中 `'path_to_your_module'` 是模块所在的绝对路径。 #### 方法四：修复 distutils/setuptools 问题 如果是由于 Python 版本更新导致的 `distutils` 废弃问题，可通过安装 `setuptools` 替代解决[^2]： ```bash python -m ensurepip --upgrade pip install setuptools ``` #### 方法五：验证模块是否正常加载 创建一个新的 `.py` 文件，仅包含以下内容以测试模块导入功能： ```python try: import torch # 替换为目标模块名称 print(f"Torch version: {torch.__version__}") except ImportError as e: print(e) ``` 运行脚本观察输出结果。如果没有报错且显示版本号，则说明模块已正确加载。 --- ### 总结 以上方法涵盖了从环境配置、路径管理到具体模块验证等多个层面的问题排查手段。按照上述流程逐一检查即可有效定位并解决问题。 ---