VSCode交互式窗口报错：No module named ipykernel_launcher 安装ipykernel失败

问题描述 #

启动VSCode交互式窗口时，系统提示需安装ipykernel，无论通过VSCode自动安装还是手动执行pip install ipykernel，均出现以下报错：

ERROR: Could not find a version that satisfies the requirement ipykernel (from versions: none)
ERROR: No matching distribution found for ipykernel

解决方案 #

• 切换pip镜像源
  国内网络环境下，默认PyPI源可能访问不稳定，导致无法检索到ipykernel包。使用国内镜像源重新安装：

  pip install ipykernel -i https://pypi.tuna.tsinghua.edu.cn/simple
  

• 确认Python环境一致性
  确保终端使用的Python环境与VSCode选中的python_ari环境一致：

  1. 在VSCode状态栏查看当前选中的Python解释器路径
  2. 在终端执行which python（Linux/macOS）或where python（Windows），对比路径是否匹配
  3. 若不匹配，切换到对应环境（如虚拟环境执行conda activate python_ari）后再执行安装命令

• 升级pip版本
  老旧版本pip可能存在包索引兼容问题，先升级pip：

  python -m pip install --upgrade pip
  

  升级完成后重新执行pip install ipykernel

• 检查Python版本兼容性
  ipykernel要求Python 3.8及以上版本支持最新稳定版。若你的Python版本过低，先升级Python至符合要求的版本，再进行ipykernel安装

内容的提问来源于stack exchange，提问作者Adri de Riv