MacOS下Python虚拟环境安装pyzmq失败求助：缺失Python.h

问题原因 #

报错里的fatal error: 'Python.h' file not found是因为系统缺少Python的开发依赖包——这个包包含编译Python扩展所需的头文件和库，pyzmq在本地编译时必须用到它。

分系统解决方案 #

macOS系统（报错显示clang++，大概率是该系统） #

• 若使用系统自带Python：
  安装Xcode命令行工具，执行：

  xcode-select --install
  

  安装完成后，回到激活的虚拟环境，重新执行pip install pyzmq。
• 若使用Homebrew安装的Python：
  重新安装对应版本的Python（确保包含开发组件），比如你用的是Python 3.11：

  brew reinstall python@3.11
  

  激活虚拟环境后再次尝试安装pyzmq。

Ubuntu/Debian类Linux系统 #

安装对应Python版本的开发包，比如你的虚拟环境用的是Python 3.10：

sudo apt-get install python3.10-dev

版本号必须和你虚拟环境的Python一致，安装完成后回到虚拟环境重新执行pip install pyzmq。

替代方案：安装预编译二进制包 #

如果不想处理编译依赖，可以直接让pip下载预编译好的wheel包，跳过本地编译：

1. 先升级pip到最新版：

   python -m pip install --upgrade pip
   

2. 安装pyzmq：

   python -m pip install pyzmq --only-binary :all:
   

小提示 #

你之前输入的安装jupyter命令里拼写错误，正确的命令是：

python -m pip install jupyter

内容的提问来源于stack exchange，提问作者kanra-san