VS Code打不开.ipynb文件主因是ipykernel未在所选Python环境中安装或未注册:需先确认解释器路径,再在该环境终端执行python -m pip install ipykernel,然后运行python -m ipykernel install --user --name myenv --display-name "Python (myenv)",最后重启VS Code并手动选择内核。

VS Code 跑不起来 .ipynb 文件,90% 不是插件没装,而是内核根本没连上——ipykernel 没装在你选中的 Python 环境里,或者装了但没注册进 Jupyter 内核列表。
VS Code 显示 “Python 3 (unavailable)” 或 kernel 下拉为空
这不是扩展问题,是 VS Code 找不到可用的内核。它只看当前选中的 Python 解释器里有没有 ipykernel,不会跨环境搜索。
- 先按
Ctrl+Shift+P运行Python: Select Interpreter,确认你挑的是目标环境(比如./venv/bin/python或anaconda3/envs/ds/python.exe) - 打开集成终端(确保已激活该环境),运行:
python -m pip list | grep ipykernel(macOS/Linux)或python -m pip list | findstr ipykernel(Windows)——没输出就立刻执行python -m pip install ipykernel - 再注册内核:
python -m ipykernel install --user --name myenv --display-name "Python (myenv)"(注意:--name不能含空格,--display-name才是下拉菜单里看到的名字) - 必须重启整个 VS Code 窗口(不是重载窗口),再打开
.ipynb文件
点了运行按钮没反应,或光标卡住、输出空白
这是内核进程已退出但 UI 没提示,VS Code 的 Notebook 界面比网页版更“安静”,容易误判为卡死。
- 看底部状态栏:是否显示类似
Python 3.11.5 (myenv)?如果没有,说明 kernel 根本没连上 - 按
Ctrl+Shift+U打开输出面板,切换到Jupyter日志,搜Failed to start the kernel或No module named 'ipykernel' - 别依赖 VS Code 首次启动时的自动安装——它可能静默卡住几十秒甚至失败;手动装好再开 notebook 更稳
- 快捷键别按错:
Shift+Enter是运行并跳转,Ctrl+Enter是只运行当前单元格;新手常按错以为“没反应”
运行报 ModuleNotFoundError: No module named 'IPython'
这名字有误导性,实际缺的是 ipykernel,不是 IPython。Jupyter Notebook 的执行能力靠 ipykernel 提供,IPython 只是它的依赖之一。
- 在终端中激活你 VS Code 当前选中的那个环境(比如
conda activate myenv或source venv/bin/activate) - 执行
python -m pip install ipykernel(不是pip install jupyter,后者不解决 kernel 缺失) - 然后注册:
python -m ipykernel install --user --name myproject --display-name "Python (myproject)" - 重启 VS Code,再点右上角 kernel 选择器,应能看到刚注册的条目
- 注意:不要在 base 环境反复注册同名 kernel,会导致下拉列表混乱甚至无法切换
变量面板(View > Variables)不显示变量
这个面板默认不工作,它只在调试模式下生效——不是 notebook 正常执行就能填满的。
- 想查
df.shape或np.isnan(x).sum(),得先点击上方绿色“运行并调试”按钮,或按F5 - 断点必须打在有可执行代码的行上(Markdown 单元格或空行无效)
- 断点仅对当前 cell 生效,跨 cell 不继承上下文;如果想看全局变量,用
print()或display()更直接 - 补全会延迟 1–2 秒,因为要等内核返回类型信息;别狂按
Ctrl+Space
最常被忽略的一点:VS Code 的 Notebook 功能不是靠单个“Jupyter 插件”驱动的,而是由 ms-python.python(Python 扩展)和 ms-toolsai.jupyter(Jupyter 扩展)协同完成;二者都得装且启用,否则 kernel 选择器可能压根不出现。


















