macOS与Linux下安装Python 3.6.5的方法:pyenv或源码编译

小石头
小石头
发布时间:2026-11-18 | 6人浏览过
原创

针对旧项目维护与特定环境依赖需求,系统讲解在 macOS 与常见 Linux 发行版中安装 Python 3.6.5 的两种可靠途径:利用 pyenv 进行多版本隔离管理,以及通过源码编译结合 altinstall 实现独立安装,并深度剖析 OpenSSL 1.1 依赖与高频编译报错的解决方案。

在维护早期数据分析流水线、基于旧版 TensorFlow 1.x 训练模型或迁移遗留自动化工程时,往往必须在运行环境中安装特定的小版本 Python 3.6.5。由于 Python 3.6 的官方上游维护早已停止,现代 macOS(如 Homebrew)及主流 Linux 发行版(如 Ubuntu 20.04+、Debian 11+、RHEL 8+)的默认软件仓库已不再收录该版本,且系统标配的 OpenSSL 3.0 或更新依赖会导致早期 Python 源码在构建时产生语法与链接冲突。要在不破坏主机自带 Python 环境的前提下平稳运行 Python 3.6.5,目前行业中最成熟且具备工程确定性的两条途径是:使用 pyenv 版本管理器进行用户级安装,或者自行下载源码包并利用 make altinstall 进行定向编译。

macOS与Linux下安装Python 3.6.5的方法:pyenv或源码编译
图 1:Python 3.6.5 两种主要部署方案的适用场景与技术边界

核心瓶颈说明:为什么直接编译 Python 3.6.5 会失败?

在直接动手执行安装命令前,必须先理清安装过程中的一个致命技术障碍:OpenSSL 协议兼容性断层。Python 3.6.5 于 2018 年发布,其内置的 _ssl C 扩展模块仅兼容 OpenSSL 1.0.2 系列以及 OpenSSL 1.1.0/1.1.1 的特定分支。然而,当前主流的现代 Linux(如 Ubuntu 22.04+、Fedora 36+)以及 macOS 官方 Homebrew 默认集成的 OpenSSL 均为 3.0 及以上版本。OpenSSL 3.0 废弃了大量旧版 API 结构体,导致直接在现代系统上编译 Python 3.6.5 时,构建脚本会提示 ssl.h 语法错误或静默跳过 _ssl 模块。如果构建出的 Python 缺少 _ssl,则 pip install 无法建立 HTTPS 安全握手,解释器直接失去实际使用价值。

因此,无论采取 pyenv 还是源码直接编译,核心手段都在于:为 Python 3.6.5 提供独立的 OpenSSL 1.1 开发库,并在编译参数中显式绑定对应头文件与库文件路径。

方案一:使用 pyenv 安装与管理 Python 3.6.5

pyenv 是在开发环境中管理多个 Python 版本的通用工具。它通过在用户主目录下构建垫片(Shims),实现全局、项目目录以及当前会话级别的版本隔离,不会影响系统管理工具(如 Linux 的 apt/yum 或 macOS 内置脚本)的正常工作。

macOS与Linux下安装Python 3.6.5的方法:pyenv或源码编译
图 2:基于 pyenv 构建 Python 3.6.5 的端到端执行链路

1. 准备宿主系统构建依赖

在编译之前,需要确保系统已具备 C 语言编译器及 Python 依赖的各类 C 库头文件。

macOS 系统操作:

# 确保已安装 Xcode 命令行工具
xcode-select --install

# 使用 Homebrew 安装基础依赖与 OpenSSL 1.1 分支
brew update
brew install pyenv openssl@1.1 readline sqlite3 xz zlib bzip2

Ubuntu / Debian 系统操作:

sudo apt-get update
sudo apt-get install -y build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
libffi-dev liblzma-dev git

注意:在 Ubuntu 22.04 及更新版本中,直接安装的 libssl-dev 为 3.0 版本。若遇到 _ssl 报错,需单独从归档库或源码获取安装 libssl1.1 及其头文件。

CentOS 7 / RHEL 7 系统操作:

sudo yum groupinstall -y "Development Tools"
sudo yum install -y openssl-devel bzip2-devel libffi-devel \
readline-devel sqlite-devel zlib-devel wget

2. 配置 pyenv 基础环境

在当前用户的 shell 配置文件(~/.bashrc 或 ~/.zshrc)中加入垫片初始化配置:

export PYENV_ROOT="$HOME/.pyenv"
command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

保存后执行 source ~/.bashrc 或 source ~/.zshrc 使其生效。

3. 注入编译参数并安装 Python 3.6.5

在 macOS 上,Homebrew 的 openssl@1.1 为 keg-only(即不自动链接到系统 /usr/local 或 /opt/homebrew 主路径中),必须显式获取其绝对路径并注入 CFLAGS 和 LDFLAGS:

# macOS 下的标准执行指令
CFLAGS="-I$(brew --prefix openssl@1.1)/include -I$(brew --prefix readline)/include" \
LDFLAGS="-L$(brew --prefix openssl@1.1)/lib -L$(brew --prefix readline)/lib" \
pyenv install 3.6.5

在 Linux 系统中,如果额外编译或安装了 OpenSSL 1.1(假定安装在 /usr/local/openssl11),则执行:

# Linux 下指定自定义 OpenSSL 路径
CFLAGS="-I/usr/local/openssl11/include" \
LDFLAGS="-L/usr/local/openssl11/lib -Wl,-rpath,/usr/local/openssl11/lib" \
pyenv install 3.6.5

4. 启用与验证版本

编译成功后,解释器已安置在 ~/.pyenv/versions/3.6.5 中。在目标项目根目录下执行:

# 切换局部版本
pyenv local 3.6.5

# 查看当前生效的 Python 路径与版本号
python --version
# 预期输出示例:Python 3.6.5

# 严谨验证底层核心模块支持
python -c "import ssl; print('SSL 版本:', ssl.OPENSSL_VERSION)"
python -c "import sqlite3; print('SQLite 正常加载')"

方案二:官方源码手动编译与独立部署

在不能接入外部脚本框架、生产环境构建只读 Docker 镜像或受安全限制无法使用用户态工具时,直接下载 Python 官方源码包进行编译是最纯粹的部署手段。为杜绝系统级破坏,必须使用 make altinstall 替代 make install。

macOS与Linux下安装Python 3.6.5的方法:pyenv或源码编译
图 3:源码编译流水线与系统隔离防护架构

1. 获取官方源码包

在网络畅通的终端中,使用 wget 或 curl 从 Python 官方 FTP 服务器获取归档包并解压:

wget https://www.python.org/ftp/python/3.6.5/Python-3.6.5.tgz
tar -zxvf Python-3.6.5.tgz
cd Python-3.6.5

2. 指定参数进行工程配置

为了不污染系统的 /usr/local 目录,推荐将 Python 3.6.5 安装至独立的系统目录(例如 /opt/python3.6.5)或当前用户的本地目录(如 $HOME/.local/python36)。

针对 Linux 系统(OpenSSL 1.1 位于 /usr/local/openssl11):

./configure \
  --prefix=/opt/python3.6.5 \
  --enable-optimizations \
  --with-openssl=/usr/local/openssl11 \
  --enable-shared \
  LDFLAGS="-Wl,-rpath,/opt/python3.6.5/lib:/usr/local/openssl11/lib"

针对 macOS 系统(利用 Homebrew 的 openssl@1.1 与 zlib):

OPENSSL_DIR="$(brew --prefix openssl@1.1)"
READLINE_DIR="$(brew --prefix readline)"

./configure \
  --prefix="/opt/python3.6.5" \
  --with-openssl="${OPENSSL_DIR}" \
  CPPFLAGS="-I${OPENSSL_DIR}/include -I${READLINE_DIR}/include" \
  LDFLAGS="-L${OPENSSL_DIR}/lib -L${READLINE_DIR}/lib"

注意:--enable-optimizations 会在编译过程中运行一系列测试脚本来生成 profile 数据,提高生成的二进制解释器约 10% 的运行效率;如果仅仅是在测试容器中快速部署,可以去除该参数以缩短编译时长。

3. 多核编译与安装

# 获取当前主机的 CPU 核心数进行并行编译
# Linux:
make -j$(nproc)

# macOS:
# make -j$(sysctl -n hw.ncpu)

# 关键安装指令:必须使用 altinstall!
sudo make altinstall
为什么绝对不能执行 make install?
如果执行了 make install,构建系统会强行在 bin 目录下建立指向 python3 和 python 的软链接。在 Linux 宿主系统中,很多核心基础设施(例如 Ubuntu 的 software-properties-common、CentOS 的 yum、Fedora 的 dnf)都强依赖系统默认版本的 Python。一旦软链接被替换为 Python 3.6.5,可能导致包管理器彻底崩溃。而 make altinstall 仅生成名为 python3.6 的可执行文件,彻底避免了命令冲突。

4. 建立虚拟环境投入工程使用

为了让业务开发便利,不要直接修改系统的 PATH 环境变量覆盖默认命令,而是通过该指定二进制直接创建项目虚拟环境:

# 建立项目独立虚拟环境
/opt/python3.6.5/bin/python3.6 -m venv /path/to/your/project/.venv

# 激活虚拟环境
source /path/to/your/project/.venv/bin/activate

# 此时环境内的 python 和 pip 均直接绑定 Python 3.6.5
python -V
pip install --upgrade pip setuptools wheel

两种安装方案的对比与技术选型

为了便于工程师根据不同的交付场景选择最适宜的方案,下表总结了两者的特性差异:

对比维度 方案 A:pyenv 安装 方案 B:源码编译 (altinstall)
环境隔离度 用户目录(~/.pyenv),完全隔离 由 --prefix 参数指定,完全隔离
系统权限要求 无需 root 权限(普通用户即可编译) 写入 /opt 需 sudo;写入用户家目录无需 root
版本切换便利性 极高,支持 .python-version 自动识别 需手动调用指定绝对路径或创建 venv
对生产容器的适配 较臃肿,需额外引入 git 和 bash 垫片框架 极佳,可直接与多阶段 Dockerfile 结合
定制化自由度 适中,遵循 python-build 预置逻辑 极高,可任意增删 ./configure 编译参数

高频编译报错与排查诊断总结

在实际搭建 Python 3.6.5 环境时,受宿主系统环境差异影响,开发者常会遇到几种典型报错。以下图表梳理了最核心的故障排查诊断逻辑:

macOS与Linux下安装Python 3.6.5的方法:pyenv或源码编译
图 4:Python 3.6.5 常见底层编译错误根因与修复指引

补充说明:Pip 与 TLS 安全证书问题

在成功安装 Python 3.6.5 后,尝试使用旧版 pip 拉取依赖时,如果遇到 SSLError: [SSL: CERTIFICATE_VERIFY_FAILED] 警告,说明宿主系统的 CA 证书束未被 Python 内置的 OpenSSL 默认识别。解决办法是在该 Python 解释器环境下执行:

# 安装更新系统的根证书
python -m pip install --upgrade certifi

# macOS 用户若使用 python.org 安装器,需运行随附的证书脚本
# /Applications/Python\ 3.6/Install\ Certificates.command

或者在创建项目虚拟环境后,直接使用官方推荐脚本重新引导现代版本的 pip:

curl https://bootstrap.pypa.io/pip/3.6/get-pip.py -o get-pip.py
python get-pip.py
rm get-pip.py

通过合理结合 pyenv 或 make altinstall,配合对 OpenSSL 1.1 与系统基础开发头文件的精准锁定,开发者完全能够在现代 macOS 与 Linux 架构中构建出稳定、可靠且与宿主完全隔离的 Python 3.6.5 运行环境。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表