虚拟环境中生成扩展模块文件名后缀的最优实现方式是什么？

核心问题根源 #

虚拟环境默认不会把python3-config复制到bin目录，直接调用python3-config会走系统路径，导致和当前激活的虚拟环境Python版本不匹配，拿到错误的扩展后缀。

替代方案（无需手动复制python3-config） #

1. 用当前虚拟环境的Python直接拿后缀 #

不用依赖python3-config，直接通过Python代码动态获取，版本绝对匹配：

import sysconfig
print(sysconfig.get_config_var('EXT_SUFFIX'))

构建脚本里可以用python -c执行这段代码提取值：

EXT_SUFFIX=$(python -c "import sysconfig; print(sysconfig.get_config_var('EXT_SUFFIX'))")

2. 用python -m sysconfig提取配置 #

sysconfig支持命令行输出所有配置变量，过滤出后缀即可：

EXT_SUFFIX=$(python -m sysconfig | awk '/EXT_SUFFIX/ {print $3}' | tr -d '"')

3. 用pybind11官方构建工具链（推荐） #

如果用CMake，pybind11的CMake模块会自动处理后缀：

cmake_minimum_required(VERSION 3.14)
project(pybind_example)

find_package(pybind11 REQUIRED)
pybind11_add_module(example example.cpp)
# 自动适配当前Python环境，无需手动指定后缀

如果用setup.py（setuptools），setuptools本身会处理扩展命名：

from setuptools import setup, Extension
import pybind11

ext_modules = [
    Extension(
        "example",
        ["example.cpp"],
        include_dirs=[pybind11.get_include()],
        language="c++"
    ),
]

setup(
    name="example",
    ext_modules=ext_modules,
    cmdclass={"build_ext": pybind11.setup_helpers.build_ext},
)

激活虚拟环境后运行pip install .或python setup.py build_ext，setuptools会自动生成对应后缀的扩展文件。

虚拟环境构建扩展的通用做法 #

• 激活虚拟环境后，所有构建命令都用环境内的python/pip，别用python3/pip3，避免调用系统版本。
• 别直接依赖系统级工具（比如python3-config），优先通过Python内置模块（如sysconfig）或官方构建工具获取配置。
• 优先用setuptools、CMake配合pybind11官方工具链，这些工具会自动适配当前环境，减少手动配置出错。
• 多版本批量构建可以用tox，它会自动创建对应版本的虚拟环境并完成构建、测试，不用手动管理每个环境。

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