Spyder使用自定义Python解释器时内核启动报错如何解决

解决步骤 #

1. 匹配Spyder与spyder-kernels版本

你之前安装的spyder-kernels==2.1.*可能和你当前使用的Spyder主程序版本不匹配，这是自定义解释器内核启动失败最常见的原因：

• 打开默认解释器下能正常运行的Spyder，点击顶部菜单栏「帮助」→「关于Spyder」，记下Spyder的版本号（格式为X.Y.Z，比如5.4.3）
• 激活你的自定义Python环境，执行以下命令卸载已安装的不匹配版本：

pip uninstall spyder-kernels -y

• 按照版本对应规则安装匹配的spyder-kernels：Spyder 4.x对应spyder-kernels 1.x.，Spyder 5.x对应spyder-kernels 2.x.，且spyder-kernels的前两位版本号必须和Spyder的前两位版本号完全一致。比如Spyder 5.4.x就执行：

pip install spyder-kernels==2.4.*

2. 重新配置自定义解释器路径

• 打开Spyder，点击顶部菜单栏「工具」→「偏好设置」→「Python解释器」
• 勾选「使用以下Python解释器」，点击右侧浏览按钮，手动选择自定义环境的Python可执行文件：Windows下对应环境目录中的python.exe，macOS/Linux下对应环境目录中的bin/python，不要选择全局同名的Python文件
• 点击「应用」→「确定」后，完全关闭Spyder进程再重新启动，不要仅重启内核

3. 排查依赖冲突

如果以上操作后仍无法启动，检查自定义环境的依赖问题：

• 在激活的自定义环境终端执行：

pip check

• 按照返回的冲突提示修复依赖问题，也可以直接升级内核核心依赖：

pip install --upgrade ipykernel ipython jupyter_client

4. 手动注册内核（备选方案）

如果常规配置无效，可以手动给自定义环境注册Spyder可识别的内核：

• 激活自定义环境，执行以下命令，将命令中的自定义环境名替换为你自己的环境名称：

python -m ipykernel install --user --name 自定义环境名 --display-name "Spyder(自定义环境)"

• 重启Spyder后，在控制台右上角的内核选择下拉菜单中，选中刚才注册的「Spyder(自定义环境)」内核即可使用

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