VSCode怎么使用Jupyter Notebook_VSCode运行Notebook教程【进阶】

VSCode运行Notebook的核心卡点是内核（kernel）是否真实可用且与Python解释器匹配

先选对解释器，再在该环境下执行 python -m pip install ipykernel 并注册内核，重启VSCode后选择对应kernel；禁用远程连接、关闭冲突Jupyter进程、确保两个扩展 ms-python.python 和 ms-toolsai.jupyter 均启用。

在VSCode里运行Notebook，远不止“装个插件”那么简单。真正的核心挑战，往往在于内核（kernel）——它是否真的准备好了，并且和你当前的Python解释器完美匹配。那些让人头疼的报错、界面无响应，或者代码补全失效，十有八九根源都在这里。

内核选错了或根本没注册

如果你在右上角看到 Python 3.x.x (una vailable) 的提示，或者干脆找不到选择内核的下拉菜单，那基本可以断定：VSCode没能识别到可用的内核。问题通常不在于Jupyter没装，而是关键的 ipykernel 没有正确注册。

• 第一步，确认解释器：通过 Python: Select Interpreter 命令，确保你选中的正是你打算使用的那个环境路径，比如 ./venv/bin/python 或者 ~/miniforge3/envs/mydata/bin/python。
• 第二步，安装内核：在对应环境的终端里，执行 python -m pip install ipykernel。这一步千万别省，只安装 jupyter 包是不够的。
• 第三步，注册内核：继续执行 python -m ipykernel install --user --name mydata --display-name "Python (mydata)"。注意，--name 参数里不能有空格，而 --display-name 才是你在下拉菜单里看到的友好名称。
• 最后，重启生效：完全关闭并重新打开VSCode窗口（不是简单的重载）。再次打开 .ipynb 文件后，点击右上角的内核选择器，应该就能看到你刚刚注册的选项了。

运行单元格没反应 / 卡在 “Connecting to kernel…”

遇到单元格点了没反应，状态栏一直显示“Connecting…”，这通常不是界面卡死，而是内核启动失败了，或者被某些远程连接的逻辑给“劫持”了。如果这个状态持续超过30秒，基本可以确定是本地内核没起来。

• 查看日志找线索：打开输出面板（Ctrl+Shift+U），切换到 Jupyter 日志，仔细查找类似 Failed to start the kernel 或 No module named 'ipykernel' 这样的错误信息。
• 检查远程连接设置：看看设置里是不是不小心开启了 Jupyter: Enable Remote。把它关掉，同时可以启用 Jupyter: Local Kernel Specs Only 来确保只使用本地内核。
• 排查端口冲突：如果你之前手动启动过 jupyter lab 或 jupyter notebook 服务，相关端口可能被占用，导致VSCode尝试连接远端失败。关掉所有已有的Jupyter进程再试一次。
• 耐心等待初始化：首次打开Notebook或者切换环境后，VSCode可能会在后台静默执行 pip install ipykernel。这个过程有时会显得有点慢，别急着关闭，等上一分钟左右再看看日志和状态。

补全延迟、断点不生效、变量面板空白

这些问题严格来说不算Bug，而是Notebook模式与传统的 .py 文件在底层工作机制上的差异导致的。代码补全依赖内核返回的类型信息，调试功能依赖内核命名空间的实时状态，而变量面板默认并不会自动同步。

• 关于补全延迟：补全慢个1到2秒是正常现象，因为它需要等待内核响应。频繁地按 Ctrl+Space 强制触发补全，只会让请求堆积，导致更卡。
• 关于断点调试：设置断点之前，必须确保包含该代码的单元格至少被执行过一次。否则，内核里根本没有定义任何变量，调试器也就失去了上下文。
• 一个关键特性：断点只对当前单元格生效。但要注意，即使你删除了前面定义变量的单元格（比如 df = pd.read_csv(...)），只要内核没有重启，后面单元格里的 df.head() 依然可以正常运行——因为变量还活在内核的内存里。
• 关于变量面板：右侧的 Variables 面板在普通执行模式下通常是空的。想查看变量内容，要么在代码里写 print(df.shape) 这样的语句，要么就进入调试模式（点击右上角的虫子图标，然后选择“Debug Cell”）。

最后，还有一个最容易被忽略的细节：VSCode的Notebook功能，其实是由 ms-python.python 和 ms-toolsai.jupyter 这两个扩展共同协作提供的。但它们有主次之分——ms-python.python 是基础，ms-toolsai.jupyter 是增强。单独安装后者而不装前者，或者反过来禁用了其中一个，都可能导致内核列表变空、相关功能按钮消失。所以，这两个环节，哪一个都不能图省事跳过。