使用GitHub安装Google Colab时pyzmq编译Wheel失败求助

问题描述 #

安装Google Colab时，google.colab包构建成功，但pyzmq源码编译失败，核心报错信息如下：

Building wheel for pyzmq (pyproject.toml) ... error
error: subprocess-exited-with-error

× Building wheel for pyzmq (pyproject.toml) did not run successfully.
│ exit code: 1
╰─> [431 lines of output]

error: command 'F:\\Microsoft Visual Studio\\2022\\Community\\VC\\Tools\\MSVC\\14.39.33519\\bin\\HostX86\\x64\\cl.exe' failed with exit code 2
    [end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for pyzmq
Successfully built google.colab
Failed to build pyzmq
ERROR: Could not build wheels for pyzmq, which is required to install pyproject.toml-based projects

解决方案 #

• 强制安装预编译wheel包
  跳过本地源码编译环节，直接使用预编译的二进制包：
  pip install pyzmq --only-binary :all:

• 修复Visual Studio编译环境
  若必须从源码编译，确保C++开发组件完整：

  • 打开Visual Studio Installer，勾选「桌面开发与C++」组件，包含MSVC编译器、Windows SDK等必要工具
  • 启动x64 Native Tools Command Prompt for VS 2022，在该命令行环境下重新执行安装命令，保证编译器环境变量正确加载

• 降级pyzmq版本
  尝试安装兼容性更稳定的旧版本：
  pip install pyzmq==25.1.2

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