安装JPype1时出现cl.exe退出码2错误，请求技术协助

问题情况 #

安装JPype1时反复出现编译错误，具体报错：

error: command 'C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.38.33130\bin\HostX86\x86\cl.exe' failed with exit code 2
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
  ERROR: Failed building wheel for JPype1
Failed to build JPype1
ERROR: Could not build wheels for JPype1, which is required to install pyproject.toml-based projects

运行环境 #

• Python 3.12.0
• Visual Studio 2022 Developer Command Prompt v17.8.3
• pip 23.3.1（已升级至23.3.2）

已尝试操作 #

执行过pip和setuptools升级：

pip install --upgrade pip setuptools

升级成功，但再次安装JPype1仍报错，输出：

Defaulting to user installation because normal site-packages is not writeable
Collecting JPype1
  Using cached JPype1-1.4.1.tar.gz (797 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
Requirement already satisfied: packaging in c:\users\xxx\appdata\roaming\python\python312\site-packages (from JPype1) (23.2)
Building wheels for collected packages: JPype1
  Building wheel for JPype1 (pyproject.toml) ... error
  error: subprocess-exited-with-error

  × Building wheel for JPype1 (pyproject.toml) did not run successfully.

可行解决步骤 #

• 直接安装预编译二进制包：跳过本地编译，强制使用wheel包安装，执行命令：

  pip install JPype1 --only-binary :all:
  

• 补全Visual Studio构建组件：打开Visual Studio Installer，选择“修改”，勾选“Desktop development with C++”工作负载，确保MSVC v143工具集、对应版本的Windows SDK等组件全部安装完成，重新启动命令提示符后再尝试安装。

• 匹配编译架构：如果你的Python是64位版本，打开Visual Studio Developer Command Prompt时选择“x64”版本，而非x86，在该窗口内执行pip安装命令，避免架构不匹配导致的编译失败。

• 修复pip路径问题：将C:\Users\xxx\AppData\Roaming\Python\Python312\Scripts添加到系统环境变量PATH中，确保pip命令能被系统正确识别，避免权限或路径相关的隐性问题。

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