遇到 No module named "torch" 这个报错，最典型的一种场景就是 Jupyter Notebook 里面 import torch 正常跑通，但是在系统终端直接运行同一个 py 脚本就提示找不到 torch，这个问题绝大多数情况不是 torch 没装好，而是 Notebook 和终端用的不是同一个 Python 解释器、虚拟环境，Notebook 内核绑定的是装了 PyTorch 的环境，而终端默认调用的是系统原生 Python 或者另外一个干净的虚拟环境，环境里面根本没有安装 torch 包，很多新手会反复重装 torch，重装完发现 Notebook 依旧能用、终端依旧报错，浪费大量时间。Jupyter 支持自由切换内核，你在 Notebook 里选的是 conda 环境、venv 虚拟环境里的 Python，torch 是装在这个环境下面；打开终端的时候，如果没有手动激活对应的虚拟环境，终端就会使用全局 Python，全局环境里没有 pip install torch，自然就报模块不存在；还有一种高频情况是电脑同时装了 Python3.8、Python3.10、Python3.11 多个版本，pip 和 pip3 对应不同解释器，装包装到了 A 版本，终端跑代码用 B 版本，两边包完全隔离。整套排查思路核心就是核对两边解释器路径，保证终端运行脚本时，使用和 Notebook 内核一模一样的 Python 环境，再确认 torch 确实在该环境内安装。对齐解释器之后，后续写代码、跑脚本、开 Notebook 时统一环境习惯，就能避免这类两边表现不一致的坑。
快速核对解释器命令清单
- Notebook 单元格内执行，查看当前解释器路径：
import sys
print(sys.executable)
- 终端执行，查看当前终端 Python 路径：
which python
Windows
where python
- 终端查看当前环境已安装包：
pip list | grep torch
- 查看当前 pip 绑定的解释器：
pip --version
两种常见处理方案对比表
| 方案 | 操作方式 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|---|
| 终端激活对应虚拟环境后运行脚本 | conda activate /source venv/bin/activate，再 python xxx.py | 使用 conda、venv 管理环境 | 不改动原有配置，最规范 | 每次新开终端都要手动激活 |
| 修改 Jupyter 内核，切换成系统全局 Python | ipykernel 注册全局 Python 给 Notebook | 不想使用虚拟环境，统一用全局 | 不用每次激活 | 包容易污染，多项目版本冲突风险高 |
完整排查修复步骤
- 在 Jupyter Notebook 新建单元格，运行import sys;print(sys.executable)，复制这条解释器路径保存下来
- 打开终端，输入which python（Windows 用 where python），对比输出路径，看是否和 Notebook 一致
- 如果路径不一样，说明环境分离：确认 Notebook 的环境是 conda 还是 venv，在终端执行激活命令
- 激活成功后，再次在终端打印 python 路径，确认和 Notebook 路径对齐
- 激活环境后执行pip list，检查列表里是否存在 torch；没有就执行pip install torch
- 在当前已激活的终端里运行 python 脚本，测试 import torch 是否正常
- 长期稳定方案：给虚拟环境注册 Jupyter 内核，固定两边统一环境，避免后续选错内核
高频踩坑点清单
- 用 pip 装 torch，但是终端调用的是 python3，pip 绑定的是 python2，包装错位
- 装完 torch 只在 Notebook 里测试，没有在激活环境的终端验证
- 多个 conda 环境，Notebook 选 envA，终端默认在 base 环境
- VS Code 终端自动继承全局 Python，和 Notebook 内核分离
- 用了 pip3、pip、conda install 混用，包分散在不同环境
【相关 FAQ】
问题 1：出现 No module named "torch"，Notebook 能导入、终端报错，直接在终端重装 torch 可以吗？
回答 1：可以临时解决，但优先对齐解释器，No module named "torch" 的根源是两边环境不一样，直接重装会把 torch 装到终端环境，后续很容易再次出现两边不一致。
问题 2：怎么确认 Jupyter Notebook 的内核是哪一个 conda 环境？
回答 2：在 Notebook 单元格执行sys.executable拿到路径，结合 conda env list 核对路径，这是排查 No module named "torch"、两边表现不一致的关键。
问题 3：已经对齐解释器路径了，还是报 No module named "torch" 是什么原因？
回答 3：对齐解释器之后依旧出现 No module named "torch"，说明这个 Python 环境里确实没有安装 torch，在激活后的终端里执行 pip install torch 即可。
问题 4：能不能设置终端默认自动激活虚拟环境，不用每次手动激活？
回答 4：可以配置 shell 脚本自动激活，但是要注意，自动激活只是方便操作，排查 No module named "torch" 问题的核心依旧是保证 Notebook 和终端的解释器一致。
【参考资料】
[2026-10-22]（Jupyter 和终端 Python 环境不一致，No module 报错排查）PyTorch 中文社区
[2026-09-14]（Jupyter 内核管理、ipykernel 注册虚拟环境教程）Jupyter 官方文档
[2026-08-11]（pip、python 解释器绑定关系，多版本 Python 踩坑）掘金
[2026-07-05]（No module named 系列报错，环境分离问题汇总）CSDN
【免责声明】
本文为 No module named "torch" 报错的技术排查科普；不同操作系统、conda/venv 版本、Jupyter 配置存在差异；切换、激活虚拟环境前请留意项目依赖版本，避免其他包版本被覆盖，重要项目建议提前导出 requirements.txt 备份。