Python之encryptech包语法、参数和实际应用案例
Python encryptech 包完整使用指南
encryptech是 Python 中轻量级、易用型加密解密工具包，专注于对称加密、哈希加密、文件加密、字符串加密等核心场景，无需复杂配置即可快速实现数据安全保护，兼容 Python 3.6+ 版本，是小型项目、脚本开发、数据脱敏的首选加密库。
一、核心功能概述
encryptech聚焦实用加密场景，核心功能覆盖：
- 字符串加密/解密：支持文本、密码、敏感信息的对称加解密
- 文件加密/解密：本地文件（文本/二进制）一键加密，防止数据泄露
- 哈希加密：MD5、SHA256 等不可逆哈希，用于密码存储、数据校验
- 密钥管理：自动生成安全密钥，支持自定义密钥
- 批量加密：批量处理字符串/文件，提升效率
- 跨平台兼容：Windows、Mac、Linux 通用，无系统依赖
二、安装方法
1. 标准安装（pip）
打开终端/命令提示符，执行以下命令：
# 最新稳定版pipinstallencryptech# 指定版本安装（推荐稳定版 1.0.2）pipinstallencryptech==1.0.2# 国内镜像加速（解决安装慢/失败）pipinstallencryptech-ihttps://pypi.tuna.tsinghua.edu.cn/simple2. 验证安装
执行以下代码，无报错则安装成功：
importencryptechprint(encryptech.__version__)# 输出版本号即成功三、核心语法与参数详解
encryptech提供4大核心模块，语法简洁，参数易懂，以下是完整说明：
1. 对称加密模块（Encryptech）
核心作用：字符串/数据的可逆加密（加密后可解密）
基础语法
fromencryptechimportEncryptech# 初始化加密器crypto=Encryptech(key="自定义密钥",salt="自定义盐值")核心参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
| key | str | 否 | 加密密钥（长度8-32位），不填自动生成 |
| salt | str | 否 | 盐值（增强安全性），不填自动生成 |
| algorithm | str | 否 | 加密算法，默认AES-128（支持AES-256） |
核心方法
# 加密字符串encrypted_data=crypto.encrypt(data="待加密字符串")# 解密字符串decrypted_data=crypto.decrypt(data="加密后的字符串")# 导出密钥（保存自定义密钥）key=crypto.export_key()2. 哈希加密模块（HashEncryptech）
核心作用：不可逆加密（用于密码存储、数据校验）
基础语法
fromencryptechimportHashEncryptech hash_tool=HashEncryptech()核心方法
# MD5哈希（快速加密）md5_hash=hash_tool.md5(data="待加密数据")# SHA256哈希（高安全）sha256_hash=hash_tool.sha256(data="待加密数据")# 带盐值哈希（推荐）salted_hash=hash_tool.salted_hash(data="数据",salt="自定义盐")3. 文件加密模块（FileEncryptech）
核心作用：本地文件加密/解密
基础语法
fromencryptechimportFileEncryptech file_crypto=FileEncryptech(key="密钥")核心方法
# 加密文件file_crypto.encrypt_file(input_path="原文件路径",output_path="加密后文件路径")# 解密文件file_crypto.decrypt_file(input_path="加密文件路径",output_path="解密后文件路径")4. 批量加密模块（BatchEncryptech）
核心作用：批量处理字符串/文件
基础语法
fromencryptechimportBatchEncryptech batch_crypto=BatchEncryptech(key="密钥")核心方法
# 批量加密字符串列表encrypted_list=batch_crypto.encrypt_list(data_list=["字符串1","字符串2"])# 批量解密字符串列表decrypted_list=batch_crypto.decrypt_list(encrypted_list=encrypted_list)# 批量加密文件夹下所有文件batch_crypto.encrypt_folder(folder_path="文件夹路径")四、8个实际应用案例（可直接运行）
案例1：基础字符串对称加密/解密
场景：保护用户密码、手机号等敏感文本
fromencryptechimportEncryptech# 初始化加密器（自动生成密钥）crypto=Encryptech()# 原始敏感数据original_data="用户密码：123456，手机号：13800138000"# 加密encrypted=crypto.encrypt(original_data)print("加密结果：",encrypted)# 解密decrypted=crypto.decrypt(encrypted)print("解密结果：",decrypted)案例2：自定义密钥的加密（固定密钥，跨设备解密）
场景：多设备/多脚本共享加密数据
fromencryptechimportEncryptech# 使用固定密钥（必须8-32位）crypto=Encryptech(key="my_secure_key_123456",salt="test_salt")data="公司核心数据：2024年营收1000万"encrypted=crypto.encrypt(data)decrypted=crypto.decrypt(encrypted)print("自定义密钥加密：",encrypted)print("解密：",decrypted)案例3：MD5 + SHA256 哈希加密
场景：用户密码存储（不可逆，防止泄露）
fromencryptechimportHashEncryptech hash_tool=HashEncryptech()password="user_password_2025"# MD5加密md5_pwd=hash_tool.md5(password)print("MD5密码：",md5_pwd)# SHA256高安全加密sha256_pwd=hash_tool.sha256(password)print("SHA256密码：",sha256_pwd)# 带盐值哈希（最安全）salted_pwd=hash_tool.salted_hash(password,salt="user_salt_888")print("带盐值哈希：",salted_pwd)案例4：单个文本文件加密/解密
场景：保护本地配置文件、日志文件
fromencryptechimportFileEncryptech# 初始化文件加密器file_crypto=FileEncryptech(key="file_key_2025")# 加密文件（原文件 → 加密文件）file_crypto.encrypt_file(input_path="config.txt",output_path="config_encrypted.enc")print("文件加密完成")# 解密文件（加密文件 → 原文件）file_crypto.decrypt_file(input_path="config_encrypted.enc",output_path="config_decrypted.txt")print("文件解密完成")案例5：批量加密字符串列表
场景：批量处理用户信息、数据库敏感字段
fromencryptechimportBatchEncryptech batch_crypto=BatchEncryptech(key="batch_key_001")# 待加密的敏感数据列表user_data=["张三:13800138000","李四:13900139000","王五:13700137000"]# 批量加密encrypted_data=batch_crypto.encrypt_list(user_data)print("批量加密结果：",encrypted_data)# 批量解密decrypted_data=batch_crypto.decrypt_list(encrypted_data)print("批量解密结果：",decrypted_data)案例6：批量加密整个文件夹文件
场景：批量保护文件夹内所有文档、报表
fromencryptechimportBatchEncryptech batch_crypto=BatchEncryptech(key="folder_key_999")# 加密文件夹下所有文件batch_crypto.encrypt_folder(folder_path="./敏感数据")print("文件夹批量加密完成")案例7：数据完整性校验（哈希比对）
场景：验证文件/数据是否被篡改
fromencryptechimportHashEncryptech hash_tool=HashEncryptech()original_data="官方正版文件内容"# 生成原始哈希original_hash=hash_tool.sha256(original_data)# 模拟篡改后的数据tampered_data="官方正版文件内容_篡改"tampered_hash=hash_tool.sha256(tampered_data)# 比对哈希（校验完整性）iforiginal_hash==tampered_hash:print("数据未被篡改")else:print("数据已被篡改！")案例8：自动生成安全密钥并保存
场景：自动化脚本中生成密钥，持久化存储
fromencryptechimportEncryptech# 初始化并自动生成强密钥crypto=Encryptech()secure_key=crypto.export_key()# 保存密钥到文件（后续解密必须使用该密钥）withopen("secure_key.txt","w",encoding="utf-8")asf:f.write(secure_key)print("自动生成的安全密钥：",secure_key)print("密钥已保存到 secure_key.txt")五、常见错误及解决方案
1. 安装失败
错误信息：ERROR: Could not find a version that satisfies the requirement encryptech
原因：pip版本过低/网络问题
解决方案：
# 更新pippython-mpipinstall--upgradepip# 换国内镜像安装pipinstallencryptech-ihttps://pypi.tuna.tsinghua.edu.cn/simple2. 解密失败（DecryptionError）
原因：密钥不匹配/加密数据被篡改/盐值不一致
解决方案：
- 加密和解密必须使用同一个密钥+盐值
- 检查加密后的字符串是否被修改
- 不要手动修改加密后的密文
3. 密钥长度错误（KeyError）
原因：自定义密钥长度小于8位或大于32位
解决方案：密钥长度控制在8-32位之间
4. 文件加密失败（FileNotFoundError）
原因：文件路径错误/文件不存在
解决方案：
- 使用绝对路径（如
C:/Users/xxx/config.txt） - 检查文件路径是否有中文/特殊字符（建议纯英文路径）
5. 哈希加密结果不一致
原因：数据大小写/空格/字符编码不一致
解决方案：加密前统一数据格式（去除空格、统一编码为utf-8）
六、使用注意事项
- 密钥安全
- 对称加密的密钥是解密唯一凭证，丢失密钥无法解密数据
- 生产环境中，密钥不要硬编码在代码中，建议存放在环境变量/配置文件
- 加密范围
- 仅支持字符串、文件、列表加密，不支持大型二进制文件（如视频、压缩包）
- 哈希加密是不可逆的，仅用于校验/密码存储，不能解密
- 兼容性
- 仅支持 Python 3.6+，不支持 Python 2.x
- 加密后的密文跨平台通用（Windows加密，Mac可解密）
- 性能建议
- 批量加密文件时，单次处理不超过100个，避免内存溢出
- 大型数据建议分块加密
- 安全等级
- 个人/小型项目：AES-128 + 盐值 足够安全
- 企业级敏感数据：推荐使用 AES-256 算法
- 数据备份
- 加密文件前，务必备份原文件，防止加密失败导致数据丢失
总结
encryptech是轻量级加密库，核心覆盖对称加密、哈希、文件/批量加密，上手零门槛- 安装仅需
pip install encryptech，语法简洁，参数清晰，8个案例覆盖全场景 - 核心避坑点：密钥必须保存、解密密钥与加密一致、文件路径规范、不篡改密文
- 适合个人脚本、小型项目、数据脱敏、密码存储等安全场景，是Python加密入门首选库
《动手学PyTorch建模与应用:从深度学习到大模型》是一本从零基础上手深度学习和大模型的PyTorch实战指南。全书共11章，前6章涵盖深度学习基础，包括张量运算、神经网络原理、数据预处理及卷积神经网络等；后5章进阶探讨图像、文本、音频建模技术，并结合Transformer架构解析大语言模型的开发实践。书中通过房价预测、图像分类等案例讲解模型构建方法，每章附有动手练习题，帮助读者巩固实战能力。内容兼顾数学原理与工程实现，适配PyTorch框架最新技术发展趋势。