VSCode打开.ipynb显示JSON源码，说明Jupyter扩展未加载，需安装ms-toolsai.jupyter和ms-python.python扩展并重启；右上角无内核选项则因ipykernel未在所选解释器中安装并注册，须执行python -m ipykernel install --user --name xxx；卡在“Connecting to kernel…”多因误启远程模式，应关闭Jupyter: Enable Remote。
直接双击 .ipynb 文件就能打开，但多数报错或空白都源于内核没选对、没注册，而不是文件打不开本身。
点开 .ipynb 文件只显示 JSON 源码？
这是最典型的“没识别为 Notebook”的表现，本质是 VS Code 没启用 Jupyter 支持：
- 确认已安装 Microsoft 官方
Jupyter扩展（不是第三方同名扩展） - 检查是否同时装了
Python扩展（必须，Jupyter 扩展依赖它提供解释器支持） - 关闭所有窗口，重启 VS Code —— 扩展有时需重启才完全激活
- 右键 .ipynb 文件 → “Open with” → 选 “Notebook Editor”，而非 “Text Editor”
右上角显示 “No kernel available” 或内核名灰掉？
VS Code 不会自动为你当前 Python 环境安装 ipykernel，它只认你选中的解释器里“已经装好并注册”的内核：
- 按
Ctrl+Shift+P输入Python: Select Interpreter，从列表中选你真正要用的环境（比如./venv/bin/python或anaconda3/envs/ml/bin/python） - 打开集成终端（
Ctrl+`），确认该环境已激活（提示符含(venv)或(ml)） - 运行：
python -m pip install ipykernel - 再注册：
python -m ipykernel install --user --name myproject --display-name "Python (myproject)"（--name不能带空格） - 重启 VS Code 窗口（不是重载，是彻底关掉再打开）
内核选对了，但单元格执行没反应、输出区空白？
静默失败比报错更难排查，常见于内核进程启动失败但 UI 没提示：
- 看底部状态栏：是否稳定显示类似
Python 3.11.9 (myproject)？若闪烁、消失或显示Disconnected，说明内核没连上 - 打开输出面板（
Ctrl+Shift+U）→ 切换到Jupyter日志 → 搜Failed to start the kernel或No module named 'ipykernel' - 别用系统 Shell 装包，必须在 VS Code 集成终端里激活对应环境后操作
- 快捷键别按混：
Ctrl+Enter是只运行当前单元格，Shift+Enter是运行+跳到下一格——新手常误按后者导致光标移走，以为“没执行”
真正卡住的地方往往不是“怎么打开”，而是“打开后用哪个内核、这个内核有没有真正活起来”。ipykernel install 这一步手动做、不依赖自动提示，是最稳妥的起点。
