Mac M1环境安装YOLOX依赖pycocotools失败，求解决方案
2026-8-4
解决YOLOX安装时pycocotools失败的问题
一、先解决「找不到Python.h」的核心问题
这个错误源于缺少Python开发依赖（头文件与编译库），按以下步骤补全：
- 找到Python 3.9的安装程序（已安装的话，可在Python安装目录找到
Modify.exe，或重新下载Python 3.9官方安装包） - 选择「Modify」（修改）选项，在可选功能列表里勾选包含Python开发工具、头文件、库文件的选项（通常标注为「Python development」），完成安装
- 验证：检查Python安装路径下的
include文件夹，确认Python.h存在（例如C:\Python39\include\Python.h）
二、直接安装适配Windows的pycocotools版本
无需手动下载whl文件，直接用pip安装专为Windows适配的包：
- 执行命令：
pip install pycocotools-windows - 若网络缓慢，可使用国内源加速：
pip install pycocotools-windows -i https://pypi.tuna.tsinghua.edu.cn/simple
三、手动编译安装（上述方法无效时）
需先配置C++编译环境：
- 安装Visual Studio Build Tools，选择「Desktop development with C++」工作负载，确保勾选MSVC编译器、Windows SDK等核心组件
- 获取pycocotools的Windows适配源码，解压后进入
PythonAPI目录 - 执行命令编译安装：
python setup.py install
四、通过conda环境绕过编译问题
若pip安装始终报错，用conda管理环境规避编译环节：
- 创建并激活虚拟环境：
conda create -n yolox_env python=3.9 -y conda activate yolox_env - 从conda-forge安装pycocotools：
conda install -c conda-forge pycocotools -y - 再安装YOLOX：
pip install yolox
内容的提问来源于stack exchange，提问作者Patrick
相关产品推荐
相关产品推荐
