1. 安装 Homebrew(如果未安装)
Homebrew 是 macOS 上的包管理器,用来安装 OpenSSL 非常方便。打开终端执行:
/bin/bash -c "$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 安装 OpenSSL 并配置环境变量
先安装最新的 OpenSSL,然后告诉系统它的安装路径:
# 安装 OpenSSL 3(Python 3.11+ 推荐使用)
brew install openssl@3
# 临时配置环境变量(仅当前终端有效)
export LDFLAGS="-L$(brew --prefix openssl@3)/lib"
export CPPFLAGS="-I$(brew --prefix openssl@3)/include"
export PKG_CONFIG_PATH="$(brew --prefix openssl@3)/lib/pkgconfig"
3. 重新编译安装 Python 3.11.1
# 清除之前的编译缓存
pyenv uninstall -f 3.11.1
# 指定 OpenSSL 路径重新安装
CFLAGS="-I$(brew --prefix openssl@3)/include" \
LDFLAGS="-L$(brew --prefix openssl@3)/lib" \
pyenv install 3.11.1
如果你是手动下载源码编译,执行:
# 进入 Python 源码目录(替换为你的实际路径)
cd ~/Downloads/Python-3.11.1
# 清理之前的编译残留
make clean
# 配置编译参数(指定 OpenSSL 路径)
./configure--prefix=/usr/local/python3.11.1\--with-openssl=$(brew--prefixopenssl@3)
# 编译并安装
make && make install
4. 验证安装是否成功
安装完成后,验证 ssl 模块是否可用:
# 如果用 pyenv,先切换版本
pyenv global 3.11.1
# 检查 Python 版本和 ssl 模块
python --version python -c "import ssl; print(ssl.OPENSSL_VERSION)"