linux 上运行 python 代码后报错： ModuleNotFoundError: No module named 'torch'

### Linux 上解决 Python `ModuleNotFoundError: No module named 'torch'` 的方法 在 Linux 系统中，当尝试运行依赖 PyTorch 库的 Python 脚本时，如果出现 `ModuleNotFoundError: No module named 'torch'` 错误，则表明当前使用的 Python 环境未正确安装 PyTorch 或存在环境配置问题。以下是具体的解决方案： #### 1. 验证 PyTorch 是否已安装 可以通过以下命令验证当前环境中是否存在 `torch` 模块： ```bash pip list | grep torch ``` 如果没有返回任何结果或者版本不符合需求，则说明需要重新安装或升级。 #### 2. 使用 Pip 安装 PyTorch 对于大多数情况，推荐通过官方支持的方式安装最新版 PyTorch。访问 [PyTorch官网](https://pytorch.org/get-started/locally/) 并根据操作系统、CUDA 版本以及 Python 版本选择合适的安装命令。例如，在 CPU-only 环境下可执行如下命令： ```bash pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu ``` 若需 GPU 支持并具备 CUDA 加速功能，则应替换为对应的 CUDA 命令，比如针对 CUDA 11.8 可使用： ```bash pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118 ``` #### 3. 创建独立虚拟环境 为了避免不同项目之间的依赖冲突，建议创建一个新的虚拟环境来隔离各个项目的包管理。具体操作如下： ```bash python -m venv pytorch_env source pytorch_env/bin/activate ``` 激活该虚拟环境后再按照前述方式安装所需模块即可[^1]。 #### 4. 检查 PATH 和 PYTHONPATH 设置 有时候即使成功安装了某些库仍然会出现加载失败的情况，这可能是由于系统的路径设置不当所致。确认 `.bashrc` 文件里是否有类似下面这样的行定义，并确保它们指向正确的解释器位置： ```bash export PATH="/path/to/python:$PATH" export PYTHONPATH=$PYTHONPATH:/your/project/directory/ ``` #### 5. 处理特定场景中的错误 如果是基于 Conda 进行开发的话，请注意切换到对应 conda channel 下载资源；而对于那些涉及自定义编译选项的应用程序（如 apex），则可能还需要额外调整构建参数以兼容目标平台特性[^4]。 以上措施能够有效应对绝大多数关于缺失 `torch` 导致的功能障碍现象。当然实际应用过程中也可能碰到其他类型的异常状况，这就要求开发者依据具体情况灵活运用调试技巧加以排除。 ```python import torch print(torch.__version__) if torch.cuda.is_available(): print('CUDA is available') else: print('No CUDA detected') ``` 此脚本可用于初步测试 Torch 的可用性和设备状态。