如何在PyPy3上安装OpenCV？编译安装时Python.h缺失报错求助

一、PyPy3安装OpenCV的两种可行方式 #

• 先试试预编译包：虽然官方opencv-python没有专门针对PyPy的wheel，但可以尝试安装无头版本（无需GUI支持），执行命令：

  pypy3 -m pip install opencv-python-headless
  

  如果这个命令能成功，那是最省事的方式。
• 如果预编译包安装失败，就只能走源码编译路线，这也是你正在尝试的方式，但需要配置好依赖和编译参数。

二、编译报错Python.h: No such file or directory的解决办法 #

报错原因解析 #

你遇到的这个问题，核心是编译器找不到PyPy3的Python.h头文件。PyPy的头文件位置和CPython不同，默认情况下CMake会自动查找系统里的CPython头文件；另外如果没安装PyPy的开发包，头文件本身就不在系统路径中。

一步步解决问题 #

1. 安装PyPy3的开发依赖包
   针对Debian/Ubuntu这类系统，直接执行：

   sudo apt-get install pypy3-dev
   

   这个包会把PyPy3的Python.h和其他开发所需的头文件、库文件安装到系统路径里，编译器就能自动定位到它了。

2. 编译时明确指定PyPy3环境
   源码编译时，必须告诉CMake咱们要用的是PyPy3而非默认的CPython。你可以直接在执行setup.py时传递参数：

   pypy3 setup.py install -DPYTHON_EXECUTABLE=$(which pypy3) -DCMAKE_PREFIX_PATH=$(pypy3 -c "import sys; print(sys.prefix)")
   

   或者拆分步骤，先配置CMake再编译，逻辑更清晰：

   # 创建编译目录并进入
   mkdir build && cd build
   # 配置CMake，指定PyPy3的路径
   cmake .. -DPYTHON_EXECUTABLE=$(which pypy3) -DCMAKE_PREFIX_PATH=$(pypy3 -c "import sys; print(sys.prefix)")
   # 并行编译（nproc是CPU核心数，加快编译速度）
   make -j$(nproc)
   # 完成安装
   make install
   

3. 手动指定头文件路径（备用方案）
   如果上面的方法仍不生效，可以先自行定位PyPy3的Python.h位置：

   find $(pypy3 -c "import sys; print(sys.prefix)") -name Python.h
   

   假设找到的路径是/usr/lib/pypy3/include/Python.h，编译时直接给编译器添加这个路径：

   pypy3 setup.py install -DCMAKE_CXX_FLAGS="-I/usr/lib/pypy3/include"
   

4. 补全OpenCV编译的基础依赖
   要是还出现其他编译报错，可能是缺了OpenCV编译必需的系统库，执行下面的命令补全：

   sudo apt-get install build-essential cmake git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
   

按照上面的步骤操作，应该就能解决编译时找不到Python.h的问题，顺利在PyPy3环境下安装好OpenCV了。

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