求助：在GitHub Action的cibuildwheel中构建依赖libass/jsoncpp的Cython模块

核心问题定位 #

你的构建失败本质是GitHub Action的容器环境默认未预装libass和libjsoncpp依赖，导致编译时找不到头文件（Linux）或链接库（Windows）。下面分平台给出针对性配置修改：

1. 修改GitHub Action构建配置（build_wheel.yml） #

需要在各平台的预构建阶段安装依赖库：

Linux 平台配置 #

在cibuildwheel的Linux规则中添加包安装命令：

jobs:
  build_wheels:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pypa/cibuildwheel@v2.16.5
        env:
          CIBW_LINUX_PRE_BUILD: "apt-get update && apt-get install -y libass-dev libjsoncpp-dev"

Windows 平台配置 #

利用vcpkg安装预编译的依赖库（cibuildwheel原生支持vcpkg）：

jobs:
  build_wheels:
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pypa/cibuildwheel@v2.16.5
        env:
          CIBW_WINDOWS_PRE_BUILD: "vcpkg install libass:x64-windows jsoncpp:x64-windows && set VCPKG_ROOT=C:\\vcpkg"

2. 修改setup.py的依赖路径配置 #

需要根据系统平台动态指定头文件和库文件路径，确保编译器能找到依赖：

from setuptools import setup, Extension
import sys
import os

include_dirs = []
library_dirs = []
libraries = ["ass", "jsoncpp"]

# 针对Windows平台（vcpkg安装路径）
if sys.platform == "win32":
    vcpkg_root = os.environ.get("VCPKG_ROOT", "C:\\vcpkg")
    arch = "x64"
    include_dirs.append(os.path.join(vcpkg_root, "installed", f"{arch}-windows", "include"))
    library_dirs.append(os.path.join(vcpkg_root, "installed", f"{arch}-windows", "lib"))
# 针对Linux平台（系统默认安装路径）
elif sys.platform.startswith("linux"):
    include_dirs.append("/usr/include")
    library_dirs.append("/usr/lib/x86_64-linux-gnu")

# 定义C++扩展模块
test_module = Extension(
    "testmodule",
    sources=["testmodule.cpp"],
    include_dirs=include_dirs,
    library_dirs=library_dirs,
    libraries=libraries,
    extra_compile_args=["-std=c++11"] if not sys.platform == "win32" else []
)

setup(
    name="testmodule",
    version="0.1",
    ext_modules=[test_module],
)

3. 验证C++代码的头文件引用 #

确保testmodule.cpp中的头文件路径与依赖库的安装结构一致：

// 正确引用libass和jsoncpp的头文件
#include <ass/ass.h>
#include <json/json.h>

如果jsoncpp的头文件路径是jsoncpp/json.h，需要同步修改代码中的引用，或在setup.py的include_dirs中添加jsoncpp的父目录路径。

内容的提问来源于stack exchange，提问作者Efraín