3天搞懂电脑文件加密：从0到1的Python实战项目

别再对着教程点头如捣蒜了，真正上手时还是卡壳？这就是典型的“看了一堆教程还是不会写项目”的困境。很多人收藏了上百篇加密算法文章，但面对自己电脑里的重要资料，依然束手无策。今天咱们不聊虚的，直接上手做一个能跑的实战项目，用Python实现一个本地文件加密工具。哪怕你之前只写过Hello World，跟着敲完也能独立部署。

概念速懂：加密到底在防谁

很多人对加密有误解，觉得就是给文件加个密码。其实，真正的文件加密核心在于密钥管理与算法强度。对于咱们普通用户或运维小白来说，重点不是发明新算法，而是正确使用成熟的标准。

这里必须提一下可信度问题。在CSDN等技术社区，关于AES算法的讨论非常多，但很多帖子只贴代码不讲原理。实际上，AES（高级加密标准）是目前全球公认的安全标准，它由美国国家标准与技术研究院（NIST）制定。我们在写代码时，不需要自己实现AES的底层字节变换，而是调用Python的cryptography库。这个库是业界标准，安全性经过多年验证。

为什么选AES而不是DES或RC4？

DES：密钥太短，已被破解，别用了。
RC4：存在已知漏洞，不安全。
AES：密钥长度可选128/192/256位，目前无已知高效破解方法，性能也足够快。

对于我们的实战项目，目标是实现一个命令行工具，输入文件名和密码，输出加密后的文件。解密时再输一次密码，还原文件。这不仅是练手，更是理解对称加密流程的最佳途径。

环境准备：别让安装坑了你

工欲善其事，必先利其器。在写代码前，确保你的Python环境干净且版本合适。

Python版本：建议使用Python 3.8及以上版本。Python 3.6已停止维护，很多新库不支持。
依赖库：我们需要两个核心库：
- cryptography：提供AES加密算法的实现。
- getpass：标准库，用于在终端输入密码时不回显，保护密码安全。

打开你的终端（Windows用户用PowerShell或CMD，Mac/Linux用户用Terminal），执行以下命令安装依赖：

pip install cryptography

如果安装速度慢，可以换用国内镜像源：

pip install cryptography -i https://pypi.tuna.tsinghua.edu.cn/simple

避坑提示：有些网友反馈在Windows下安装cryptography失败，通常是缺少C编译环境。最简单的方法是直接去官网下载对应系统的预编译Wheel文件，或者升级pip到最新版本再试。如果实在不行，建议改用Anaconda，它自带了大部分科学计算和加密库，省心。

环境装好后，新建一个文件，命名为file_crypto.py，这就是我们要写的实战项目主文件。

核心语法：AES-GCM模式详解

在写完整代码前，先拆解几个关键概念。很多教程只给AES-CBC模式，但我们要用AES-GCM。为什么？

CBC模式：需要初始化向量（IV），且如果IV重复使用或泄露，会有安全隐患。它不提供认证，即无法检测密文是否被篡改。
GCM模式：全称为Galois/Counter Mode，它结合了加密和认证。也就是说，如果有人在传输或存储过程中修改了哪怕一个比特的密文，解密时就会报错。这对于本地文件加密来说，能防止恶意篡改。

在cryptography库中，使用AES-GCM的核心类是Cipher和AesGcm。

关键参数解析：

Key（密钥）：必须为16、24或32字节（对应AES-128、AES-192、AES-256）。我们通常用32字节，即AES-256，安全性最高。
Nonce（随机数）：相当于IV，每次加密必须唯一。GCM模式要求Nonce长度为12字节（96位）是最佳实践。
Associated Data（附加数据）：可选，用于绑定上下文，比如文件名。我们这里暂时不传，保持简单。

重要提醒：密钥不能明文存储！在我们的工具中，密钥是由用户输入的密码派生而来的。这里用到一个算法叫PBKDF2（Password-Based Key Derivation Function 2）。它通过加盐（Salt）和多次迭代哈希，将密码转换成固定长度的密钥。这样即使密码被猜中，没有正确的盐和迭代次数，也推导出密钥。

完整代码示例：从零到可运行

下面是一个完整的、可运行的Python脚本。请仔细查看注释，每一行都有其意义。

import os
import sys
import getpass
from cryptography.fernet import Fernet
from cryptography.hazmat.primitives.kdf.pbkdf2 import PBKDF2HMAC
from cryptography.hazmat.primitives import hashes
from cryptography.hazmat.backends import default_backend# 固定参数
SALT_LENGTH = 16
ITERATIONS = 100000
NONCE_LENGTH = 12
KEY_LENGTH = 32def derive_key(password: str, salt: bytes) -> bytes:"""从密码和盐派生AES密钥"""kdf = PBKDF2HMAC(algorithm=hashes.SHA256(),length=KEY_LENGTH,salt=salt,iterations=ITERATIONS,backend=default_backend())return kdf.derive(password.encode('utf-8'))def encrypt_file(input_path: str, output_path: str, password: str):"""加密指定文件"""if not os.path.exists(input_path):print(f"错误：文件 {input_path} 不存在")return False# 生成随机盐，每次加密都不同salt = os.urandom(SALT_LENGTH)# 派生密钥key = derive_key(password, salt)# 初始化AES-GCM加密器# 注意：cryptography库的AESGCM类直接接受keyaesgcm = AesGcm(key)# 生成随机Noncenonce = os.urandom(NONCE_LENGTH)# 读取原始文件内容with open(input_path, 'rb') as f:plaintext = f.read()# 执行加密，返回密文和标签（认证标签）# GCM模式会自动生成认证标签，附加在密文后ciphertext = aesgcm.encrypt(nonce, plaintext, None)# 写入加密文件：结构为 [Salt][Nonce][Ciphertext+Tag]# 这样解密时才能提取出盐和非对称数with open(output_path, 'wb') as f:f.write(salt)f.write(nonce)f.write(ciphertext)print(f"成功加密 {input_path} -> {output_path}")return Truedef decrypt_file(input_path: str, output_path: str, password: str):"""解密指定文件"""if not os.path.exists(input_path):print(f"错误：文件 {input_path} 不存在")return False# 读取加密文件with open(input_path, 'rb') as f:data = f.read()# 解析结构salt = data[:SALT_LENGTH]nonce = data[SALT_LENGTH:SALT_LENGTH + NONCE_LENGTH]ciphertext = data[SALT_LENGTH + NONCE_LENGTH:]# 派生密钥key = derive_key(password, salt)# 初始化AES-GCM解密器aesgcm = AesGcm(key)try:# 执行解密，如果密码错误或文件被篡改，会抛出异常plaintext = aesgcm.decrypt(nonce, ciphertext, None)# 写入解密后的文件with open(output_path, 'wb') as f:f.write(plaintext)print(f"成功解密 {input_path} -> {output_path}")return Trueexcept Exception as e:print(f"解密失败：密码错误或文件已损坏 ({str(e)})")return Falseif __name__ == "__main__":if len(sys.argv) != 4:print("用法: python file_crypto.py <encrypt|decrypt> <file_path> <output_path>")print("示例: python file_crypto.py encrypt secret.txt secret.enc")sys.exit(1)mode = sys.argv[1]file_path = sys.argv[2]output_path = sys.argv[3]password = getpass.getpass("请输入密码: ")if mode == "encrypt":encrypt_file(file_path, output_path, password)elif mode == "decrypt":decrypt_file(file_path, output_path, password)else:print("未知模式，请选择 encrypt 或 decrypt")

代码逐行解析要点：

os.urandom：生成密码学安全的随机数，比random模块安全得多，必须用于盐和非对称数。
getpass.getpass：输入密码时终端不显示字符，防止旁人窥视。
文件结构：加密文件是二进制格式，前16字节是盐，接下来12字节是Nonce，剩余是密文+标签。这个结构是自定义的，解密时必须严格按此顺序读取。
异常处理：decrypt中捕获了所有异常，因为密码错误、文件截断、篡改都会导致解密失败，必须给用户明确提示。

常见报错与避坑指南

在实际运行这个实战项目时，你可能会遇到几个经典错误。提前知道这些，能省你半天排查时间。

1. ValueError: Invalid key length

原因：派生出的密钥长度不是16、24或32字节。
解决：检查derive_key函数中length参数。代码中已设为32，一般不会出现。如果修改过算法，确保长度符合AES要求。

2. InvalidTag: Decryption failed

原因：这是最常见的错误。可能是密码输错了，或者加密文件被意外修改（比如用记事本打开过二进制文件）。
解决：首先确认密码完全一致（注意大小写）。其次，检查文件大小是否变化。GCM模式对完整性极度敏感，一个比特的差异都会导致此错误。

3. ModuleNotFoundError: No module named 'cryptography'

原因：库没装好，或者Python解释器版本不对。
解决：运行pip show cryptography检查是否安装。如果安装成功但代码报错，检查你运行脚本的Python解释器是否与安装库的解释器一致。建议使用虚拟环境（venv）隔离项目依赖。

4. 性能问题：大文件加密慢

现象：加密几个GB的视频文件时，内存占用高，速度慢。
优化建议：当前代码将整个文件读入内存。对于大文件，应分块（Chunk）加密。但注意，AES-GCM是流式模式，分块加密需要维护状态，实现复杂度较高。对于入门实战项目，建议限制文件大小在100MB以内。若需处理大文件，可考虑使用cffi调用OpenSSL的C接口，或使用分块CBC模式（但需额外处理IV链）。

5. 密码强度问题