Windows11下安装box2d-py失败：python setup.py bdist_wheel执行出错

错误原因 #

安装日志里的error: command 'swig.exe' failed: None说明系统缺少SWIG工具——box2d-py在编译过程中需要用它生成C++与Python的绑定代码，没有它就无法完成编译安装。

解决方法 #

方案1：安装预编译版本（推荐，无需编译）

box2d-py的官方包需要本地编译，而预编译的wheel包可以跳过编译步骤，直接安装：

1. 先升级pip到最新版本，避免版本兼容问题：

python -m pip install --upgrade pip

2. 安装预编译的box2d-py：

pip install box2d-py --only-binary :all:

如果上述命令仍失败，建议改用维护更活跃的分支版本pybox2d，它兼容Python 3.11等新版本：

pip install pybox2d

方案2：手动安装SWIG并配置环境（适合一定要编译box2d-py的情况）

1. 下载适配Windows 64位的SWIG压缩包（从官方渠道获取）
2. 将压缩包解压到本地路径，比如C:\swig
3. 找到解压后的bin目录（如C:\swig\bin），将其添加到系统环境变量PATH中
4. 重启命令提示符或PowerShell，让环境变量生效
5. 重新执行安装命令：

pip install box2d-py

注意事项 #

• Python 3.11属于较新版本，旧版box2d-py（2.3.8）对其兼容性较差，优先推荐使用pybox2d替代
• 配置环境变量后必须重启终端，否则系统无法识别新添加的路径

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