MacBook M1环境下使用Poetry安装Hydra失败的问题求助

问题原因 #

struct _typeobject中不存在tp_print成员的错误，本质是依赖包的C扩展代码使用了Python 3.8及以后版本已废弃的API。M1芯片的编译环境对API兼容性校验更严格，且部分依赖未提供适配arm64架构的预编译wheel，导致本地编译失败。

可行解决方案 #

1. 升级Poetry并清理缓存

旧版Poetry对M1架构的支持不完善，先升级到最新版并清理缓存：

poetry self update
poetry cache clear --all pypi

之后重新执行安装命令。

2. 直接安装hydra-core并指定兼容依赖

hydra是元包，可能引入不必要的依赖，直接安装核心包hydra-core，并提前安装兼容M1的依赖版本：

# 先安装适配M1的antlr4依赖（Hydra的核心依赖）
poetry add antlr4-python3-runtime==4.11.1
# 再安装Hydra 2.5核心包
poetry add hydra-core==2.5.0

3. 设置M1专属编译参数

指定编译架构为arm64，避免编译时的架构不兼容问题：

export ARCHFLAGS="-arch arm64"
export CFLAGS="-arch arm64"
# 执行安装
poetry add hydra-core==2.5.0

4. 切换到Python 3.10+版本（若业务允许）

Python 3.9在M1上的C扩展兼容性不如3.10及以上版本，可通过pyenv切换环境：

# 安装Python 3.10.12（稳定版）
pyenv install 3.10.12
# 设置本地Python版本
pyenv local 3.10.12
# 让Poetry使用新环境
poetry env use 3.10.12
# 重新安装依赖并添加Hydra
poetry install
poetry add hydra-core==2.5.0

5. 手动安装预编译wheel

从PyPI下载适配M1（arm64）、Python 3.9的hydra-core预编译wheel包，然后本地安装：

# 替换为实际下载的wheel文件名
poetry add ./hydra_core-2.5.0-cp39-cp39-macosx_11_0_arm64.whl

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