VSCode中Jupyter Notebook跑不起来，90%因Python解释器未正确选择、ipykernel未注册或远程模式误启；须手动通过命令面板选解释器路径，执行python -m ipykernel install --user注册内核，关闭Jupyter: Enable Remote，并重启VSCode而非仅重载窗口。
VSCode里Jupyter Notebook跑不起来，90%不是插件没装，而是Python解释器和ipykernel没对上——选错解释器路径、漏注册内核、或误启远程模式，都会导致右上角显示“Python 3 (unavailable)”或卡在“Kernel starting…”。
Python: Select Interpreter 必须手动点选，不能靠终端激活
VSCode 不继承你在终端里执行的 conda activate ds-env 或 source venv/bin/activate。它只认你用命令面板选中的那个解释器路径，哪怕你终端里能跑 jupyter notebook，VSCode 也完全不知道。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入并执行Python: Select Interpreter - 从列表中选带明确环境路径的项，例如：
~/miniconda3/envs/ds-env/bin/python（macOS/Linux）或C:\Users\Me\anaconda3\envs\ds-env\python.exe（Windows） - 选完后看左下角状态栏是否变成类似
Python 3.11.5 (ds-env)；没变就执行Developer: Reload Window - 验证方式：新建一个
.py文件，写import pandas as pd; print(pd.__version__)，按Ctrl+F5运行——报ModuleNotFoundError就说明解释器根本没绑对
python -m ipykernel install --user 是硬性步骤，不是可选项
光有 jupyter 包不够，VSCode 需要的是已注册的 kernel spec。很多人装了插件却没内核可选，就是这步跳过了，或者执行时用了错误权限。
- 必须在目标环境的终端里运行：
python -m ipykernel install --user --name ds-env --display-name "Python (ds-env)" -
--name不能含空格或中文（否则注册静默失败），--display-name才是右上角下拉菜单里显示的名字 - 注册后路径固定：
~/.local/share/jupyter/kernels/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\jupyter\kernels\（Windows）；VSCode 只读这个位置 - 如果之前注册过同名内核，先用
jupyter kernelspec list查路径，再用jupyter kernelspec uninstall ds-env清掉再重装
内核选不到？先关掉 Jupyter: Enable Remote
右上角内核选择器为空、或点开只有“Python 3 (unavailable)”，大概率是 VSCode 误启了远程 Jupyter Server，直接跳过了本地 kernel specs 的扫描。
立即学习“Python免费学习笔记（深入）”；
- 打开设置（
Ctrl+,），搜jupyter: enable remote，把Jupyter: Enable Remote关掉 - 同时开启
Jupyter: Local Kernel Specs Only - 检查工作区
.vscode/settings.json里有没有"jupyter.jupyterServerType": "remote"或"jupyter.remoteJupyterServerUri"——有就删掉 - 改完设置后，必须重启 VSCode（不是“重载窗口”），否则新内核不会出现在选择器里
扩展依赖关系不能少：ms-toolsai.jupyter + ms-python.python 缺一不可
新版 Jupyter 扩展不自带底层解释器桥接能力，全靠 ms-python.python 提供 Python 环境识别、内核启动、变量通信等基础能力。缺一个，Notebook 就加载失败或单元格无法执行。
- 打开扩展面板（
Ctrl+Shift+X），确认两个扩展都已安装且“已启用”： -
ms-toolsai.jupyter（图标是紫色火焰，官方 Jupyter 扩展） -
ms-python.python（Microsoft 官方 Python 扩展，209M+ 下载量） - 别信“Jupyter 扩展已包含 Python 支持”的说法——那是旧版逻辑，2026 年起二者已彻底解耦
- 如果扩展启用后仍异常，尝试禁用再启用，或卸载重装（注意备份
settings.json）
最容易被忽略的其实是注册内核后的重启动作：只“重载窗口”不行，必须彻底关闭再打开 VSCode，否则 ~/.local/share/jupyter/kernels/ 下的新目录不会被扫描到——这个细节卡住过太多人。
