Jupyter Kernel启动失败（listen EFAULT）及VS Code内核选择异常求助

一、重置VS Code的Jupyter端口配置 #

手动指定端口引发了地址解析错误，先恢复默认设置：

• 打开VS Code设置（快捷键Ctrl+,）
• 搜索jupyter.jupyterCommandLineArguments
• 删除"--port=9000"配置项，让Jupyter自动选择可用端口
• 重启VS Code

二、清理ZMQ残留进程与缓存 #

ZMQ地址错误多和端口占用、临时缓存损坏有关：

• 打开任务管理器（Windows）或活动监视器（Mac），结束所有包含python、jupyter、zmq的进程
• 删除Jupyter缓存目录：
  • Windows：删除%APPDATA%\jupyter\runtime文件夹
  • Mac/Linux：删除~/.jupyter/runtime文件夹

三、重新配置Anaconda环境内核 #

针对新环境加载卡住的问题，手动注册内核：

• 打开Anaconda Prompt，激活新环境：conda activate 你的新环境名称
• 安装必要依赖：

  conda install jupyter ipykernel -y
  

• 将环境注册为Jupyter内核：

  python -m ipykernel install --user --name 你的新环境名称 --display-name "Python (你的新环境名称)"
  

• 关闭Anaconda Prompt，回到VS Code重新尝试选择内核

四、排查端口占用（若仍出现ZMQ错误） #

如果重置后还是报Bad address，检查对应端口状态：

• Windows：执行netstat -ano | findstr :9003（替换为报错端口），找到PID后在任务管理器结束对应进程
• Mac/Linux：执行lsof -i :9003，找到进程后用kill -9 进程PID强制结束

技术背景说明 #

• zmq.error.ZMQError: Bad address：ZMQ绑定端口时遇到占用、临时端口文件损坏，导致无法建立IPC连接
• listen EFAULT: bad address：手动指定端口可能与系统预留端口冲突，或VS Code插件无法正确解析配置，恢复默认自动选端口即可解决
• 新环境加载卡住：多因环境未正确注册内核，或VS Code未识别Anaconda环境路径，手动注册可完成路径关联

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