解决Python中ModuleNotFoundError: No module named 'torch'报错

1. 问题现象与初步诊断

最近在帮同事排查一个Python环境问题时，遇到了经典的ModuleNotFoundError: No module named 'torch'报错。这个错误表面看很简单，但背后可能隐藏着多种环境配置问题。事情是这样的：同事在全新安装的Python 3.8环境中，直接运行pip install torch后，代码中import torch依然报错。

首先我们需要明确几个关键点：

1. 报错发生在import阶段，说明Python解释器在sys.path包含的路径中找不到torch模块
2. 使用pip安装后仍然报错，可能意味着：
   • torch没有安装到当前Python环境
   • 存在多个Python环境导致混淆
   • 安装的torch版本与Python版本不兼容

2. 完整排查流程与解决方案

2.1 环境验证步骤

先执行以下诊断命令（Windows/Linux/macOS通用）：

bash复制# 检查当前Python解释器路径
which python  # Linux/macOS
where python  # Windows

# 检查pip对应的Python环境
pip -V

# 查看已安装包列表
pip list | grep torch  # Linux/macOS
pip list | findstr torch  # Windows

常见问题场景：

1. 系统存在多个Python版本（如Python 2.7和3.8共存）
2. 使用了虚拟环境但未激活
3. 安装时网络问题导致包不完整

2.2 针对性解决方案

场景1：pip与python环境不匹配

这是最常见的问题。解决方法：

bash复制# 明确指定对应python版本的pip
python -m pip install torch

# 或者直接使用完整路径
/path/to/python -m pip install torch

重要提示：永远不要直接使用pip install，而应该使用python -m pip install，这样可以确保pip与python环境一致。

场景2：虚拟环境问题

如果使用venv/virtualen