windows安装pycocotools问题处理

最新推荐文章于 2025-03-26 15:23:11 发布

爱在一瞬间

最新推荐文章于 2025-03-26 15:23:11 发布

阅读量2.1k

点赞数 2

分类专栏： python环境文章标签： windows python pip 深度学习

本文链接：https://blog.csdn.net/aizaiyishunjian/article/details/128776157

版权

python环境专栏收录该内容

4 篇文章

订阅专栏

项目中用到mmdetection、icevision等深度学习库，其中pycocotools这个依赖的安装，折腾了很久，直接看看遇到哪些问题了吧。

1.windows下直接安装pycocotools无法成功

pip install pycocotools这个安装直接报错，具体错误信息，还是需要源码安装时才能看到。

pip install pycocotools-windows这个库时可以直接安装成功的。安装成功后，部分依赖pycocotools的库是可以正常运行的，但是类似icevision这样的库，无法识别这个库，因此无法正常安装icevision。

2.pycocotools源码安装问题

2.1 C++编译环境类问题

这一类问题主要涉及C++编译环境的配置，包括（以下所列所在路径均依据windows kit和VS2019安装位置会有所改变）

include路径查找不到指定的头文件
1. io.h:cannot open include file: io.h’: no such file or directory
  所在路径：C:\Program Files (x86)\Windows Kits\10\Include\10.0.17763.0\ucrt
2. bsetsd.h:cannot open include file: ‘basetsd. H’: no such file or directory
  所在路径：C:\Program Files (x86)\Windows Kits\10\Include\10.0.17763.0\shared
找不到指定的链接库lib
1. Kernel32.lib: link: fatal error LNK1104: cannot open file ‘Kernel32.Lib’
  所在路径：C:\Program Files (x86)\Windows Kits\10\Lib\10.0.17763.0\um\x64
2. ucrt.lib: link: fatal error LNK1104: cannot open file ‘ucrt.lib’
  所在路径：C:\Program Files (x86)\Windows Kits\10\Lib\10.0.17763.0\ucrt\x64
找不到可执行应用
1. cl.exe:error: command ‘cl.exe’ failed: No such file or directory
  所在路径：D:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.29.30133\bin\Hostx86\x64
  处理方法：cl.exe所在路径添加到系统环境变量
2. rc.exe:fatal error LNK1158: cannot run ‘rc.exe‘
  所在路径：C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x64
  处理方法：复制win10 SDK rc.exe和rcdll.dll到VS目录下，具体目录可以根据错误提示推断，link.exe所在目录

error: Unable to find vcvarsall.bat错误解决方式
处理方法：
找到以下文件夹的文件（python安装路径）：D:\Python37\Lib\distutils\ _msvccompiler.py,设置best_dir文件路径

def _find_vcvarsall(plat_spec):
    # bpo-38597: Removed vcruntime return value
    _, best_dir = _find_vc2017()
    # 手动设置vcvarsall.bat查找路径
    best_dir = r"C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Auxiliary\Build"
    if not best_dir:
        best_version, best_dir = _find_vc2015()

    if not best_dir:
        log.debug("No suitable Visual C++ version found")
        return None, None

    vcvarsall = os.path.join(best_dir, "vcvarsall.bat")
    if not os.path.isfile(vcvarsall):
        log.debug("%s cannot be found", vcvarsall)
        return None, None

    return vcvarsall, None

关于C++编译环境的配置，主要涉及的就是windows kit和MSVC的安装和配置。这个可以通过安装VS中C++相关的编译组件和windows 10 SDK解决。安装完成后，由于环境变量设置和setup.py中默认的查找位置，可能出现头文件和链接库等无法查找到的问题，这时可以通过以下几种方式解决：

把头文件或者链接库所在路径添加到系统环境变量。
把头文件所在路径添加到setup.py文件中的include_dirs参数中。
把链接库或可执行程序直接拷贝到报错信息提示的查找路径中。

2.2 pycocotools包自身问题

cocoapi官方实现：提供了lua\matlab\python操作coco数据集的API，但不支持windows环境使用。
pycocotools实现库：从cocoapi官方库fork过来，支持windows下使用，但是可能由于环境问题，无法直接安装成功。
pycocotools-windows实现库：同样从cocoapi官方库fork过来，支持windows下使用，大部分情况下可以直接安装使用。但是2.0.0.2版本之后不再更新，导致安装之后，不满足部分依赖库的要求，无法使用。

使用pycocotools实现库安装，只要解决了C++生成环境的相关问题，基本就能正常安装成功。
如果出现以下两个错误，可以检查以下setup.py文件中common文件配置的相对路径是否能够正确找到对应问题：
1. fatal error C1083: 无法打开源文件: “../common/maskApi.c”: No such file or directory
2. fatal error C1083: 无法打开源文件: “../common/_mask.c”: No such file or directory

源码安装命令与普通包安装有所不同

 # build_ext:build C/C++ extensions (compile/link to build directory)，给python编译一个c、c++的拓展
 # ignore build-lib and put compiled extensions into the source directory alongside your pure Python modules，忽略build-lib，将编译后的扩展放到源目录中，与纯Python模块放在一起
 python setup.py build_ext --inplace
 python setup.py build_ext install