pyenv install卡在configure阶段是因为缺少Xcode命令行工具或底层库（如openssl、zlib、sqlite3），导致编译环境不完整；需运行xcode-select --install安装CLT，并根据Apple Silicon或Intel架构正确配置LDFLAGS和CPPFLAGS指向brew对应路径。
为什么 pyenv install 会卡在 configure 阶段
pyenv 安装 Python 版本时不是解压即用，而是从源码编译。一旦缺少 Xcode 命令行工具或底层库，就会在 configure 或 make 阶段失败，典型报错包括：No module named _ssl、_sqlite3 not found、zlib not available。这些都不是 pyenv 本身的问题，而是编译环境不完整。
必须安装 Xcode 命令行工具（不是完整 Xcode）
macOS 自带的系统 Python 受 SIP 保护，不能动；而 pyenv 编译新版本必须依赖本地构建链。你不需要下载几个 GB 的 Xcode.app，只需命令行工具：
- 运行
xcode-select --install，弹窗点“Install”（不是“Get Xcode”） - 验证：执行
clang --version和make --version，有输出即成功 - 如果已装过 Xcode.app，仍需运行该命令——Xcode 更新后命令行工具常被重置
Apple Silicon（M 系列）必须补环境变量
Homebrew 默认装在 /opt/homebrew，但 pyenv 编译时不会自动找这里的头文件和库。缺这步，pyenv install 3.12.5 很可能通过了 configure 却在 linking 阶段失败：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 追加两行到
~/.zshrc：export LDFLAGS="-L/opt/homebrew/opt/zlib/lib -L/opt/homebrew/opt/openssl/lib -L/opt/homebrew/opt/sqlite3/lib"export CPPFLAGS="-I/opt/homebrew/opt/zlib/include -I/opt/homebrew/opt/openssl/include -I/opt/homebrew/opt/sqlite3/include" - 别漏掉
sqlite3——它影响pip install后能否正常 importsqlite3 - 执行
source ~/.zshrc，再运行pyenv install
Intel Mac 和 Apple Silicon 的路径差异不能混用
Homebrew 在 Intel 上默认路径是 /usr/local，在 Apple Silicon 上是 /opt/homebrew。如果你在 M 系列机器上手动改过 PATH 指向 /usr/local，或者用了旧教程里的 Intel 配置，pyenv install 就会找不到 openssl 头文件，报 fatal error: 'openssl/ssl.h' file not found：
立即学习“Python免费学习笔记（深入）”；
- 确认当前架构：
arch输出arm64就是 Apple Silicon - 检查 Homebrew 路径：
brew --prefix，结果必须是/opt/homebrew（M 系列）或/usr/local（Intel） - 所有
LDFLAGS/CPPFLAGS中的路径必须与brew --prefix严格一致
xcode-select -p 可能指向一个已失效的路径，导致后续所有编译失败。每次 macOS 系统更新或 Xcode 更新后，都建议重新跑一遍 xcode-select --install。 
