vscode中使用jupyter notebook时,出现The kernel failed to start due to the missing module ‘ipykernel_launcher’的错误

我的出错场景
windows11 + vscode + jupyter notebook插件 + python3.12.7

在学习使用gradio时,使用python3.12.7作为默认python环境,使用vscode jupyter插件和ipynb文件形式,

使用pip install gradio之后, 在ipynb文件中,import gradio运行失败。

运行代码, 提示:The kernel failed to start due to the missing module ‘ipykernel_launcher’,无法正常运行最简单示例。

而换用干净的venv虚拟环境,再次安装gradio包后,可以正常跑demo示例。

报错: The kernel failed to start due to the missing module ‘ipykernel_launcher’

原因
python全局环境中安装了太多杂七杂八的包, 全局环境紊乱。

解决方案(个人方案)

1.使用pip freeze > 该卸载依赖.txt 导出已经下载的包

2.使用pip uninstall -r 该卸载依赖.txt -y 卸载全局所有不必要的库包

3.使用 python -m pip install ipykernel -U --force-reinstall 重新在全局安装好ipynb内核

  1. 最后使用pip install -r 该安装依赖.txt, 也即pip install gradio

经测试,这样子全局清理,安装后,也是可以在 ipynb文件内正常跑gradio demo示例了;

不过, 还是建议python全局依赖包保持空白或者尽量干净,因为这个错误主要由于全局安装太多包,依赖混乱导致的。
在这里插入图片描述

总结

  1. 使用venv分项目管理python环境依赖包,有必要保证全局环境干净
  2. 为每个项目单独设置venv环境,避免全局环境混乱

附1 windows下创建Python venv虚拟环境

python -m venv <虚拟环境名> # 创建虚拟环境
.\<虚拟环境名>\Scripts\activate.bat # 激活虚拟环境
pip install -r requirements.txt # 安装项目所需的依赖# 巴拉巴拉......,使用结束....
.\<虚拟环境名>\Scripts\deactivate.bat # 退出虚拟环境
Logo

腾讯云面向开发者汇聚海量精品云计算使用和开发经验,营造开放的云计算技术生态圈。

更多推荐