第三章 环境配置问题：缺少依赖库或版本冲突
说实话，解密失败的原因里，环境配置问题占了很大比例。我遇到过不少情况，代码逻辑完全是正确的，结果就是跑不起来。最后发现，无非是某个库没装，或者版本不对。
咱们这一章就把这个问题彻底讲透。你想想看，一个C_Decrypt依赖链可能涉及几十个库，任何一个环节出问题，都会导致最终失败。
3.1 依赖库缺失：最常见的坑
说白了，就是你的Python环境里缺少某个必需的包。C_Decrypt会依赖一些基础库，比如 cryptography、pycryptodome、base64 这些典型依赖。
报错信息一般长这样：
ModuleNotFoundError: No module named 'cryptography'
ImportError: No module named 'Crypto'看到这种错误，直接装就完事了：
pip install cryptography
pip install pycryptodomepip list 先把已安装的包列出来，看看是不是真缺失，还是名字拼错了。
不过你得注意，有些库的导入名跟包名不一样。比如 pycryptodome 装完，导入却是 from Crypto。我在项目中遇到过有人以为没装，结果其实是导错了名字。
3.2 版本冲突：隐蔽的对手
版本冲突比缺失更麻烦。装是装了，但版本不对。解密算法对底层库的版本非常敏感。
举个例子：
# 某个旧版解密算法的依赖
cryptography==3.4.8
# 但你环境里装的是最新版
cryptography==39.0.1
# 结果：某些API已经废弃或改了签名
# 解密直接失败为什么会这样？因为库的维护者会更新底层算法实现。C_Decrypt用的某些函数，在旧版里是 param1=xxx，新版可能改成 param2=xxx 了。
我建议你看看项目的 requirements.txt 或者 setup.py。如果项目没有提供，那就看看报错堆栈里提到了哪个库。
| 报错模式 | 可能原因 | 解决办法 |
|---|---|---|
| AttributeError: module 'xxx' has no attribute 'yyy' | 新版API移除了旧接口 | 降级到旧版本，或修改代码适配新版 |
| TypeError: unexpected keyword argument 'zzz' | 函数签名变了 | 查看库的Changelog，调整参数名 |
| RuntimeError: ... is not a valid padding | 加密/解密算法参数不匹配 | 确认C_Decrypt所依赖的算法库版本 |
3.3 虚拟环境：隔离是最好的防御
你想想看，如果你同时做几个项目，每个项目依赖的版本可能都不一样。A项目要旧版 cryptography，B项目要新版。那怎么办？
虚拟环境就是干这个的。我个人强烈建议，每个C_Decrypt项目都开一个独立的虚拟环境。
# 创建虚拟环境
python -m venv decrypt_env
# 激活它
# Windows:
decrypt_env\Scripts\activate
# Linux/Mac:
source decrypt_env/bin/activate
# 然后安装依赖
pip install -r requirements.txt3.4 排查环境问题的清单
嗯，这里要注意。排查环境问题时，我一般按这个顺序来：
- 看错误信息 —— 确认是
ModuleNotFoundError还是ImportError还是AttributeError - 检查当前环境 ——
pip list | findstr crypto（Windows）或pip list | grep crypto（Linux/Mac） - 对比需求文件 —— 看
requirements.txt里的版本是否跟你实际装的一致 - 重建环境 —— 如果搞不清哪个库有问题，干脆删了虚拟环境重新建
cryptography，还是报 No module named 'cryptography.hazmat'。查了半天发现是因为系统PATH里混入了另一个Python的解释器。C_Decrypt实际调用的是另一个Python，那个环境里没装这个库。
3.5 实际场景：C_Decrypt依赖链示例
给你看一个典型的依赖链，C_Decrypt解一个AES-256加密的文件可能需要的库：
# requirements.txt
cryptography==3.4.8
pycryptodome==3.10.1
pycrypto==2.6.1
ecdsa==0.17.0
six==1.16.0
# 注意：pycryptodome和pycrypto不能同时装在高版本
# 它们有部分API冲突这里面最坑的是 pycryptodome 和 pycrypto 的关系。两个库提供了相似的功能，但有些函数名不一样。如果你同时装了它们，C_Decrypt可能会加载错库。
pip show 查看具体库的位置。如果发现同一个库出现在两个地方，那可能是环境混乱了。用 pip uninstall 全部卸载，然后重新安装一次。
3.6 总结：环境问题的本质
说到底，环境配置问题就是「你想要的东西跟实际有的东西不匹配」。要么缺，要么版本不对，要么冲突。解决方法也很直接：
- 缺就装
- 版本不对就锁定版本
- 冲突就隔离
我建议你把项目的依赖写死，别用 cryptography>=3.0 这种宽松写法。直接用 cryptography==3.4.8。这样别人拿到你的代码，装出来的环境跟你的一致，就不会出问题。
好了，这一章的东西其实不复杂。记住一条：遇到解密失败，先看环境。别一上来就怀疑算法逻辑，十有八九是环境问题。我就吃过这个亏，调了半天的代码，最后发现是 pip install 的时候少打了一个字母。