VS Code中Jupyter Notebook无法运行：Kernelspec与ZMQ库DLL报错问题

先解决ZMQ DLL依赖错误 #

ZMQ相关的DLL报错通常是依赖缺失或版本不兼容导致的，按以下步骤排查：

• 卸载并重装pyzmq：
  先执行pip show pyzmq查看当前版本，然后卸载：pip uninstall -y pyzmq，再重装稳定版本：pip install pyzmq==25.1.1（该版本兼容性较好，也可尝试最新稳定版）
• 检查系统环境变量PATH：
  确保Python安装目录下的Scripts文件夹，以及Lib\site-packages\zmq目录被添加到系统PATH中。Windows用户可通过「系统属性-高级-环境变量」修改；Linux/macOS用户可在~/.bashrc或~/.zshrc中添加路径
• 安装VC++ Redistributable运行库：
  Windows系统下ZMQ依赖微软VC运行库，直接下载安装对应版本的VC Redistributable（推荐2019或2022版），安装后重启电脑再测试

修复Kernelspec配置异常 #

内核配置异常多因内核注册信息损坏或VS Code配置错误导致：

• 重置Python内核：
  执行jupyter kernelspec list查看所有已注册内核，找到异常内核名称后执行jupyter kernelspec remove <kernel-name>删除，再重新注册内核：python -m ipykernel install --user
• 恢复VS Code Jupyter扩展默认设置：
  打开VS Code设置（Ctrl+,），搜索Jupyter: Kernel Spec Path，点击右侧重置按钮恢复默认路径配置
• 清除Jupyter缓存：
  打开命令面板（Ctrl+Shift+P），输入Jupyter: Clear Jupyter Cache并执行，完成后重启VS Code

综合排查步骤 #

• 确认VS Code使用的Python解释器：点击VS Code左下角的Python版本标识，切换到目标虚拟环境或全局环境，再重新打开Jupyter Notebook文件
• 新建干净虚拟环境测试：
  创建虚拟环境：python -m venv jupyter-env
  激活环境（Windows：jupyter-env\Scripts\activate；Linux/macOS：source jupyter-env/bin/activate）
  安装依赖：pip install jupyter ipykernel pyzmq
  在VS Code中选择该新环境的内核，测试是否正常运行

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