python pycryptodome
# 聊聊Python里的加密库：PyCryptodome
今天想和大家分享一个在Python加密领域里经常被用到的库，叫PyCryptodome。如果你在项目里处理过密码、加密文件或者设计过安全通信，很可能已经和它打过交道了。这个库表面上看起来只是一个工具集，但用久了会发现，它背后其实体现了一些对密码学实践的深刻理解。
它到底是什么
PyCryptodome本质上是一个Python的密码学工具包。说直白点，它提供了一大堆函数和类，让你能在自己的程序里实现各种加密、解密、数字签名之类的操作。这个库并不是Python标准库的一部分，需要额外安装，但它几乎成了业界在加密方面的默认选择之一。
它的前身是PyCrypto，一个更早的库。PyCrypto当年用的人很多，但后来逐渐停止了维护，留下了一些安全漏洞和兼容性问题。PyCryptodome可以看作是它的一个积极维护的“分支”，不仅修复了老问题，还加入了很多现代加密算法和特性。有时候在文档里看到这两个名字会有点混淆，但只要记住，新项目用PyCryptodome就对了。
它能解决哪些实际问题
这个库的能力范围挺广的，从最简单的哈希计算到复杂的非对称加密都能覆盖。比如你需要在数据库里存储用户密码，不能存明文，这时候就可以用它的哈希函数来处理。或者你要给本地文件加密，防止别人随便打开，可以用AES这样的对称加密算法。再比如两个系统之间通信，需要验证消息有没有被篡改，数字签名功能就派上用场了。
实际工作中遇到过这样一个场景：一个系统需要定期把一些敏感数据打包，通过公网传输到另一个系统。直接传明文肯定不行，用SSL/TLS当然可以，但有时候环境限制，需要在应用层自己加一层加密。这时候PyCryptodome就很有用了，可以用接收方的公钥加密一个临时生成的对称密钥，再用这个对称密钥加密实际数据，既保证了效率又保证了安全。这种模式其实就是混合加密系统，PyCryptodome提供的各种原语让这种实现变得很直接。
基本使用方式
安装很简单，pip直接搞定。不过要注意，如果系统里还有老的PyCrypto，可能会有冲突，一般建议先卸载旧的再装新的。
用的时候，通常是从某个子模块导入需要的类或函数。比如计算SHA256哈希，就从Crypto.Hash里导入SHA256。做AES加密，就从Crypto.Cipher里导入AES。这种按功能分模块的设计，让代码结构比较清晰。
举个具体例子，假设要加密一段文本。首先得生成一个密钥，对于AES-256来说，需要32字节的密钥。然后创建一个cipher对象，选择合适的工作模式，比如CBC模式。加密前还需要一个初始化向量，这个向量不需要保密，但最好是随机的，并且每次加密都应该不同。加密后的结果通常是字节串，为了存储或传输，经常会编码成base64。
解密过程类似，用同样的密钥和初始化向量创建cipher对象，然后调用解密方法。需要注意的是，所有参数都要和加密时保持一致，差一个字节都不行。
数字签名也常用到。生成一对公私钥，用私钥签名数据，对方用公钥验证签名。PyCryptodome支持RSA、ECC等多种算法，可以根据需要选择。
一些值得注意的实践细节
加密这东西，用对了很安全，用错了反而可能给人虚假的安全感。有些细节容易忽略，但挺重要的。
比如密钥管理，代码里硬编码密钥是大忌。应该从环境变量或配置服务获取，并且要有定期轮换的机制。初始化向量必须随机，不能重用，用随机数生成器生成，不要自己随便写个固定值。
选择算法和参数时要考虑当前的安全建议。今天认为安全的算法，过几年可能就不推荐了。比如AES-128现在还是安全的，但有些场合已经开始推荐AES-256了。工作模式也有讲究，ECB模式有缺陷，一般不建议用，CBC或GCM模式更常见。
错误处理要小心。加密解密失败时抛出的异常，最好不要直接展示给最终用户，可能会泄露信息。日志里也要注意，不要记录敏感数据或密钥片段。
性能方面，对称加密通常很快，非对称加密就比较慢。所以实践中经常用非对称加密来保护对称密钥的传输，然后用对称加密处理大量数据。这种混合模式在PyCryptodome里很容易实现。
还有一点，这个库虽然提供了底层原语，但有些高级功能需要自己组合实现。比如PBKDF2密钥派生函数，可以用来从密码生成加密密钥，增加暴力破解的难度。这些组合使用的方式，需要一些密码学基础知识才能用得好。
和其他方案的比较
Python里做加密的库不止这一个，各有特点。
标准库里有hashlib和hmac，但只覆盖了哈希和消息认证码，对称加密和非对称加密都没有。cryptography是另一个流行的第三方库，API设计更现代，有些高级功能封装得更好，但PyCryptodome在某些底层控制上更灵活。
如果只是计算哈希，hashlib就够用了。如果需要完整的加密功能，PyCryptodome和cryptography都可以考虑。选择哪个，有时取决于项目历史依赖，有时取决于开发团队对哪个更熟悉。
和那些用C/C++写的加密库相比，PyCryptodome的性能在大多数场景下都够用，毕竟很多核心操作也是用C实现的。只有在极端性能要求的场景下，才需要考虑直接调用更底层的库。
总的来说，PyCryptodome是一个平衡了功能、性能和易用性的选择。它不追求最花哨的API设计，但该有的都有，文档也还算清晰。对于大多数Python项目来说，如果需要加密功能，它都是一个可靠的选择。
加密本身是个复杂领域，工具只是工具，关键还是使用工具的人要对基本概念有理解。PyCryptodome这样的库，把复杂的算法包装成了相对简单的接口，让开发者能更专注于业务逻辑，而不是数学细节。这种抽象，正是它的价值所在。