本教程详细介绍了如何使用 python 的 cryptography 库中的 fernet 模块实现文件的加密与解密操作。文章将涵盖 fernet 密钥的生成、管理与重用，以及如何在文件中安全地执行加密和解密过程，并强调密钥安全存储的重要性，确保数据机密性。

1. 引言：cryptography.fernet 简介

在信息安全日益重要的今天，对敏感数据进行加密是保护其机密性的基本手段。Python 的 cryptography 库提供了一套强大且易于使用的加密工具，其中 fernet 模块是实现对称加密的理想选择。Fernet 是一种基于 AES 算法的对称加密方案，它确保了消息的认证性、完整性和机密性，并且易于集成到应用程序中。

Fernet 的核心原理在于使用一个共享的密钥进行数据的加密和解密。这意味着，加密数据所使用的密钥必须与解密数据所使用的密钥完全一致。如果密钥丢失或泄露，数据将无法恢复或面临被未授权访问的风险。

2. 核心概念：密钥生成与 Fernet 实例

在使用 Fernet 进行文件加密和解密之前，我们需要理解其两个关键概念：密钥生成和 Fernet 实例的创建。

2.1 密钥生成

Fernet 密钥是一个32字节的 URL 安全的 Base64 编码字符串。它是对称加密的基础，必须严格保密。通过 Fernet.generate_key() 方法可以生成一个全新的密钥。

立即学习“Python免费学习笔记（深入）”；

from cryptography.fernet import Fernet

# 生成一个 Fernet 密钥
key = Fernet.generate_key()
print(f"生成的 Fernet 密钥 (Base64编码): {key.decode()}")

重要提示： 每次调用 Fernet.generate_key() 都会生成一个全新且不同的密钥。对于需要持久化加密的数据，您必须将生成的密钥保存下来并在后续的解密操作中重用它。

2.2 Fernet 实例创建

拥有密钥后，您可以使用它来创建一个 Fernet 实例。这个实例将用于执行实际的加密和解密操作。

站长俱乐部购物系统

功能介绍：1、模块化的程序设计，使得前台页面设计与程序设计几乎完全分离。在前台页面采用过程调用方法。在修改页面设计时只需要在相应位置调用设计好的过程就可以了。另外，这些过程还提供了不同的调用参数，以实现不同的效果；2、阅读等级功能，可以加密产品，进行收费管理；3、可以完全可视化编辑文章内容，所见即所得；4、无组件上传文件，服务器无需安装任何上传组件，无需支持FSO，即可上传文件。可限制文件上传的类

0 查看详情

# 使用生成的密钥创建 Fernet 实例
cipher = Fernet(key)

3. 文件加密与解密操作

Fernet 实例提供了 encrypt() 和 decrypt() 方法来处理字节数据。对于文件操作，我们通常需要以二进制模式读取文件内容，进行加密或解密，然后再将处理后的内容写入文件。

3.1 原地加密与解密实现

以下代码示例展示了如何在一个函数中实现文件的原地（in-place）加密和解密。这意味着文件内容会被直接替换为加密或解密后的数据。

import os
from cryptography.fernet import Fernet
from cryptography.fernet import InvalidToken # 用于处理解密失败异常

def process_file_in_place(filename: str, cipher: Fernet, action: str, debug: bool = False):
    """
    对文件内容进行原地加密或解密。

    Args:
        filename (str): 要处理的文件路径。
        cipher (Fernet): Fernet 加密实例。
        action (str): 操作类型，可以是 "encrypt" 或 "decrypt"。
        debug (bool): 是否在加密后打印加密内容。
    """
    # 以二进制读写模式打开文件 (rb+ 允许读写，文件指针初始在开头)
    with open(filename, "rb+") as data_file:
        content = data_file.read() # 读取文件所有内容

        # 根据指定操作执行加密或解密
        processed_content = b""
        if action == "encrypt":
            processed_content = cipher.encrypt(content)
            if debug:
                print(f"加密后的内容 (bytes): {processed_content}")
        elif action == "decrypt":
            try:
                processed_content = cipher.decrypt(content)
                if debug:
                    print(f"解密后的内容 (bytes): {processed_content}")
            except InvalidToken:
                print(f"错误: 无法解密文件 '{filename}'。可能是密钥不匹配或数据已损坏。")
                return # 解密失败，退出函数
        else:
            raise ValueError("操作类型必须是 'encrypt' 或 'decrypt'")

        # 将文件指针移到文件开头
        data_file.seek(0)
        # 写入处理后的内容
        data_file.write(processed_content)
        # 如果新内容比旧内容短，则截断文件，确保文件大小正确
        data_file.truncate()

if __name__ == "__main__":
    test_filename = "example_data.txt"
    original_text = "Hello, world! This is a secret message that needs to be protected."

    # 1. 创建一个原始的明文文件
    with open(test_filename, "w", encoding="utf-8") as f:
        f.write(original_text)
    print(f"原始文件 '{test_filename}' 内容: {original_text}")

    # 2. 生成一个 Fernet 密钥并创建实例
    # 注意：此密钥仅用于本次运行，实际应用中需要持久化存储
    key_for_example = Fernet.generate_key()
    cipher_for_example = Fernet(key_for_example)
    print(f"生成的 Fernet 密钥 (Base64编码): {key_for_example.decode()}")

    # 3. 加密文件
    print("\n--- 执行加密 ---")
    process_file_in_place(test_filename, cipher_for_example, "encrypt", debug=True)
    with open(test_filename, "rb") as f:
        print(f"加密后文件 '{test_filename}' 的二进制内容 (部分): {f.read()[:50]}...") # 只打印前50字节

    # 4. 解密文件
    print("\n--- 执行解密 ---")
    process_file_in_place(test_filename, cipher_for_example, "decrypt")
    with open(test_filename, "r", encoding="utf-8") as f: # 解密后内容可按文本读取
        decrypted_text = f.read()
    print(f"解密后文件 '{test_filename}' 内容: {decrypted_text}")

    # 5. 验证解密内容是否与原始内容匹配
    assert decrypted_text == original_text
    print("\n验证成功：解密内容与原始内容一致。")

    # 清理测试文件
    if os.path.exists(test_filename):
        os.remove(test_filename)

代码解析：

• open(filename, "rb+")：以二进制读写模式打开文件。r 表示读，b 表示二进制，+ 表示同时允许写操作。文件指针初始位于文件开头。
• data_file.read()：读取文件的全部内容。对于大文件，可能需要分块读取和处理。
• cipher.encrypt(content) / cipher.decrypt(content)：执行加密或解密操作。这些方法接受并返回字节串（bytes）。
• data_file.seek(0)：将文件指针重新定位到文件开头，以便从头开始写入新内容。
• data_file.write(processed_content)：将加密或解密后的内容写入文件。
• data_file.truncate()：非常重要！ 如果新写入的内容比原始内容短，文件末尾可能会保留旧数据。truncate() 方法会将文件截断到当前文件指针位置，从而清除多余的旧数据。

4. 密钥管理：持久化与重用

在实际应用中，每次运行程序都生成新密钥是不可行的。为了能够在不同时间点或不同程序实例之间加密和解密数据，密钥必须被持久化存储并重用。

4.1 正确的密钥持久化方法

正确的密钥持久化

以上就是Python cryptography.fernet 实现文件加密与解密教程的详细内容，更多请关注其它相关文章！

# 程序设计  # 戏说seo  # 崇明品牌网站建设  # 拼多多如何进行营销推广  # 松原seo优化找哪家  # 黄骅seo电话  # 珠海抖音营销推广方法  # 临沂网络推广营销公司  # 超市应该如何推广营销  # 昆山网站推广系统  # 项目营销策划推广方案  # 是一个  # 运算符  # 上传文件  # python  # 创建一个  # 机密性  # 显存  # 购物系统  # 文件加密  # elif  # crypto  # 持久化存储  # 敏感数据  # ai  # 工具  # 字节  # 编码 

相关栏目： 【 科技资讯46185 】 【 网络学院92790 】

相关推荐： 虚幻5科幻题材ARPG大作遭取消！本是《奇异人生》厂商新作  为什么简单的XML文件也会解析失败？ 检查隐藏的非打印字符（如BOM）的方法  TikTok国际版网页端快速入口 TikTok全球版短视频浏览教程  Vue.js 图片显示异常排查：理解应用挂载范围与DOM ID唯一性  Django表单验证失败时保留用户输入数据的最佳实践  大麦的“候补”是什么意思 大麦候补购票规则【详解】  2306选座时如何选靠窗位置_12306选座靠窗座位查看方法解析  j*a toString()的覆盖  Selenium Python中处理点击后新窗口加载冻结问题的策略与实践  解决Django多数据库/多Schema环境下外键迁移问题  网易大神怎么保存别人动态的图片_网易大神动态图片保存方法  夸克浏览器网页版最新地址 夸克浏览器官方入口合集  如何在Python中使用Optional类型处理可变对象并避免Pylint警告  荣耀Play7T运行卡顿解决_荣耀Play7T性能优化  《刺客信条：影》PS5 Pro和Switch 2画面对比  win11如何加载ICC颜色配置文件 Win11校色文件安装与显示器色彩管理【指南】  谷歌邮箱注册显示错误Gmail服务器异常与延迟处理  Mac怎么锁定备忘录_Mac备忘录加密设置教程  抖音未来赚钱的新趋势 2025年值得关注的变现风口分析  如何将一个大型PHP应用拆分为多个Composer包_微服务与模块化架构的Composer实践  单射、满射与双射的关系 一文理清所有逻辑  红果短剧网页版官网入口 官方最新网址发布  “在文档元素之后找到了标记”是什么错误？ 检查并修复XML中多个根元素的3个方法  漫蛙MANWA漫画主页官方入口 漫蛙漫画最新在线阅读地址  css卡片内容溢出如何处理_使用overflow隐藏或scroll显示内容  苹果手机如何防止被恶意App追踪  Composer如何处理Git子模块（submodule）依赖_Composer与Git Submodule的对比与选择  qq游戏网页版直接玩_qq游戏免下载快速入口  冬*霸灯泡不亮怎么办_浴霸取暖灯一盏不亮的灯座清洁修复法  zookeeper 都有哪些功能？  LINUX的I/O重定向是什么_深入理解LINUX中 >、>> 与 < 的区别  Golang如何使用bytes.Split分割字节切片_Golang bytes切片分割方法  如何使用Go和Martini动态服务解码后的图片  Yandex浏览器官方网页版入口 Yandex浏览器最新版官网  蛙漫漫画免费阅读入口_蛙漫官方正版无广告纯净版  文心一言怎样用插件调度API数据_文心一言用插件调度API数据【API调用】  c++ dfs和bfs代码 c++深度广度优先搜索算法  Golang如何使用new_Go new分配内存机制讲解  离线运行Go语言之旅：本地部署与GOPATH配置指南  J*aScript中管理异步API调用：确保操作顺序与数据一致性  抖音小游戏合成大西瓜免费秒玩入口链接 抖音小游戏热门合集秒玩网站  响应式CSS Grid布局：优化网格项在小屏幕下的堆叠与宽度适配  响应式图片在网页设计中的正确实现方法  Python Socket多播通信中指定源IP地址的实践指南  Golang并发任务中错误如何聚合_Golang goroutine error收集方式  MAC怎么在地图App里使用“四处看看”_MAC体验部分城市的3D实景街景  搜狗浏览器如何使用密码生成器创建强密码 搜狗浏览器内置密码安全工具  魅族17怎样用浏览器译外语网页_iPhone魅族17浏览器译外语网页【即时翻译】  MAC的“快捷指令”怎么同步到iPhone_MAC利用iCloud同步所有设备的自动化指令  2026春节假期票务安排_2026春节放假购票指南