Python3.12独立版PIP安装Pandas遇元数据生成失败怎么办

问题背景 #

使用独立安装的32位Python 3.12环境安装Pandas时，持续触发metadata-generation-failed错误。Anaconda环境可正常安装，但因需连接VB.net必须使用独立Python环境，且已更新pip和setuptools仍无法解决。

核心错误原因 #

从日志可见关键冲突：

Host machine cpu: x86_64
Program python found: YES (C:\Program Files (x86)\Python312-32\python.exe)
Need python for x86_64, but found x86
Run-time dependency python found: NO (tried sysconfig)
ERROR: Python dependency not found

你的系统是64位架构，但安装的是32位Python，Pandas编译时会匹配系统架构，导致架构不兼容，无法完成元数据生成。

解决方案 #

方案1：更换为64位Python 3.12（推荐） #

1. 卸载当前的32位Python 3.12
2. 下载并安装64位版本的Python 3.12
3. 重新执行安装命令：

   pip install pandas
   

方案2：手动安装32位预编译Pandas包（若必须保留32位Python） #

1. 找到适配32位Python 3.12的Pandas预编译.whl文件（文件命名需包含cp312-win32标识）
2. 执行本地安装命令：

   pip install 你的文件路径\pandas-2.1.4-cp312-win32.whl
   

完整错误输出 #

C:\Program Files (x86)\Python312-32\Scripts>pip install pandas
Defaulting to user installation because normal site-packages is not writeable
Collecting pandas
  Using cached pandas-2.1.4.tar.gz (4.3 MB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Installing backend dependencies ... done
  Preparing metadata (pyproject.toml) ... error
  error: subprocess-exited-with-error

  × Preparing metadata (pyproject.toml) did not run successfully.
  │ exit code: 1
  ╰─> [23 lines of output]
      + meson setup C:\Users\realt\AppData\Local\Temp\pip-install-ew6o36bq\pandas_25d69bcb06c84eb088749c1946920e14 C:\Users\realt\AppData\Local\Temp\pip-install-ew6o36bq\pandas_25d69bcb06c84eb088749c1946920e14\.mesonpy-swd4lt0x\build -Dbuildtype=release -Db_ndebug=if-release -Db_vscrt=md --vsenv --native-file=C:\Users\realt\AppData\Local\Temp\pip-install-ew6o36bq\pandas_25d69bcb06c84eb088749c1946920e14\.mesonpy-swd4lt0x\build\meson-python-native-file.ini
      The Meson build system
      Version: 1.2.1
      Source dir: C:\Users\realt\AppData\Local\Temp\pip-install-ew6o36bq\pandas_25d69bcb06c84eb088749c1946920e14
      Build dir: C:\Users\realt\AppData\Local\Temp\pip-install-ew6o36bq\pandas_25d69bcb06c84eb088749c1946920e14\.mesonpy-swd4lt0x\build
      Build type: native build
      Project name: pandas
      Project version: 2.1.4
      Activating VS 17.8.3
      C compiler for the host machine: cl (msvc 19.38.33133 "Microsoft (R) C/C++ Optimizing Compiler Version 19.38.33133 for x64")
      C linker for the host machine: link link 14.38.33133.0
      C++ compiler for the host machine: cl (msvc 19.38.33133 "Microsoft (R) C/C++ Optimizing Compiler Version 19.38.33133 for x64")
      C++ linker for the host machine: link link 14.38.33133.0
      Cython compiler for the host machine: cython (cython 0.29.36)
      Host machine cpu family: x86_64
      Host machine cpu: x86_64
      Program python found: YES (C:\Program Files (x86)\Python312-32\python.exe)
      Need python for x86_64, but found x86
      Run-time dependency python found: NO (tried sysconfig)

      ..\..\pandas\_libs\tslibs\meson.build:23:7: ERROR: Python dependency not found

      A full log can be found at C:\Users\realt\AppData\Local\Temp\pip-install-ew6o36bq\pandas_25d69bcb06c84eb088749c1946920e14\.mesonpy-swd4lt0x\build\meson-logs\meson-log.txt
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
error: metadata-generation-failed

× Encountered error while generating package metadata.
╰─> See above for output.

note: This is an issue with the package mentioned above, not pip.
hint: See above for details.

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