Windows下Python安装xfoil包报subprocess-exited-with-error如何解决

问题根因 #

报错出现在build_ext构建C/Fortran扩展环节，和已安装的numpy 1.22.4依赖无关，核心原因有两点：

• PyPI上推送的xfoil 1.1.1版本没有提供Windows平台的预编译wheel包，默认走本地源码编译流程
• 本地编译时系统找不到对应的C/Fortran编译程序，或是包内setup.py的相对路径配置在Windows环境下解析失败，最终触发系统找不到指定文件的错误

日志中出现的Unknown distribution option: 'zip_save'警告、setup.py install is deprecated警告均不影响安装流程，不是失败诱因，无需额外处理。

可落地解决步骤 #

优先选第一个方案，操作成本最低，成功率最高：

• 方案1：安装对应版本预编译wheel包，跳过本地编译
  1. 从日志可确认当前环境为64位系统、Python 3.10版本，下载适配该环境的xfoil预编译whl文件到本地
  2. 激活目标虚拟环境，执行命令：

     c:\users\xxx\desktop\curve\venv\scripts\activate
     

  3. 执行本地whl安装命令，将路径替换为你存放whl文件的实际本地路径：

     pip install C:\你存放whl文件的本地路径\xfoil-1.1.1-cp310-cp310-win_amd64.whl
     

• 方案2：补全编译环境后走源码安装
  1. 安装Visual Studio生成工具，安装时勾选「使用C++的桌面开发」组件，同时勾选对应版本的Windows SDK，安装完成后重启电脑
  2. 从开始菜单打开x64 Native Tools Command Prompt for VS（对应你安装的VS版本），不要用普通cmd或PowerShell，这类终端不会自动加载编译环境变量
  3. 在打开的VS命令行中激活虚拟环境，清缓存后执行安装：

     c:\users\xxx\desktop\curve\venv\scripts\activate
     pip install xfoil --no-cache-dir
     

  4. 如果仍报路径错误，手动下载xfoil 1.1.1源码压缩包解压，打开解压目录下的setup.py，将所有引用源文件的相对路径修改为绝对路径后，在解压目录执行python setup.py install完成安装。

注意事项 #

• 不要在未加载VS编译环境变量的普通终端中执行源码编译安装，必然触发找不到编译程序的[WinError 2]错误
• 无需调整当前已安装的numpy版本，现有1.22.4版本完全满足xfoil的依赖要求

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