如何使用build工具创建特定平台的Python wheel包？

1. 修正命令行参数传递格式 #

你之前的命令因参数格式错误导致失败，正确传递plat-name参数给build工具的写法如下：

# Linux/macOS环境
python -m build -w --config-setting="--plat-name=linux_x86_64"

# Windows环境
python -m build -w --config-setting="--plat-name=win_amd64"

若需跳过依赖检查，可添加-n参数：

python -m build -w -n --config-setting="--plat-name=linux_x86_64"

2. 跨平台动态适配方案 #

如果需要在不同系统上自动匹配对应平台标识，推荐两种便捷方式：

方式一：利用环境变量 #

bdist_wheel会自动读取WHEEL_PLAT_NAME环境变量作为平台名称，无需修改配置文件：

# Linux/macOS终端
export WHEEL_PLAT_NAME=linux_x86_64
python -m build -w

# Windows命令提示符
set WHEEL_PLAT_NAME=win_amd64
python -m build -w

# Windows PowerShell
$env:WHEEL_PLAT_NAME = "win_amd64"
python -m build -w

方式二：编写自动适配脚本 #

写一个跨平台Python脚本，自动检测当前系统并设置对应参数，示例如下：

import sys
import subprocess

# 根据系统自动匹配平台标识
if sys.platform.startswith('linux'):
    plat_name = 'linux_x86_64'
elif sys.platform.startswith('win32'):
    plat_name = 'win_amd64'
elif sys.platform.startswith('darwin'):
    plat_name = 'macosx_10_9_x86_64'  # 可根据需求调整macOS版本
else:
    raise ValueError(f"不支持的平台: {sys.platform}")

# 执行构建命令
subprocess.run([
    sys.executable, '-m', 'build', '-w',
    '--config-setting', f'--plat-name={plat_name}'
], check=True)

运行该脚本即可在对应系统自动生成匹配的平台wheel包。

3. 可选：基于pyproject.toml的半动态配置 #

若希望配置更集中，可在pyproject.toml中结合环境变量实现条件化配置（需setuptools 61.0+版本支持）：

[tool.setuptools.dynamic]
plat-name = { env = "WHEEL_PLAT_NAME", fallback = "any" }

[tool.setuptools.bdist_wheel]
plat-name = "${plat-name}"

此方式仍需通过环境变量触发，但配置管理更统一。

内容的提问来源于stack exchange，提问作者Tibor Takács