VS Code已安装ipykernel仍无法运行Jupyter Notebook，反复提示需安装ipykernel

该报错本质是VS Code 为 Jupyter Notebook 选中的内核解释器，和你执行 pip 安装 ipykernel 时所用的 Python 环境完全不匹配，并非 ipykernel 真的未安装。你提到 .py 文件可正常运行，大概率是 VS Code 的全局Python选择、工作区Python选择、Jupyter内核选择三者存在路径偏差。

可落地的排查解决步骤 #

• 第一步：核对两个场景的解释器路径
  • 打开任意一个可正常运行的 .py 文件，在 VS Code 左下角状态栏查看当前选中的 Python 解释器完整路径，记录下来（例如 C:\Python39\python.exe、D:\projects\myenv\Scripts\python.exe 或 Conda 环境路径）
  • 再打开任意 .ipynb 文件，查看右上角 Jupyter 内核选择栏的解释器路径，和上面记录的路径做比对，二者不一致是最常见的触发原因
• 第二步：给Jupyter 内核对应的目标解释器单独安装 ipykernel
  • 不要直接用全局终端执行 pip install ipykernel，避免 pip 指向的 Python 和目标解释器不是同一个：
    • 如果是 venv 虚拟环境：先在终端激活对应环境，Windows 执行 .\你的虚拟环境目录\Scripts\activate，macOS/Linux 执行 source 你的虚拟环境目录/bin/activate，再运行 pip install ipykernel
    • 如果是 Conda 环境：先执行 conda activate 你的环境名，再运行 pip install ipykernel
    • 如果是系统全局 Python：直接调用目标解释器的绝对路径执行安装，例如 C:\Python39\python.exe -m pip install ipykernel
• 第三步：手动验证 ipykernel 安装有效性
  • 激活对应目标环境后，执行命令 python -m ipykernel --version，如果能正常输出版本号，说明安装配置正确；如果报错找不到模块，就是环境路径选错了
• 第四步：清除残留的 Jupyter 插件缓存
  • 此前重装插件、降级版本无效的常见原因是旧缓存未被清除：
    • 按下 Ctrl+Shift+P 调出命令面板，依次执行 Jupyter: Clear All Output、Developer: Reload Window
    • 重载完成后重新打开 .ipynb 文件，手动选择正确的 Python 内核
• 第五步：远程/WSL 场景补充排查
  • 如果是在 WSL、SSH 远程连接场景下使用，需要确认远程侧环境已经对应安装了 ipykernel，本地环境的安装操作不会同步到远程运行环境

注：你之前执行的强制重装 ipykernel、重装 VS Code 插件操作之所以无效，是因为所有操作的目标环境和 Notebook 实际调用的运行环境不匹配，并非插件或安装包本身损坏。

内容的提问来源于stack exchange，提问作者Rachit