3. Python 密码学环境搭建

在开始对称加密算法的实战之前，必须搭建一个干净、可复现的 Python 密码学开发环境。本章将指导你完成 cryptography 和 pycryptodome 两个核心库的安装，并通过虚拟环境隔离项目依赖，最后验证安装是否成功。

3.1 环境概览与工具选择

Python 密码学生态中有多个主流库，本课程选用以下两个作为实战基础：

3.2 创建虚拟环境

虚拟环境是 Python 项目依赖隔离的最佳实践。以下步骤使用 Python 内置的 venv 模块完成环境创建：

1. 创建项目目录：在终端中执行 mkdir crypto-lab && cd crypto-lab
2. 创建虚拟环境：python3 -m venv venv
3. 激活虚拟环境：
   • Linux/macOS：source venv/bin/activate
   • Windows (PowerShell)：.\venv\Scripts\Activate.ps1
   • Windows (CMD)：.\venv\Scripts\activate.bat
4. 验证激活：终端提示符前出现 (venv) 前缀即表示成功

3.3 安装密码学库

激活虚拟环境后，使用 pip 安装两个核心库：

# 安装 cryptography 库（提供高层加密 API）
pip install cryptography

# 安装 pycryptodome 库（提供底层算法原语）
pip install pycryptodome

# 可选：安装 ipython 用于交互式测试
pip install ipython

安装完成后，可以通过 pip list 查看已安装的包及其版本：

(venv) $ pip list | grep -E "cryptography|pycryptodome"
cryptography         42.0.5
pycryptodome         3.20.0

3.4 验证安装

编写一个简短的验证脚本，确认两个库都能正常导入并执行基本操作：

# verify_crypto_env.py
import sys

def verify_cryptography():
    """验证 cryptography 库的 Fernet 对称加密功能"""
    from cryptography.fernet import Fernet
    key = Fernet.generate_key()
    cipher = Fernet(key)
    plaintext = b"Hello, symmetric encryption!"
    ciphertext = cipher.encrypt(plaintext)
    decrypted = cipher.decrypt(ciphertext)
    assert plaintext == decrypted, "cryptography: 加解密不匹配"
    print("[OK] cryptography: Fernet 加解密验证通过")

def verify_pycryptodome():
    """验证 pycryptodome 库的 AES-CBC 加解密功能"""
    from Crypto.Cipher import AES
    from Crypto.Random import get_random_bytes
    key = get_random_bytes(16)  # AES-128
    iv = get_random_bytes(16)
    cipher = AES.new(key, AES.MODE_CBC, iv)
    plaintext = b"Hello from pycryptodome!"
    # 填充到 16 字节倍数
    padded = plaintext + b"\x00" * (16 - len(plaintext) % 16)
    ciphertext = cipher.encrypt(padded)
    decipher = AES.new(key, AES.MODE_CBC, iv)
    decrypted = decipher.decrypt(ciphertext).rstrip(b"\x00")
    assert plaintext == decrypted, "pycryptodome: 加解密不匹配"
    print("[OK] pycryptodome: AES-CBC 加解密验证通过")

if __name__ == "__main__":
    print("=== Python 密码学环境验证 ===")
    print(f"Python 版本: {sys.version}")
    verify_cryptography()
    verify_pycryptodome()
    print("=== 所有验证通过，环境搭建成功 ===")

执行验证脚本：

(venv) $ python verify_crypto_env.py
=== Python 密码学环境验证 ===
Python 版本: 3.12.2 (main, Feb  6 2024, 10:43:05)
[OK] cryptography: Fernet 加解密验证通过
[OK] pycryptodome: AES-CBC 加解密验证通过
=== 所有验证通过，环境搭建成功 ===

3.5 环境架构总览

下图展示了搭建完成的密码学开发环境各组件之间的关系：

3.6 环境管理最佳实践

• 依赖锁定：使用 pip freeze > requirements.txt 记录当前环境的所有依赖版本，便于团队协作和部署复现
• 环境重建：删除 venv 目录后重新执行 python3 -m venv venv && pip install -r requirements.txt 即可重建完全一致的环境
• 多版本 Python：如需测试不同 Python 版本，可使用 pyenv 或 conda 管理多个解释器版本
• IDE 集成：在 VS Code 或 PyCharm 中，将项目解释器指向 ./venv/bin/python（Linux/macOS）或 .\venv\Scripts\python.exe（Windows）