cryptography构建失败的关键原因是Rust工具链和系统级C库(如OpenSSL)缺失或版本不匹配,自38.0版起强制依赖Rust编译器,且对OpenSSL头文件路径、pkg-config敏感;Linux需build-essential等,macOS需Xcode工具链与openssl@3,Windows应优先使用预编译wheel而非源码编译。

为什么 cryptography 构建失败?关键在底层依赖
根本原因不是 Python 或 pip 本身的问题,而是 cryptography 依赖的 Rust 工具链和系统级 C 库(如 OpenSSL)缺失或版本不匹配。它从 38.0 版本起强制要求 Rust 编译器,且对 OpenSSL 头文件路径、pkg-config 可用性非常敏感。
- Linux 上常见:缺少
build-essential、libssl-dev、libffi-dev或pkg-config - macOS 上常见:Xcode 命令行工具未安装,或
openssl@3与系统默认不兼容 - Windows 上常见:未安装 Visual Studio Build Tools,或环境变量未识别到 MSVC 工具链
Linux/macOS:先装系统依赖再试 pip install
跳过“先升级 pip”这类无效操作,直接补全构建链。顺序不能错——系统依赖必须在 pip 前就位,否则 pip 会缓存失败状态。
- Ubuntu/Debian:
sudo apt-get install build-essential libssl-dev libffi-dev libpq-dev pkg-config - CentOS/RHEL:
sudo yum install gcc openssl-devel libffi-devel python3-devel(或dnf) - macOS(Homebrew):
brew install rust openssl@3 pkg-config,然后导出:export OPENSSL_DIR=$(brew --prefix openssl@3)
做完后清掉 pip 缓存:pip cache purge,再重试 pip install cryptography。
Windows:避开源码编译,优先用预编译轮子
Windows 下编译 cryptography 极易失败,因为 MSVC 工具链配置复杂,且 wheel 包已广泛提供。关键是让 pip 知道“别编译,直接下 wheel”。
将测试、lint、构建和文档流程编码为命名的Python会话,以便人类和代理每次运行相同的workflow。
- 确保 pip 是最新版:
python -m pip install --upgrade pip - 强制只安装二进制包:
pip install --only-binary=cryptography cryptography - 如果仍失败,检查 Python 架构是否匹配(32/64 位);某些旧 Python 3.8+ 安装包只提供 64 位 wheel
若公司网络拦截 PyPI,需提前下载对应 .whl 文件(注意匹配 Python 版本、系统架构、Windows 版本),用 pip install xxx.whl 离线安装。
conda 用户别混用 pip,否则 OpenSSL 冲突高发
conda 自带的 openssl 和系统或 pip 安装的 OpenSSL 往往不兼容,尤其在 macOS 和 Linux 上。一旦出现 ImportError: cannot import name 'constants' from 'cryptography.hazmat.bindings.openssl.binding',基本就是链接混乱。
- 统一用 conda 安装:
conda install cryptography(推荐 channel:conda-forge) - 绝对避免在 conda 环境里执行
pip install cryptography,除非你明确禁用了 conda 的 OpenSSL 并接管了全部 SSL 链路 - 检查冲突:
conda list openssl cryptography,确认二者来自同一 channel(如都为conda-forge)
真正麻烦的是混合环境里已经出错——此时最稳的办法是删掉环境重建,而不是尝试修复。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










