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 是增强。单独安装后者而不装前者，或者反过来禁用了其中一个，都可能导致内核列表变空、相关功能按钮消失。所以，这两个环节，哪一个都不能图省事跳过。
