cibuildwheel中CIBW_BEFORE_ALL不生效，无法找到pybind11模块求助

核心原因：环境隔离导致全局安装的pybind11未被构建环境识别 #

cibuildwheel会为每个目标Python版本创建独立的虚拟环境，你在before-all中执行的pip install pybind11是安装到了系统全局Python环境，而非每个wheel构建对应的虚拟环境里，因此构建时虚拟环境内找不到该模块。

解决方案 #

1. 改用before-build替代before-all #

before-build会在每个wheel的构建虚拟环境中执行命令，确保pybind11被安装到当前构建所用的Python环境中：

[tool.cibuildwheel]
before-build = "pip install pybind11"

2. 检查pyproject.toml配置位置 #

确认配置项位于[tool.cibuildwheel]节点下，而非其他无关section：

# 正确示例
[tool.cibuildwheel]
before-build = "pip install pybind11"
# 其他cibuildwheel配置...

3. 在setup.py中声明构建依赖 #

直接让setuptools自动管理pybind11的安装，无需依赖cibuildwheel的钩子：

from pybind11.setup_helpers import Pybind11Extension, build_ext
from setuptools import setup

setup(
    name="your_package_name",
    version="0.1.0",
    ext_modules=[
        Pybind11Extension(
            "your_module",
            ["src/your_code.cpp"],
            extra_compile_args=["-O3"],
        )
    ],
    cmdclass={"build_ext": build_ext},
    setup_requires=["pybind11>=2.10.0"],
)

4. 针对Linux环境使用系统包（可选） #

如果是Linux构建环境，可以优先安装系统级的pybind11包，避免虚拟环境隔离问题：

[tool.cibuildwheel]
before-all = """
    if [ "$(uname)" = "Linux" ]; then
        sudo apt-get update && sudo apt-get install -y python3-pybind11
    else
        pip install pybind11
    fi
"""

验证步骤 #

1. 查看GitHub Actions日志中before-build（或before-all）阶段的pip输出，确认pybind11安装成功
2. 检查构建时使用的Python路径，确认与安装pybind11的Python路径一致

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