PyCryptodome 加密库安装与使用指南

一、PyCryptodome 简介

PyCryptodome 是一个功能强大的 Python 加密工具库，它提供了多种加密算法的实现，包括对称加密、非对称加密、哈希算法、消息认证码(MAC)、密钥派生函数等。作为 PyCrypto 的替代品，PyCryptodome 具有更好的维护性和安全性。

二、安装方式选择

PyCryptodome 提供两种安装方式，开发者可根据项目需求选择：

1. 作为 PyCrypto 的替代品安装

pip install pycryptodome

特点：

• 所有模块安装在 Crypto 包下
• 与原有 PyCrypto 代码兼容
• 不能与 PyCrypto 同时安装（会产生冲突）
• 推荐在虚拟环境中使用

2. 作为独立库安装

pip install pycryptodomex

特点：

• 所有模块安装在 Cryptodome 包下
• 可与 PyCrypto 共存
• 适合需要同时使用新旧版本的项目

三、安装验证

安装完成后，建议运行自测程序验证安装是否成功：

pip install pycryptodome-test-vectors
python -m Cryptodome.SelfTest  # 或 Crypto.SelfTest（取决于安装方式）

四、各平台详细安装指南

Linux Ubuntu 系统

Python 2.x 环境

sudo apt-get install build-essential python-dev
pip install pycryptodomex

Python 3.x 环境

sudo apt-get install build-essential python3-dev
pip install pycryptodomex

PyPy 环境

sudo apt-get install build-essential pypy-dev
pip install pycryptodomex

Linux Fedora 系统

Python 2.x 环境

sudo yum install gcc gmp python-devel
pip install pycryptodomex

Python 3.x 环境

sudo yum install gcc gmp python3-devel
pip install pycryptodomex

PyPy 环境

sudo yum install gcc gmp pypy-devel
pip install pycryptodomex

Windows 系统

Windows 系统需要额外安装编译工具：

1. 安装 Visual Studio 2019 构建工具

   • 选择安装 C++ 构建工具
   • 安装 Windows 10 SDK
   • 安装最新版 MSVC v142 x64/x86 构建工具

2. 安装 PyCryptodome

pip install pycryptodomex --no-binary :all:

3. 验证安装

pip install pycryptodome-test-vectors
python -m Cryptodome.SelfTest

五、文档构建

项目文档采用 reStructuredText 格式编写，如需构建 HTML 文档：

make -C Doc/ html

构建完成后，文档位于 Doc/_build/html/ 目录下。

六、安全验证

所有发布的 PyCryptodome 包都经过 PGP 签名验证，开发者可使用提供的公钥验证下载包的完整性。

七、注意事项

1. Python 2.7 在 Windows 上运行时，需先安装 Microsoft Visual C++ 2015 Redistributable
2. 避免同时安装 PyCrypto 和 PyCryptodome（使用 pycryptodome 安装方式时）
3. 生产环境建议使用虚拟环境隔离依赖

通过以上步骤，开发者可以顺利完成 PyCryptodome 的安装和验证，开始使用这个强大的加密工具库进行安全开发。