You need to enable JavaScript to run this app. 新装Anaconda后Jupyter Notebook无法启动 触发zmq导入报错
优惠活动
大模型
产品
解决方案
定价
更多

新装Anaconda后Jupyter Notebook无法启动 触发zmq导入报错

问题现象

安装Anaconda后尝试启动Jupyter Notebook时,所有常规启动方式(命令行启动、桌面快捷方式启动)均报错退出,核心报错堆栈翻译如下:

Traceback (most recent call last):
  文件 "C:\Users\Avi\anaconda3\Scripts\jupyter-notebook-script.py" 第6行模块
    加载 notebook.notebookapp 模块的 main 入口函数
  文件 "C:\Users\Avi\anaconda3\lib\site-packages\notebook\notebookapp.py" 第51行模块
    从 zmq.eventloop 导入 ioloop 模块
  文件 "C:\Users\Avi\AppData\Roaming\Python\Python38\site-packages\zmq\__init__.py" 第47行模块
    从 zmq 包导入 backend 后端模块
  文件 "C:\Users\Avi\AppData\Roaming\Python\Python38\site-packages\zmq\backend\__init__.py" 第40行模块
    触发异常重抛逻辑
  文件 "C:\Users\Avi\AppData\Roaming\Python\Python38\site-packages\zmq\utils\sixcerpt.py" 第34行方法
    抛出捕获的原始异常
  文件 "C:\Users\Avi\AppData\Roaming\Python\Python38\site-packages\zmq\backend\__init__.py" 第27行模块
    自动选择匹配的zmq后端实现
  文件 "C:\Users\Avi\AppData\Roaming\Python\Python38\site-packages\zmq\backend\select.py" 第28行方法
    动态导入选中的后端模块
  文件 "C:\Users\Avi\AppData\Roaming\Python\Python38\site-packages\zmq\backend\cython\__init__.py" 第6行模块
    导入constants、error、message、context等内置组件
ImportError: 无法从已部分初始化的 zmq.backend.cython 模块中导入 constants 组件(大概率由循环导入导致)
错误指向模块路径:C:\Users\Avi\AppData\Roaming\Python\Python38\site-packages\zmq\backend\cython\__init__.py
根因分析

报错本质和Jupyter本身配置、启动方式无关,核心是Python 模块导入优先级错位:
Windows 环境下 Python 解析第三方包时,会优先加载当前用户漫游目录 C:\Users\Avi\AppData\Roaming\Python\Python38\site-packages 下的内容,这个路径留存了你之前安装独立 Python3.8 时部署的旧版 pyzmq 包,和 Anaconda 内置的 Jupyter 配套组件版本不兼容,最终触发循环导入、组件加载失败。
此前网上的重装Jupyter、修改系统环境变量、切换启动方式等方案无法生效,正是因为没有定位到这个跨环境的冲突包路径。

修复步骤
  • 打开系统开始菜单,启动 Anaconda Prompt(请勿使用普通命令提示符)
  • 清理冲突路径下的异常pyzmq包
    执行卸载命令:
    pip uninstall -y pyzmq
    若执行后提示找不到pyzmq包,直接手动打开路径 C:\Users\Avi\AppData\Roaming\Python\Python38\site-packages,删除所有文件名包含 zmq、pyzmq 的文件夹即可。
  • 强制重装Anaconda环境内的兼容组件
    在Anaconda Prompt中执行:
    conda install --force-reinstall pyzmq notebook jupyter_client
    等待conda完成组件校验、重装全流程。
  • 验证路径修正效果
    执行命令检查当前zmq包的实际加载路径:
    python -c "import zmq; print(zmq.__file__)"
    正常输出应为类似 C:\Users\Avi\anaconda3\lib\site-packages\zmq\__init__.py 的路径,不再指向AppData下的用户漫游目录。
  • 验证启动效果
    在Anaconda Prompt中执行 jupyter notebook,确认可以正常拉起浏览器访问Jupyter页面即修复完成。

内容的提问来源于stack exchange,提问作者Avi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 10:45:05