VSCode运行Jupyter Notebook_VSCode数据分析环境搭建

常在VSCode里倒腾Notebook的，都见过这糟心事——点开.ipynb文件，编辑器一片空白，右上角还冷冷地挂着“Python 3 (una vailable)”。这情况说白了，根子就一个：你选的那个Python解释器里，没装ipykernel，或者装了但没成功注册进Jupyter的内核列表。

不是插件没装，也不是jupyter命令不存在，而是VSCode压根找不到一个能跟它正常通信的Python内核。搞明白这一点，问题就解决了一半。

内核选择器为空，或显示“不可用”

这是最典型的卡点。你别看VSCode连着你的Python路径了，但那个环境里可能根本没有可启动的内核进程。

第一步，确认解释器选得对不对。按下快捷键（Win/Linux是Ctrl+Shift+P，Mac是Cmd+Shift+P），执行Python: Select Interpreter。你要找的是那种带着明确路径的项，比如./venv/bin/python或者C:\Users\...\anaconda3\envs\ds-env\python.exe。确认之后，看VSCode底部状态栏，应该已经显示成这条路径了。

接着，打开终端（务必确保已经激活了那个环境），运行一条命令查一下：macOS/Linux用python -m pip list | grep ipykernel，Windows用python -m pip list | findstr ipykernel。如果没看到任何输出，马上去执行python -m pip install ipykernel。

安装之后，最关键的一步是“注册”。注册命令必须带着--user参数，比如这样：python -m ipykernel install --user --name ds-env --display-name "Python (ds-env)"。需要特别注意的是，--name参数不能有空格或中文，否则会无声无息地失败；而--display-name才是你在VSCode下拉菜单里真正看到的名字。

注册完毕后，内核配置文件会固定存放在~/.local/share/jupyter/kernels/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\jupyter\kernels\（Windows）下。VSCode只认这个目录。如果你漏掉了--user，它就可能把内核写到系统级目录里，VSCode就读不到了。这点容易栽坑。

解释器选对了，但运行没反应，或报找不到模块

别以为快捷键坏了。问题在于，Notebook当前绑定的内核，跟你心里想用的那个环境压根不是一回事。VSCode左上角显示的那个内核名字（比如Python 3.11.5 ('ds-env': conda)）才是真正在执行任务的，它跟你当前打开的.py文件或文件夹没关系。

解决思路也很直接：点击一下右上角那个内核名称，从下拉列表里手动选一个。优先选你刚刚注册的那个（就是带了--display-name的那个）。

如果目标环境压根没出现在列表里，那就是注册步骤没成功。进那个环境终端，再跑一遍注册命令。稳一点，还是用python -m pip install ipykernel，别依赖conda install，有些镜像源的conda版ipykernel可能会装成旧版或缺失依赖。

注册完后，你还可以用一个硬核验证方式：在Notebook里运行import sys; print(sys.executable)，看看输出的路径是否指向你的虚拟环境。如果不对，说明内核绑定了别的解释器，需要重新核对注册步骤。

内核注册成功，但一直卡在“正在连接内核”

这其实是个比较隐蔽的坑，VSCode正在尝试连接一个远程Jupyter服务器，而不是你本地刚刚注册好的内核。这是个默认行为被误触发的典型情况。

解决方法如下：

• 打开设置（Ctrl+,），搜索jupyter: enable remote，把Jupyter: Enable Remote这个选项关掉。
• 同时，打开Jupyter: Local Kernel Specs Only，强制VSCode只读取本地kernels/目录下的内核定义。
• 检查一下工作区设置（.vscode/settings.json），看看里面有没有"jupyter.jupyterServerType": "remote"或"jupyter.remoteJupyterServerUri"这类配置。有的话，直接删掉。
• 最后，禁用所有非官方发布的Jupyter类扩展，只保留ms-toolsai.jupyter和ms-python.python这两个，别多装，也别漏装。

这里还有一个经常被忽略的底层逻辑：VSCode并不会继承你在终端里执行的conda activate状态，也不会自动去扫描项目下的.venv文件夹。它只认你点击选中的那个解释器路径下的包。哪怕你在命令行里执行jupyter kernelspec list能看到自己的内核，只要kernel.json里argv[0]指向的python可执行文件路径和VSCode当前选中的解释器不一致，就会造成错位执行。注册完，去验证一下kernel.json里的路径，远比只看名字要靠谱。