VS Code运行IPython Notebook报错Bad File descriptor求助

问题详情 #

• VS Code基于Python 3.12.3全局内核自动创建.venv虚拟环境
• 环境已安装jupyter等必要依赖
• 通过pip3安装pandas后，尝试运行任意Notebook单元格时触发内核崩溃错误

错误日志 #

22:14:06.516 [error] Error in execution Error: The kernel died. Error: Bad file descriptor (C:\Users\runneradmin\AppData\Local\Temp\tmpw8fxpxar\build_deps\bundled_libzmq-src\src\epoll.cpp:73)... View Jupyter log for further details.

注：本地系统中不存在C:\Users\runneradmin路径

已尝试的修复操作 #

• 执行过pip install -U jupyter等各类网上的升级修复命令
• 卸载并重装Python 3.12.3环境
• 切换全局环境与虚拟环境，手动激活虚拟环境后重试

解决方案 #

1. 降级pyzmq版本 #

该错误源于pyzmq在Windows+Python 3.12环境下的兼容性问题，执行以下命令修复：

pip uninstall -y pyzmq
pip install pyzmq==25.1.2

2. 手动指定虚拟环境内核 #

• 打开VS Code命令面板（Ctrl+Shift+P），输入Jupyter: Select Kernel
• 选择Python Environments...，找到本地.venv虚拟环境并选中
• 重启VS Code后重新运行Notebook单元格

3. 手动创建并配置虚拟环境 #

禁用VS Code自动激活虚拟环境的设置，手动创建环境：

1. 打开VS Code设置，搜索python.terminal.activateEnvironment，设置为false
2. 在终端执行命令创建并激活环境：

# 创建虚拟环境
python -m venv .venv
# Windows激活命令
.venv\Scripts\activate
# 安装依赖
pip install jupyter pandas

3. 重新选择该虚拟环境作为Jupyter内核

4. 降级Python版本 #

Python 3.12与部分Jupyter生态依赖的兼容性尚未完全稳定，可降级至Python 3.11.x版本，重新创建虚拟环境并安装依赖后重试。

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