如何修复Python安装库时出现的Failed to build cryptography错误?

风芳同学_9885

风芳同学_9885

2026-08-16

500人浏览

原创

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

如何修复python安装库时出现的failed to build cryptography错误?

为什么 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”。

Define repeatable Python automation sessions in code with nox
Define repeatable Python automation sessions in code with nox

将测试、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 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1971

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

5664

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1929

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

34837

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

4067

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

4067

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1303

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

636

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3163

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程