Apple Silicon Mac安装Python 3.6全攻略：解决ARM64架构兼容性问题

Apple Silicon Mac安装Python 3.6全攻略：解决ARM64架构兼容性问题

发布时间：2026/8/24 6:51:59
Apple Silicon Mac安装Python 3.6全攻略：解决ARM64架构兼容性问题 1. 为什么在Apple Silicon上安装Python 3.6是个“技术活”如果你手头是一台搭载M1、M2或M3芯片的Mac然后因为某个老项目、特定依赖或者公司遗留系统的要求必须安装Python 3.6那你大概率已经碰过壁了。这感觉就像拿着最新的智能手机却非要运行一个只支持塞班系统的老游戏——硬件和软件之间隔着一道深深的鸿沟。这个问题的核心矛盾在于“架构”和“时代”。Python 3.6的官方生命周期在2021年12月就已经结束这意味着它不再获得任何安全更新或官方支持。而Apple SiliconM1/M2/M3采用的ARM64架构也称为arm64或aarch64在2020年底才随M1芯片问世。Python 3.6的官方发行版在其活跃期主要面向的是当时主流的x86_64架构即Intel芯片。因此官方从未为ARM64架构的macOS提供过预编译的Python 3.6二进制安装包。直接去Python官网下载python-3.6.x-macosx10.9.pkg安装器它会明确告诉你无法安装因为架构不兼容。使用系统自带的python3命令macOS自带的Python版本通常更新且是Apple修改过的你无法降级。这就把我们逼到了必须自己动手“编译”或寻找“替代方案”的路上。这个过程会涉及到Homebrew、pyenv、源码编译、以及处理各种因年代久远而出现的依赖问题堪称一次小型考古与工程实践。接下来的内容我将为你梳理出在Apple Silicon Mac上搞定Python 3.6的几条清晰路径并详细解释每一步背后的原理、可能遇到的坑以及我的实战经验。无论你是为了运行一个陈旧的requirements.txt还是为了测试环境兼容性这篇指南都能帮你从“无法安装”的困境中走出来。2. 方案选型从“省事”到“硬核”的三种路径面对这个问题我们主要有三条路可以走它们各有优劣适用于不同的场景和用户。选择之前先问自己两个问题第一我是否需要系统级的、唯一版本的Python 3.6第二我是否愿意花时间处理编译依赖问题方案一使用pyenv进行版本管理推荐首选这是目前最灵活、最干净也是社区支持最好的方案。pyenv是一个纯粹的Python版本管理工具它允许你在用户目录下安装并切换多个Python版本完全不影响系统自带的Python。它的工作原理是通过插件下载指定版本的Python源码然后在你的本地环境进行编译安装。对于Apple Siliconpyenv结合其插件可以很好地处理ARM64架构的编译问题。优点是隔离性好版本切换方便是Python开发者的标准装备之一。缺点是需要从源码编译在M1/M2/M3上首次编译Python 3.6可能会遇到一些依赖库的报错需要手动解决。方案二使用Homebrew安装旧版Formula需要技巧Homebrew是macOS上最著名的包管理器。它确实为Apple Silicon提供了专门的安装路径/opt/homebrew。Homebrew的“formula”就是软件包的定义文件。虽然官方仓库移除了对Python 3.6的直接支持但我们可以通过“挖坟”找到历史版本的formula文件或者利用Homebrew的版本库特性来安装。这种方法如果能成功会相对便捷。但缺点也很明显操作涉及对Homebrew内部机制的操作可能因为formula的依赖关系过期而导致安装失败并且将过时的软件包通过包管理器安装到系统环境可能与其他软件产生冲突。方案三直接源码编译安装最硬核最可控这是最原始也最彻底的方法从Python官网下载3.6.x的源代码在自己的机器上配置、编译、安装。这种方法让你对整个过程有完全的控制权也能最深刻地理解遇到的问题。它适合那些需要高度定制编译参数或者希望研究跨架构编译过程的人。但对于大多数只想“用上Python 3.6”的用户来说这条路显得过于繁琐和容易出错需要手动解决大量依赖比如SSL、SQLite等开发库。对于绝大多数用户我强烈推荐方案一pyenv。它不仅解决了当前Python 3.6的安装问题更是为你建立了一个可持续的Python多版本开发环境。接下来我们将以pyenv为主线详细展开安装和配置的全过程。3. 实战使用pyenv安装Python 3.6全流程这一部分我们一步步走通用pyenv在M系列芯片Mac上安装Python 3.6的流程。请打开你的终端Terminal我们开始操作。3.1 环境准备安装Homebrew与pyenv首先我们需要一个能安装和管理pyenv的工具。虽然pyenv可以通过其他方式安装但通过Homebrew是最省心的方式因为它能自动处理很多依赖。打开终端输入以下命令安装Homebrew如果你已经安装可以跳过/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)对于Apple Silicon Mac安装脚本会自动将Homebrew安装在/opt/homebrew目录下并将相关路径配置到你的Shell环境通常是~/.zprofile中。安装完成后记得按照终端的提示执行一两行echo命令来配置环境变量或者直接重启终端。接下来通过Homebrew安装pyenv以及一个关键插件pyenv-alias这个插件有时能帮助处理版本别名非必须但推荐brew install pyenv brew install pyenv-alias安装完成后需要将pyenv初始化脚本添加到你的Shell配置文件中。如果你使用的是macOS默认的zshCatalina及以后版本配置文件是~/.zshrc。echo export PYENV_ROOT$HOME/.pyenv ~/.zshrc echo command -v pyenv /dev/null || export PATH$PYENV_ROOT/bin:$PATH ~/.zshrc echo eval $(pyenv init -) ~/.zshrc然后让配置立刻生效source ~/.zshrc现在运行pyenv --version如果能看到版本号说明安装成功。3.2 关键一步安装编译依赖解决“zlib not available”等错误这是Apple Silicon上编译老旧Python版本最容易失败的地方。Python 3.6的编译脚本依赖于一些系统库的开发头文件。在Intel Mac时代这些可能预装了或者通过Xcode命令行工具就能获得。但在ARM64架构下尤其是对于旧版本我们需要确保这些库的存在。最核心的依赖是zlib、readline、sqlite3和openssl。我们可以通过Homebrew来安装它们brew install zlib readline sqlite3 openssl1.1注意这里我们特意安装了openssl1.1。Python 3.6时期OpenSSL 1.1是主流。虽然系统可能有更新的OpenSSL 3.0但使用1.1版本可以最大程度保证兼容性避免链接错误。安装完这些库之后我们需要告诉编译器去哪里找它们。在编译Python时可以通过环境变量设置头文件-I和库文件-L的搜索路径。这是整个过程中最关键的技术点之一。我们可以创建一个临时的环境变量组合在安装Python时使用。但更一劳永逸的方法是在运行pyenv install命令时通过CFLAGS和LDFLAGS环境变量传递这些参数。不过pyenv提供了一个更优雅的解决方案在~/.pyenv目录下放置一个名为python-build的插件或者直接使用PYTHON_CONFIGURE_OPTS等环境变量。一个经过我多次验证、可靠的方法是在安装命令前直接设置所需的环境变量export LDFLAGS-L/opt/homebrew/opt/zlib/lib -L/opt/homebrew/opt/readline/lib -L/opt/homebrew/opt/openssl1.1/lib -L/opt/homebrew/opt/sqlite3/lib export CPPFLAGS-I/opt/homebrew/opt/zlib/include -I/opt/homebrew/opt/readline/include -I/opt/homebrew/opt/openssl1.1/include -I/opt/homebrew/opt/sqlite3/include export PKG_CONFIG_PATH/opt/homebrew/opt/zlib/lib/pkgconfig:/opt/homebrew/opt/readline/lib/pkgconfig:/opt/homebrew/opt/openssl1.1/lib/pkgconfig:/opt/homebrew/opt/sqlite3/lib/pkgconfig这些命令将链接器标志LDFLAGS、预处理器标志CPPFLAGS和pkg-config路径指向了Homebrew安装的各个库的位置。/opt/homebrew是Apple Silicon上Homebrew的标准安装前缀。3.3 执行安装并破解疑难杂症现在尝试安装Python 3.6.15这是3.6系列的最后一个版本相对最稳定pyenv install 3.6.15这个过程会持续几分钟到十几分钟取决于你的网络和电脑性能。它主要做以下几件事从Python镜像站下载3.6.15的源代码解压到一个临时目录运行configure脚本检测系统环境执行make和make install进行编译和安装。然而很大概率你会遇到第一个常见的错误ModuleNotFoundError: No module named _ctypes。这是因为Python的ctypes模块依赖于libffi库。在macOS上这个库可能没有或者版本不对。解决方法就是安装libffibrew install libffi安装后我们需要将libffi的路径也加入到环境变量中然后重新尝试安装。但请注意pyenv install命令在失败后可能会留下一个半成品。最干净的做法是清理掉这个失败的构建缓存设置好包含libffi的完整环境变量再重新安装。我们可以写一个简单的脚本来完成所有环境变量的设置并执行安装export LDFLAGS-L/opt/homebrew/opt/zlib/lib -L/opt/homebrew/opt/readline/lib -L/opt/homebrew/opt/openssl1.1/lib -L/opt/homebrew/opt/sqlite3/lib -L/opt/homebrew/opt/libffi/lib export CPPFLAGS-I/opt/homebrew/opt/zlib/include -I/opt/homebrew/opt/readline/include -I/opt/homebrew/opt/openssl1.1/include -I/opt/homebrew/opt/sqlite3/include -I/opt/homebrew/opt/libffi/include export PKG_CONFIG_PATH/opt/homebrew/opt/zlib/lib/pkgconfig:/opt/homebrew/opt/readline/lib/pkgconfig:/opt/homebrew/opt/openssl1.1/lib/pkgconfig:/opt/homebrew/opt/sqlite3/lib/pkgconfig:/opt/homebrew/opt/libffi/lib/pkgconfig # 如果之前安装失败过可以先清理可选 pyenv uninstall -f 3.6.15 # 开始安装 pyenv install 3.6.15这一次编译过程应该能顺利走完。你会看到大量的编译输出最后以一句“Installed Python-3.6.15 to /Users/你的用户名/.pyenv/versions/3.6.15”结束。3.4 验证安装与版本管理安装成功后我们可以验证一下。首先查看pyenv已管理的所有Python版本pyenv versions你应该能看到3.6.15出现在列表中前面可能有一个星号*表示这是当前全局global或本地local正在使用的版本。系统自带的Python通常也会显示为system。现在我们可以将这个新安装的Python 3.6.15设置为当前终端会话的全局版本pyenv global 3.6.15然后检查Python版本和架构python --version # 输出应为Python 3.6.15 python -c import platform; print(platform.machine()) # 输出应为arm64恭喜你现在已经在Apple Silicon Mac上成功运行了一个ARM64原生版本的Python 3.6。pyenv的强大之处在于你可以随时切换版本。例如在一个特定的项目目录下你可以使用pyenv local 3.6.15命令这会在当前目录创建一个.python-version文件之后进入这个目录时pyenv会自动切换到Python 3.6.15。而在其他目录仍然可以使用其他版本的Python。4. 备选方案与进阶问题处理虽然pyenv是首选但了解其他方案及其陷阱同样重要。此外安装成功只是第一步使用中可能还会遇到问题。4.1 Homebrew方案探秘与风险提示如果你坚持想用Homebrew直接安装可以尝试搜索旧的formula。但请注意Homebrew核心仓库homebrew-core已经移除了python3.6的formula。你可以尝试从homebrew-core的Git历史中找回或者使用第三方tap软件源。一个曾经可用的方法是安装pyenv后通过Homebrew安装python3.6但指定使用旧的版本库。然而这种方法极其不稳定因为旧formula中定义的依赖如openssl1.1可能已经失效或与其他软件冲突。命令可能长这样brew tap-new local/python brew extract --version3.6 python local/python brew install local/python/python3.6这个过程很可能因为依赖解析失败而告终并且一旦安装它会将Python 3.6链接到/opt/homebrew目录下可能影响其他通过Homebrew安装的、依赖其他Python版本的软件。因此除非你非常清楚自己在做什么并且愿意处理潜在的依赖地狱否则不推荐普通用户尝试此方法。4.2 安装后常见问题pip与SSL即使Python安装成功在使用pip安装包时你可能会遇到SSL证书验证错误例如[SSL: CERTIFICATE_VERIFY_FAILED]。这是因为Python 3.6自带的certifi证书包可能太旧或者我们编译时指定的OpenSSL路径有问题。解决方法之一是升级pip和setuptools并信任系统证书python -m pip install --upgrade pip setuptools wheel如果问题依旧可以尝试运行一个安装后脚本来安装certifipython -m pip install certifi /Applications/Python\ 3.6/Install\ Certificates.command # 注意此路径适用于官方pkg安装器对于pyenv安装此命令不存在。对于pyenv安装的环境更直接的方法是使用系统证书。可以设置一个环境变量让Python使用macOS自带的证书库export SSL_CERT_FILE$(python -m certifi) # 这会使用Python certifi模块提供的证书 # 或者直接指向系统证书推荐 export SSL_CERT_FILE/etc/ssl/cert.pem你可以将上面这行export命令添加到你的~/.zshrc文件中使其永久生效但仅限于当你使用这个Python 3.6环境时。4.3 虚拟环境隔离项目依赖的必备操作强烈建议不要直接在刚安装的Python 3.6基础环境中安装项目依赖。应该为每个项目创建独立的虚拟环境Virtual Environment。这可以避免包版本冲突保持环境清洁。Python 3.6自带了venv模块。使用起来非常简单# 切换到你的项目目录 cd ~/my_old_project # 创建虚拟环境环境目录名为‘venv’ python -m venv venv # 激活虚拟环境 source venv/bin/activate # 激活后终端提示符前通常会显示‘(venv)’ # 此时所有pip安装的包都会局限在这个‘venv’目录下 # 安装项目依赖 pip install -r requirements.txt # 完成工作后退出虚拟环境 deactivate通过虚拟环境你可以为这个需要Python 3.6的老项目单独配置一套依赖而不会影响其他使用Python 3.9、3.11等版本的项目。5. 总结与最终建议让旧版本焕发新生在Apple Silicon的Mac上运行Python 3.6本质上是一场新硬件与旧软件之间的调和。通过pyenv从源码编译我们绕过了官方二进制包缺失的障碍通过精心配置编译依赖我们解决了ARM64架构下的兼容性问题。回顾整个流程最关键的两个技术点是第一理解并正确设置LDFLAGS和CPPFLAGS等编译环境变量将编译器指向Homebrew提供的ARM64原生依赖库第二有耐心地逐个解决编译过程中出现的缺失库错误如libffi。从我个人的多次实践来看只要按照上述步骤系统性地准备好zlib、readline、sqlite3、openssl1.1和libffi这几个库并设置好环境变量一次性成功编译通过Python 3.6.15的概率是非常高的。这比盲目尝试各种网络上的零散解决方案要高效得多。最后给一个终极建议如果这个Python 3.6环境只是用于运行一个极其陈旧、无法升级的应用那么在成功安装并配置好虚拟环境后可以考虑为该虚拟环境创建一个简单的启动脚本。这个脚本能自动激活虚拟环境并设置好必要的环境变量如SSL_CERT_FILE让你每次使用都无需记忆复杂的命令。技术工作的价值往往就体现在将这些繁琐的过程封装成简单可靠的工具从而让我们能更专注于解决真正的业务问题。