Windows环境下安装cython_bbox报错，求解决方法

错误根源 #

这类报错核心是缺少Windows平台的C/C++编译环境：io.h是微软UCRT（通用C运行时）的核心头文件，cl.exe是MSVC编译器，必须依赖完整的Visual Studio构建工具链才能正常调用。

解决方法 #

方法1：安装Visual Studio构建工具 #

• 下载Visual Studio Installer，选择**“使用C++的桌面开发”**工作负载，务必勾选以下组件：
  • MSVC v14x 生成工具（Python 3.10推荐v142及以上版本）
  • Windows SDK（选择与当前系统匹配的版本，如Windows 10/11对应SDK）
• 安装完成后，打开对应架构的开发者命令提示符（Python为64位则打开“x64 Native Tools Command Prompt for VS 2022”）
• 在该命令提示符中激活Python虚拟环境，重新执行安装命令：

  pip install -e git+https://github.com/samson-wang/cython_bbox.git#egg=cython-bbox
  

方法2：用预编译wheel包跳过编译 #

• 找到对应Python 3.10（cp310）、Windows 64位（win_amd64）的cython_bbox wheel文件
• 直接通过pip安装本地wheel包：

  pip install cython_bbox-0.1.3-cp310-cp310-win_amd64.whl
  

方法3：手动配置编译环境变量 #

• 定位Visual Studio安装路径下的MSVC和Windows SDK目录（以VS 2022 Community版为例）：
  • 将MSVC的bin目录添加到系统PATH：C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.36.32532\bin\Hostx64\x64
  • 将MSVC和Windows SDK的include目录添加到系统INCLUDE：

    C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.36.32532\include
    C:\Program Files (x86)\Windows Kits\10\Include\10.0.22621.0\ucrt
    

• 配置完成后重启命令行，激活虚拟环境再执行安装命令

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