VSCode 的 Jupyter 功能需正确配置 Python 解释器并手动注册 ipykernel；先通过“Python: Select Interpreter”指定 conda/virtualenv 环境，再在该环境运行 python -m ipykernel install 注册 kernel，否则 kernel 启动失败或显示“no kernel found”。
VSCode 本身不内置 Jupyter 支持，必须通过扩展和 Python 环境协同工作；直接装完 Python 扩展就开 notebook，大概率卡在 kernel 启动失败或 ModuleNotFoundError。
安装 Python 和 Jupyter 扩展前先确认 Python 环境是否可用
VSCode 的 Jupyter 功能严重依赖你本地的 Python 解释器路径和包环境。如果用的是 conda 或 virtualenv，VSCode 必须明确指向该环境下的 python 可执行文件，而不是系统默认的。
- 打开 VSCode，按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter，从列表中选中带env、conda或明确路径的解释器（如~/miniconda3/envs/ml/bin/python） - 在终端中运行
which python（macOS/Linux）或where python（Windows），确认路径与 VSCode 中选中的一致 - 在该环境下手动运行
pip list | grep jupyter，确保已安装jupyter、ipykernel—— 仅装jupyter不够，ipykernel是 VSCode 启动 kernel 的关键
手动注册 kernel 避免“no kernel found”错误
VSCode 不会自动发现所有已安装的 kernel，尤其当你用 pip install jupyter 在非 base conda 环境里安装时，kernel 往往未注册到 Jupyter 的全局配置中。
- 激活目标环境（如
conda activate ml或source venv/bin/activate） - 运行
python -m ipykernel install --user --name ml --display-name "Python (ml)"，其中--name是唯一标识符，--display-name是 VSCode 内显示的名称 - 重启 VSCode，新建
.ipynb文件后点击右上角 kernel 选择器，应能看到Python (ml) - 若仍不出现，检查
jupyter kernelspec list输出，确认ml在列表中；若不在，说明注册失败，常见原因是没激活对的环境
启动 notebook 卡在“Connecting to kernel…”的典型原因
这不是 VSCode 崩溃，而是 kernel 进程启动失败但无明显报错。多数情况与端口、权限或包冲突有关。
- 关闭其他正在运行的 Jupyter 服务（如本地
jupyter notebook或jupyter lab进程），它们可能占用了同一端口或共享 socket 文件 - 在 notebook 单元格中运行
import sys; print(sys.executable)，核对输出路径是否与你在 VSCode 中选中的 interpreter 一致 —— 不一致说明 kernel 没走对环境 - 某些安全软件（尤其是 Windows Defender 实时防护）会拦截
ipykernel子进程，临时禁用可验证 - 若使用 M1/M2 Mac，且 kernel 是 x86 构建的，而 VSCode 是 arm64 版本，会出现静默失败，此时需统一架构（推荐全 arm64）
数据分析常用插件与轻量替代方案
除了官方 Python 扩展，几个小而关键的补充能显著提升体验，但别盲目全装：
-
Jupyter扩展（Microsoft 官方）：必须，提供 notebook 编辑、变量查看器、plot 渲染等核心能力 -
Python Docstring Generator：写pandas、sklearn函数时自动生成 docstring，省去查文档时间 -
Bracket Pair Colorizer（新版 VSCode 已内置）：嵌套多层df.groupby(...).agg({...}).reset_index()时快速定位括号匹配 - 避免装
Code Runner来运行 .ipynb —— 它不支持 cell 执行、变量持久化和 plot 显示，纯属干扰项
真正卡住的往往不是“怎么装”，而是 kernel 注册路径和解释器绑定没对齐；一个 jupyter kernelspec list 和一个 Python: Select Interpreter 对不上，后面所有操作都在假环境中运行。
