如何在MacOS（Darwin）上通过pyenv生成libpython*.so共享库

MacOS系统中，Python共享库的默认后缀是.dylib而非Linux平台的.so，这是你可能误以为操作失败的核心原因。以下是完整的解决步骤：

1. 准备工作：更新pyenv并清理残留 #

旧版pyenv可能存在参数兼容问题，先更新到最新版：

pyenv update

彻底删除之前失败的Python 3.11安装残留：

pyenv uninstall -f 3.11
rm -rf ~/.pyenv/sources/3.11*

2. 重新执行带共享库参数的安装 #

执行以下命令安装带共享库支持的Python 3.11：

env PYTHON_CONFIGURE_OPTS="--enable-shared" pyenv install 3.11

3. 验证共享库是否生成 #

激活该Python版本后，查看安装目录下的库文件：

pyenv local 3.11
ls -la $(pyenv prefix)/lib/ | grep libpython

你会看到libpython3.11.dylib文件，这就是MacOS下的Python共享库。如果需要.so格式的链接（比如某些依赖要求），可以手动创建软链接：

ln -s $(pyenv prefix)/lib/libpython3.11.dylib $(pyenv prefix)/lib/libpython3.11.so

常见失败排查 #

• 依赖缺失：确保已安装Xcode Command Line Tools，执行xcode-select --install完成安装
• 权限问题：不要用sudo执行pyenv相关命令，~/.pyenv目录需保证当前用户有读写权限
• 源码下载失败：可以手动下载Python 3.11的源码包，放到~/.pyenv/sources/目录后再执行安装命令

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