VS Code使用Jupyter Notebook报Python 3.7.8缺ipykernel装后仍失效求助
已完成ipykernel安装仍触发「Python 3.7.8 requires ipykernel to be installed」报错的排查步骤
对应触发原因与处理方案
1. 安装路径与当前选中的内核环境不匹配
这是最高发的触发原因:弹窗引导的安装操作,默认调用系统全局Python的pip,而非当前在VS Code中选中的3.7.8内核对应的解释器,实际ipykernel根本没装到当前使用的环境里。
- 先确认Jupyter面板顶部/VS Code右下角显示的当前选中Python解释器的完整绝对路径,例如
D:\miniconda3\envs\py37\python.exe - 打开系统终端,直接调用这个完全匹配的解释器执行安装,不要图省事直接输全局
pip install ipykernel,参考命令格式:D:\miniconda3\envs\py37\python.exe -m pip install ipykernel
2. ipykernel版本与Python 3.7存在兼容性冲突
目前ipykernel 7.x及以上版本已终止对Python 3.7的支持,即便在对应环境下完成安装,VS Code的内核扫描逻辑会判定版本不兼容,触发未安装的误报。
- Python 3.7 可正常兼容的最高ipykernel版本为6.20.2,安装时需指定版本号,避免自动拉取最新的不兼容版本,参考命令:
对应解释器完整路径 -m pip install ipykernel==6.20.2
3. 内核未完成全局注册
部分场景下,ipykernel安装完成后未将对应环境的内核信息写入Jupyter的全局索引列表,会导致VS Code无法识别到已安装的组件。
- 执行内核注册命令,将当前3.7.8环境写入全局内核列表,参考命令:
对应解释器完整路径 -m ipykernel install --user --name py37 --display-name "Python 3.7.8 (本地环境)" - 注册完成后重启VS Code,在Jupyter内核选择列表中手动选中刚注册的内核,不要使用自动匹配的默认项
4. 扩展缓存导致误判
VS Code的Jupyter扩展存在本地缓存时,会沿用旧的内核校验结果,哪怕组件已经正常安装也会触发旧报错。
- 调出命令面板(快捷键
Ctrl+Shift+P),依次执行两个操作:- 执行
Jupyter: Clear Jupyter Server Output清空旧的服务运行日志 - 执行
Developer: Reload Window重载窗口刷新扩展校验逻辑
- 执行
- 如果使用远程连接/WSL模式运行Jupyter,需确认ipykernel是安装在远程端的对应环境中,而非本地Windows侧的Python环境,两侧环境属于完全隔离的状态
内容的提问来源于stack exchange,提问作者johnwow
相关产品推荐
相关产品推荐

