根本原因是macos缺少命令行工具链，cryptography的c扩展需本地编译，而xcode-select指向空目录或未激活；90%场景只需安装命令行工具（clt），执行xcode-select --install即可。
pip install cryptography 报 gcc 或 xcode-select 错误
根本原因是 macOS 缺少命令行工具链，cryptography 的 C 扩展必须本地编译，而 xcode-select 指向了空目录或未激活。别急着装 Xcode（15 GB），90% 场景只需命令行工具（CLT）。
- 先运行
xcode-select -p：如果输出/Library/Developer/CommandLineTools但ls /Library/Developer/CommandLineTools/usr/bin | grep xcodebuild无结果，说明 CLT 损坏或未安装 - 直接执行
xcode-select --install，点弹窗「安装」，等下载完成即可 - 如果已装过 CLT 但依然报错，先运行
sudo xcode-select --reset清除残留配置，再重试pip install cryptography - 确认 Python 路径是否一致：
which python3和which pip3应指向同一环境（比如都来自 pyenv 或 conda），否则pip3 install装到 A 环境，而你用python3运行的是 B 环境
安装成功但 import cryptography 仍报 ModuleNotFoundError
这是“假成功”——pip 显示安装完成，但实际没生成有效模块。常见于 wheel 包不匹配或 Python 版本越界。
- cryptography 42.x 只支持 Python 3.8~3.13；如果你用的是 Python 3.7 或 3.14+，必须指定兼容版本，例如：
pip install cryptography==39.0.2（支持 3.7~3.11） - 检查当前 Python 版本：
python3 -c "import sys; print(sys.version)" - 验证是否真装上了：
pip list | grep cryptography，再确认导入路径：python3 -c "import cryptography; print(cryptography.__file__)"—— 如果报错或路径不在site-packages下，说明环境错位 - 虚拟环境未激活时，
pip install默认装到系统 site-packages，但你的 IDE 或 shell 可能默认用的是其他解释器，务必先source venv/bin/activate
国内网络导致 wheel 包下载失败或损坏
PyPI 官方源在 macOS 上常因网络问题返回不完整 whl 文件，导致安装后缺失核心模块（如 _rust.so），看似成功实则不可用。
- 换国内镜像源安装：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ cryptography - 强制只用预编译二进制包（跳过编译）：
pip install --only-binary=cryptography cryptography—— 这会拒绝任何源码包，只选匹配当前平台的 wheel - 如果仍失败，手动下载 wheel：访问 PyPI cryptography 页面，按需下载对应
cp3x-cp3x-macosx_XX_0_x86_64或universal2的文件；用python3 -m pip install xxx.whl安装（不要用系统pip）
brew install openssl 后仍链接失败
macOS 自带 OpenSSL 已弃用，cryptography 需要较新版本的 libssl 和 libcrypto，但 pip 不会自动找 brew 安装的路径。
- 先确保已装：
brew install openssl libffi - 临时设置编译环境变量（仅本次生效）：
export LDFLAGS="-L$(brew --prefix openssl)/lib -L$(brew --prefix libffi)/lib"和export CPPFLAGS="-I$(brew --prefix openssl)/include -I$(brew --prefix libffi)/include" - 再运行
pip install cryptography；若要永久生效，把这两行加到~/.zshrc - 注意：M1/M2 Mac 用户优先选
universal2或arm64架构的 wheel，避免混用 x86_64 交叉编译
python3 -c "import sys; print(sys.executable, sys.version)" 和 pip list | grep crypto，比盲目重装快得多。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
