vs code打不开.ipynb文件主因是jupyter扩展未安装或未启用、所选python解释器未安装/注册ipykernel,或误启远程模式;需安装ms-toolsai.jupyter和ms-python.python扩展并重启,手动选择解释器路径,执行python -m pip install ipykernel及python -m ipykernel install --user --name envname --display-name "python (envname)",关闭jupyter: enable remote并重启vs code。

VS Code 里打不开 .ipynb 文件,基本不是文件本身的问题,而是内核没连上、扩展没装对、或者解释器选错了——它不会像网页版那样“点开就跑”,得先让 VS Code 知道“用哪个 Python 环境来执行”。
为什么双击 .ipynb 只显示 JSON 源码?
这是最典型的“没识别为 Notebook”的信号。VS Code 根本没启用 Jupyter 支持,通常因为:
- 没装 Microsoft 官方的
Jupyter扩展(注意:别装第三方同名但作者不是ms-toolsai的) - 装了扩展但没重启 VS Code(尤其更新后)
- 工作区被标记为“不受信任”(右下角提示 Restricted Mode),此时所有 Notebook 功能被禁用
解决方法:Ctrl+Shift+X → 搜 Jupyter → 确认安装的是 ms-toolsai.jupyter → 关闭并重开 VS Code 窗口(不是重载)。
右上角没显示内核选择器,或显示 Python 3 (unavailable)
说明 VS Code 找不到可用的 Python 解释器,或该解释器里没装 ipykernel。它不关心你系统全局有没有 jupyter notebook 命令,只认当前选中的解释器路径下有没有 ipykernel。
- 按 Ctrl+Shift+P → 输入
Python: Select Interpreter→ 从列表里挑一个含python可执行文件的路径(比如./venv/bin/python或~/anaconda3/envs/ds/bin/python) - 打开集成终端(Ctrl+`),确认已激活该环境(
which python或where python输出应和上一步选中的一致) - 运行:
python -m pip install ipykernel,再运行:python -m ipykernel install --user --name myenv --display-name "Python (myenv)"(--name不能有空格) - 重启 VS Code 窗口(不是重载),再打开
.ipynb文件
点了运行按钮没反应,或输出区空白
不是代码卡住,而是内核根本没真正启动成功。VS Code 不会弹错误框,只会静默挂起。
- 看右下角状态栏:是否显示类似
Python 3.11.9 (myenv)?没有就说明 kernel 连接失败 - 按 Ctrl+Shift+U 打开输出面板 → 切换到
Jupyter日志 → 搜Failed to start the kernel或No module named 'ipykernel' - 别依赖 VS Code 自动提示安装
ipykernel——它常卡在“正在安装…”几十秒不动,手动装完再试更稳 - 快捷键别按错:
Ctrl+Enter是只运行当前单元格,Shift+Enter是运行+跳到下一个;新手常按错以为没反应
真正容易被忽略的是:VS Code 的 Notebook 内核和终端默认环境是两套独立的东西。你在 Shell 里 pip install pandas,但 Notebook 跑的是虚拟环境里的另一个 Python,那照样报 ModuleNotFoundError。必须确保 sys.executable 在终端和 Notebook 里完全一致。











