必须先手动执行python: select interpreter选对解释器，否则.ipynb文件无法执行；右上角显示“python 3 (unavailable)”或内核为空，本质是所选解释器未安装或未注册ipykernel，需在该环境终端运行python -m pip install ipykernel及python -m ipykernel install --user --name envname --display-name "python (envname)"。
Python: Select Interpreter 必须先手动选对，否则 .ipynb 文件根本不会执行——VS Code 不会自动继承终端里的 conda activate 状态，也不会扫描项目下的 .venv。
右上角内核显示 “Python 3 (unavailable)” 或为空
这不是插件没装好，而是当前选中的 Python 解释器里没注册 ipykernel 内核。常见信号包括：状态栏没更新为所选路径、新建 .py 文件运行 import pandas 报错、或 python -m pip list 里查不到 ipykernel。
- 在 VS Code 内置终端（不是系统终端）中，确认已激活目标环境，再运行：
python -m pip list | grep ipykernel（macOS/Linux）或python -m pip list | findstr ipykernel（Windows） - 没输出？立刻执行：
python -m pip install ipykernel（避免混用conda install ipykernel，尤其在 pip 环境里） - 注册命令必须带
--user：python -m ipykernel install --user --name ds-env --display-name "Python (ds-env)"；--name不能含空格或特殊字符（如data science会静默失败） - 注册后路径固定在：
~/.local/share/jupyter/kernels/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\jupyter\kernels\（Windows），VS Code 只读这个位置
内核选得到但单元格执行失败，报 ModuleNotFoundError
说明 kernel 启动时加载的 Python 路径和你选的解释器不一致——本质是环境错位，不是包没装。
VSCode 1.118
下载
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 先在 notebook 里运行：
import sys; print(sys.executable)，对比它和左下角状态栏显示的路径是否完全一致 - 不一致？说明 kernel 绑错了。删掉对应内核目录（比如
rm -rf ~/.local/share/jupyter/kernels/ds-env），重新注册 - 别依赖全局
jupyter --version，要进目标环境终端验证：jupyter notebook --version和python -m ipykernel --version都得有输出 - 如果用了远程模式，检查设置里
jupyter.jupyterServerType是否被设为remote—— 关掉它，否则本地 kernel 直接被忽略
重启后内核仍不出现，或卡在 “Connecting to kernel…”
VS Code 1.118 版本之后，Jupyter 扩展启动更严格，首次连接可能因依赖加载慢而假死，但真正的问题往往藏在日志里。
- 打开输出面板（
Ctrl+Shift+U），选择Jupyter日志，搜Failed to start the kernel或No module named 'ipykernel' - 如果看到
ModuleNotFoundError: No module named 'matplotlib'这类提示，说明 kernel 启动时缺依赖——不是 notebook 缺，是 kernel 进程缺，得在目标环境里补装 - 不要反复点击“重试”，先关掉所有 notebook 标签页，执行
Developer: Reload Window（不是Reload Window命令），再重开文件 - 禁用自动安装可减少干扰：
jupyter.askForKernelRestart设为false，但需自己确保ipykernel已就位
python -m ipykernel install --user。
