VS Code 打不开 .ipynb 文件或显示 JSON 源码,是因未安装或未启用 Microsoft 官方 Jupyter 扩展(ms-toolsai.jupyter),且需同时启用 Python 扩展;内核不可用多因 ipykernel 未安装或注册失败,注册须带 --user 参数并避免空格;运行卡在“Connecting to kernel…”通常是误启远程模式,应关闭 Jupyter: Enable Remote 并启用 Local Kernel Specs Only;ModuleNotFoundError 则表明所选解释器环境中缺失对应包,需在该环境终端中 pip/conda 显式安装。
VS Code 打不开 .ipynb 文件或显示 JSON 源码
说明 Jupyter 扩展根本没加载,不是环境问题,而是扩展缺失或未激活。
必须安装
(Microsoft 官方版),仅装
扩展不够
安装后务必重启 VS Code,或按
输入
测试命令是否存在;若提示
,说明扩展静默失败,需重装
检查扩展面板里
扩展是否也已启用——新版 Jupyter 扩展依赖它提供解释器桥接,两者缺一不可
右上角内核选择器为空或显示 “Python 3 (unavailable)”
VS Code 找到了 Python 解释器路径,但该环境里没有可通信的内核进程。90% 的情况不是没装
,而是漏了
或注册失败。
先在目标环境终端中运行:
(macOS/Linux)或
(Windows);无输出就立刻执行
注册命令必须带
:例如
;不加
可能写入系统级目录,VS Code 无权读取
不能含空格或特殊字符,否则内核注册会失败但不报错;
才是下拉菜单里看到的名字
注册后别忘了点右上角内核选择器旁的刷新按钮,或执行
选对了内核,但单元格运行卡在 “Connecting to kernel…”
VS Code 正在尝试连接远程 Jupyter Server,而非本地内核。这是默认行为被误触发的典型表现。
打开设置(
),搜索
,关闭
同时启用
,强制只读取本地注册的 kernel
检查工作区设置(
)里有没有
或
,有就删掉
禁用所有非官方 Jupyter 类扩展(如第三方 kernel 管理器),避免干扰
内核可用,但 import pandas/numpy 报 ModuleNotFoundError
说明你选的是一个“干净”的 Python 解释器,但数据分析库没装进去——和 Jupyter 配置无关,纯环境依赖问题。
Python 3.14.3
微软官方的 Python 扩展,是 VS Code 安装量最高的扩展(209M+)。集成 IntelliSense(通过 Pylance)、调试(通过 Python Debugger)、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
下载
立即学习
“
Python免费学习笔记(深入)
”;
确认你当前选中的解释器(右下角显示的路径)就是你打算跑分析代码的那个环境;比如选了
,就得在这个 venv 里装包
不要在全局 Python 或 conda base 环境里注册 kernel 后,又指望它能 import 项目专属的包
在该环境下终端中直接运行:
;conda 用户请统一用
,避免 pip/conda 混用导致环境损坏
VS Code 的 notebook 不会自动继承终端激活状态,所有包必须显式安装到 kernel 对应的解释器环境中
最容易被忽略的其实是环境隔离粒度:一个项目配一个 venv,一个 venv 装一套包,一个 venv 注册一个 kernel。三者错位,就会出现“内核存在但缺库”“库装了但 kernel 没注册”“kernel 注册了但 VS Code 没刷新”这类看似随机、实则必然的问题。
ms-toolsai.jupyterPythonCtrl+Shift+PJupyter: Select InterpreterCommand 'Jupyter: Select Interpreter' not foundPythonjupyteripykernelpython -m pip list | grep ipykernelpython -m pip list | findstr ipykernelpython -m pip install ipykernel--userpython -m ipykernel install --user --name myenv --display-name "Python (myenv)"--user--name--display-nameDeveloper: Reload WindowCtrl+,jupyter: enable remoteJupyter: Enable RemoteJupyter: Local Kernel Specs Only.vscode/settings.json"jupyter.jupyterServerType": "remote""jupyter.remoteJupyterServerUri"./venv/bin/pythonpython -m pip install pandas numpy matplotlib seaborn scikit-learnconda install