必须安装官方jupyter扩展（ms-toolsai.jupyter）并重启vscode，否则.ipynb文件无法运行单元格、渲染输出或显示内核选择器；还需安装python扩展、正确配置解释器，并在目标环境中执行ipykernel install注册内核。
必须装官方 Jupyter 扩展（ID: ms-toolsai.jupyter），否则 .ipynb 文件只是纯文本，单元格无法运行、输出不渲染、内核选择器根本不出现。
安装 Jupyter 扩展的准确操作路径
VSCode 不自带 Notebook 功能，所有交互能力都来自这个扩展。它和 Python 扩展协同工作，但不能互相替代——只装 Python 扩展，.ipynb 文件会以普通 JSON 格式打开，毫无执行能力。
- 启动 VSCode 后，点击左侧活动栏的扩展图标（或按
⇧⌘X/Ctrl+Shift+X） - 在搜索框中输入
Jupyter，认准发布者是 Microsoft、ID 为ms-toolsai.jupyter的那一项 - 点击“安装”，完成后必须重启 VSCode——跳过这步会导致内核选择器不显示、右上角无 Kernel 下拉菜单
- 重启后，打开任意
.ipynb文件，应立即看到顶部工具栏和单元格左侧出现 ▶ 按钮
为什么装了还看不到内核选择器或 ▶ 按钮？
常见现象：扩展已安装、VSCode 已重启，但打开 .ipynb 文件后右上角没有 “Select Kernel”，单元格左侧无运行按钮，Shift+Enter 无响应。
- 最可能原因：
Python扩展未启用，或未正确识别解释器——Jupyter 扩展依赖它提供环境列表 - 检查底部状态栏是否显示 Python 解释器路径（如
Python 3.11.9 (/usr/bin/python3)），没显示就说明Python: Select Interpreter没成功执行 - 即使解释器已选，Jupyter 扩展仍需
ipykernel实例注册为可用内核；仅装jupyter包不够，必须运行python -m ipykernel install --user --name myenv --display-name "Python (myenv)" - 路径含空格或中文会导致
ipykernel install静默失败，建议用纯英文路径创建 conda 或 venv 环境
装完扩展后第一件事：验证内核是否就绪
别急着写代码，先确认基础链路通不通。一个有效且快速的验证方式是直接运行诊断语句，而不是看界面有没有按钮。
- 新建空白
.ipynb文件，插入一个代码单元格 - 输入：
import sys; print(sys.executable) - 按
Shift+Enter运行，观察输出路径是否指向你预期的环境（比如~/miniconda3/envs/ds-env/bin/python） - 如果报错
ModuleNotFoundError: No module named 'ipykernel'，说明该环境没装ipykernel，需先激活环境再运行pip install ipykernel - 如果输出路径是系统 Python（如
/usr/bin/python3），说明内核没切换成功，要重新点击右上角 Kernel 选择器，手动选中你注册的那个Python (myenv)
真正卡住人的地方往往不是“怎么装”，而是装完后没意识到：Jupyter 扩展只负责界面和通信，实际执行靠的是你本地某个 Python 环境里的 ipykernel 实例——它必须存在、可调用、且路径干净。任何一环出问题，都会表现为“按钮灰掉”或“输出区空白”。
