Python实现Excel文件加密保护教程-Python教程-PHP中文网

Python实现Excel文件加密保护教程

霞舞

发布： 2025-10-23 13:10:02

原创

224人浏览过

Python实现Excel文件加密保护教程

本教程旨在解决使用python为整个excel文件设置密码的难题，特别是当现有库如`openpyxl`或`xlsxwriter`仅支持工作表保护时。我们将介绍如何结合python生成excel文件与外部工具`msoffice-crypt`，实现对`.xlsx`文件的完整加密，确保文件在分发给客户端时，需输入密码才能打开，从而满足api交付等场景下的安全需求。

在许多业务场景中，通过API向客户端提供数据时，通常需要将数据导出为Excel文件，并对文件本身进行加密保护，以防止未经授权的访问。然而，Python中常用的Excel处理库，如openpyxl和xlsxwriter，主要提供的是工作表（sheet）级别的保护功能，而非整个Excel文件（workbook）的加密。这意味着用户仍然可以打开文件，只是无法编辑受保护的工作表。对于需要文件级密码保护的需求，例如客户端打开文件时弹窗要求输入密码，这些库并不能直接满足。

挑战：Python库的局限性

openpyxl和xlsxwriter等库在创建和修改Excel文件方面功能强大，但在文件加密方面存在固有局限：它们通常只支持设置工作表密码，限制用户对特定单元格或结构的修改，但不能阻止文件被打开。而某些解决方案，如依赖win32com库，虽然可以调用Windows系统的COM接口实现文件加密，但其跨平台兼容性差，在非Windows环境下（如Mac或Linux服务器）无法正常工作，不适合作为API服务的通用解决方案。

解决方案：结合msoffice-crypt实现文件级加密

为了实现对整个Excel文件的密码保护，推荐的方法是利用一个专门的外部工具——msoffice-crypt。这是一个由Herumi开发的开源命令行工具，专注于加密和解密Microsoft Office文件，包括.xlsx格式。其优点在于能够对文件进行真正的加密，使得文件在打开时需要密码，并且具有良好的跨平台特性。XlsxWriter的官方文档也推荐使用此类外部工具来解决文件加密问题。

步骤一：使用Python生成Excel文件

首先，我们需要使用pandas和xlsxwriter（或openpyxl）等库生成一个标准的Excel文件。这个文件在生成时不需要设置任何密码。

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

import pandas as pd

def create_excel_file(data, file_path="output.xlsx"):
    """
    使用pandas生成一个Excel文件。
    :param data: 待写入Excel的数据字典。
    :param file_path: 输出Excel文件的路径。
    """
    df = pd.DataFrame(data)
    # 使用xlsxwriter作为引擎，也可以使用openpyxl
    writer = pd.ExcelWriter(file_path, engine='xlsxwriter')
    df.to_excel(writer, sheet_name='Sheet1', index=False)
    writer.save()
    print(f"Excel文件 '{file_path}' 已创建。")

if __name__ == "__main__":
    sample_data = {
        'Name': ['Alice', 'Bob', 'Charlie'],
        'Age': [30, 24, 35],
        'City': ['New York', 'London', 'Paris']
    }
    create_excel_file(sample_data, "unencrypted_data.xlsx")

登录后复制

步骤二：安装msoffice-crypt工具

msoffice-crypt是一个命令行工具，需要先安装。你可以从其GitHub仓库下载预编译的二进制文件，或者通过包管理器安装（如果可用）。对于大多数Linux系统，可能需要手动编译或下载。

例如，在Linux或macOS上，你可以下载对应的二进制文件并将其添加到系统路径中。

度加剪辑

度加剪辑（原度咔剪辑），百度旗下AI创作工具

查看详情

# 示例：下载并解压（请根据你的系统和最新版本调整URL）
# wget https://github.com/herumi/msoffice/releases/download/v1.0.0/msoffice-crypt-linux-amd64.tar.gz
# tar -xzf msoffice-crypt-linux-amd64.tar.gz
# sudo mv msoffice-crypt /usr/local/bin/

登录后复制

验证安装：

msoffice-crypt --version

登录后复制

步骤三：使用msoffice-crypt加密Excel文件

安装msoffice-crypt后，就可以通过命令行对其进行调用，对生成的Excel文件进行加密。

msoffice-crypt -e -p your_password unencrypted_data.xlsx encrypted_data.xlsx

登录后复制

-e: 表示执行加密操作。
-p your_password: 设置加密密码，请将your_password替换为实际的密码。
unencrypted_data.xlsx: 输入的未加密文件。
encrypted_data.xlsx: 输出的加密后的文件。

执行此命令后，encrypted_data.xlsx文件将需要your_password才能打开。

步骤四：在Python中集成加密过程

为了实现自动化，我们可以在Python脚本中通过subprocess模块调用msoffice-crypt命令，将文件生成和加密流程整合起来。

import pandas as pd
import subprocess
import os

def create_and_encrypt_excel(data, output_filename="report.xlsx", password="MySecurePassword"):
    """
    生成Excel文件并使用msoffice-crypt进行加密。
    :param data: 待写入Excel的数据字典。
    :param output_filename: 输出Excel文件的名称（加密后）。
    :param password: 用于加密Excel文件的密码。
    """
    temp_unencrypted_file = f"temp_{output_filename}"

    # 1. 生成未加密的Excel文件
    df = pd.DataFrame(data)
    writer = pd.ExcelWriter(temp_unencrypted_file, engine='xlsxwriter')
    df.to_excel(writer, sheet_name='Sheet1', index=False)
    writer.save()
    print(f"临时Excel文件 '{temp_unencrypted_file}' 已创建。")

    # 2. 调用msoffice-crypt进行加密
    try:
        # 确保msoffice-crypt在系统路径中，或者提供完整路径
        command = ["msoffice-crypt", "-e", "-p", password, temp_unencrypted_file, output_filename]
        result = subprocess.run(command, capture_output=True, text=True, check=True)
        print(f"Excel文件 '{output_filename}' 已成功加密。")
        print("msoffice-crypt stdout:", result.stdout)
        if result.stderr:
            print("msoffice-crypt stderr:", result.stderr)
    except subprocess.CalledProcessError as e:
        print(f"加密失败: {e}")
        print("msoffice-crypt stdout:", e.stdout)
        print("msoffice-crypt stderr:", e.stderr)
    except FileNotFoundError:
        print("错误: 'msoffice-crypt' 命令未找到。请确保它已安装并位于系统PATH中。")
    finally:
        # 清理临时未加密文件
        if os.path.exists(temp_unencrypted_file):
            os.remove(temp_unencrypted_file)
            print(f"临时文件 '{temp_unencrypted_file}' 已删除。")

if __name__ == "__main__":
    sample_data = {
        'Product': ['Laptop', 'Mouse', 'Keyboard'],
        'Quantity': [10, 50, 30],
        'Price': [1200, 25, 75]
    }
    create_and_encrypt_excel(sample_data, "sales_report.xlsx", "StrongP@ssw0rd!")

登录后复制

注意事项与最佳实践

msoffice-crypt的可用性： 确保msoffice-crypt工具在运行Python脚本的环境中是可执行的，并且其路径已添加到系统的PATH环境变量中，或者在subprocess.run命令中提供其完整路径。
密码管理： 在API或生产环境中，不应将密码硬编码在代码中。应通过环境变量、配置文件或安全的密钥管理服务来获取密码。
临时文件处理： 加密过程会生成一个未加密的临时文件。在加密完成后，务必删除这个临时文件，以避免敏感数据泄露。上述示例代码已包含清理逻辑。
错误处理： 使用subprocess.run时，应捕获subprocess.CalledProcessError和FileNotFoundError等异常，以便在工具执行失败或未找到时提供有意义的反馈。
性能考虑： 对于非常大的Excel文件，加密过程可能会消耗一定的时间。在API响应中，需要考虑这一点，可能需要异步处理或提供进度反馈。
安全性： 虽然msoffice-crypt提供了文件级加密，但密码本身的安全性至关重要。使用强密码，并确保密码在传输和存储过程中是安全的。

总结

通过将Python的数据处理能力与msoffice-crypt的专业加密功能结合，我们能够有效地解决Python原生库在Excel文件级加密方面的局限性。这种两阶段方法——先生成未加密文件，再通过外部工具进行加密——提供了一个灵活且跨平台的解决方案，满足了在API交付等场景下对Excel文件进行安全分发的需求。遵循上述步骤和注意事项，开发者可以构建出健壮且安全的Excel文件导出功能。

以上就是Python实现Excel文件加密保护教程的详细内容，更多请关注php中文网其它相关文章！