如果你经常用 Excel 做数据分发，大概遇到过这种尴尬：整理好的统计表发出去，第二天就被同事改了公式，月底汇总时 Excel 打开一片#VALUE!；或者你只想让团队在指定区域填入内容，结果收到表格时，A 列的字段说明、标题格式全被覆盖了。手动在 Excel 里点“审阅 -> 保护工作表 -> 设置密码”其实不难，难的是流程重复，因为一次操作只对一份文件生效，几十份文件一轮处理下来，点鼠标点到手酸。
Python 恰好能把这类机械操作变成可重复执行的脚本。但先说一个判断：用 Python 做 Excel 保护，真正的价值不是“替代你点两下鼠标”，而是批量化、分层化和可审计化。它可以帮你做到：同一套规则应用到所有报表、只读区域和可编辑区域精确控制、密码策略固化进代码而不是依赖人的记忆。
在正式敲代码之前，需要先分清 Excel 保护的几个层次：工作表保护、工作簿结构保护、文件打开密码。很多人把这三者混为一谈，以为自己给工作表加了密，实际上内容在文件里仍然是明文；也有人反过来，想用 openpyxl 给 xlsx 设置文件打开密码，结果发现库根本没有这个能力。本文会把这几个边界讲清楚，再分别给出添加保护与解除保护的 Python 实现，最后补充常见问题和工程安全建议。
1. Excel 保护到底保护了什么：先分清三个层次
接触 Excel 自动化时，第一个容易踩的坑就是“保护”这个词的多义性。在 Excel 体系里，保护一共有三种完全不同的含义。
1.1 工作表保护：保护单元格内容不被修改
工作表保护是最常用的一种保护。它的作用是限制使用者修改工作表里的内容，比如不能编辑锁定单元格、不能删除行、不能插入列。启用后，其他人打开工作表只能查看，无法直接改动内容，除非先取消保护。
这里的关键认知是：工作表保护并不对文件内容做加密。单元格里的数字、文本、公式都还清清楚楚地写在 XML 文件里，用压缩包工具打开 xlsx 就能看到。工作表保护的定位是“防误操作”，不是“防盗窃”。如果有人拿到了文件，他其实有很多办法能改内容，只是在 Excel 界面里不能顺手改而已。
1.2 工作簿结构保护：防止增删和移动工作表
工作簿结构保护针对的不是单元格，而是工作簿的“框架”。启用后，使用者不能插入新的工作表、不能删除已有工作表、不能重命名工作表，也不能调整工作表顺序。
它解决的典型场景是模板文件保护：你想让用户往某个 sheet 填数据，但不想让他们顺手删掉“参数说明”表，也不想让最终交付的 Excel 里多出好几个叫“Sheet1副本”的奇怪页面。
1.3 文件打开密码：真正的文件级加密
当你给 Excel 文件设置“打开密码”后，整个文件内容会被 OOXML 容器加密机制处理。此时不输密码，Excel 根本打不开，这也意味着第三方库在没有密码的情况下无法解析文件内部结构。
三者的区别可以用一张表总结：
| 保护类型 | 保护对象 | 是否加密内容 | 无密码时在 Excel 中表现 | 典型解除方式 |
|---|---|---|---|---|
| 工作表保护 | 单元格内容与操作 | 否 | 可打开查看，不能编辑锁定区域 | 关闭保护标记或输入密码 |
| 工作簿结构保护 | 工作表数量与顺序 | 否 | 可查看数据，不能增删移动 sheet | 关闭结构保护标记或输入密码 |
| 文件打开密码 | 整个文件 | 是 | 无法打开，提示输入密码 | 输入正确密码解密，或找回密码 |
很多人在网上提问“Python 怎么给 Excel 加打开密码”，用的库是 openpyxl，这其实是走错了方向。openpyxl 处理的是 xlsx 内部结构，它的工作对象是已经可以被解包访问的 XML 文件。文件级加密发生在更外层，需要由 msoffcrypto 这类库或者 Office 客户端来完成。
2. 为什么值得用 Python 来处理这类操作
理解了三个层次之后，下一个问题是：既然 Excel 自带的菜单就能保护工作表，为什么还要写 Python 脚本？
第一个原因是批量。假如你每个月要生成 30 份分区域报表，每份报表都要把“标题行”锁死、把“数据区”开放给用户编辑、再设置相同的保护密码。手动操作需要重复 30 次“审阅 -> 保护工作表 -> 设置密码”，中间还可能因为某一份文件忘了点保存而漏掉。脚本则可以把规则定义一次，循环执行。
第二个原因是规则统一。手工设置容易发生“A 报表允许排序，B 报表又不允许排序”这类不一致。代码里如果明确写出每份表启用哪些权限、关闭哪些权限，最终交付的所有文件行为就是一致的，这比依赖人工记忆要可靠得多。
第三个原因是可审计。保护密码、文件内容、操作历史都应该能追溯到源头。通过脚本集中处理时，这些规则以代码形式保存在仓库中，团队成员可以 review，后续交接也更容易。Excel 菜单里的操作往往是“点了就完了”，事后很难复盘到底哪一步设置错了。
当然，也不是所有场景都适合用 Python。如果你只是临时处理单份文件，而且这台电脑上没装 Python 环境，那打开 Excel 手工点几下往往更快。我的判断是：当你的需求里出现“每次”“每月”“几十份”“统一规则”这些词时，就值得把脚本写起来。
3. Python 环境准备与依赖安装
正式写实现之前，先把环境准备好。需要安装的依赖取决于你要实现的功能：
- openpyxl：负责读写 xlsx 文件、设置工作表保护和工作簿结构保护。
- msoffcrypto-tool：负责处理已经带有打开密码的文件，在知道密码的情况下解密。
- pywin32：可选，只有需要在 Windows 本机调用 Office 客户端、直接生成带打开密码的文件时才安装。
建议使用 Python 3.8 及以上版本。安装命令如下：
python -m pip install openpyxl msoffcrypto-tool如果网络较慢，可以临时切换到国内镜像源再安装：
python -m pip install openpyxl msoffcrypto-tool -i https://pypi.tuna.tsinghua.edu.cn/simple需要用到 Office COM 自动化时，再单独安装 pywin32：
python -m pip install pywin32安装完成后，可以先用几行代码确认环境可用，同时查看本机 openpyxl 的实际版本：
import openpyxl print("openpyxl version:", openpyxl.__version__)输出的版本号会因安装时间不同而变化，只要正常打印出版本信息就说明导入成功。后续示例不依赖某个特定小版本，只要 openpyxl 3.x 即可。
如果代码运行后提示ModuleNotFoundError: No module named 'openpyxl'，优先检查当前终端使用的是不是安装依赖时对应的 Python 解释器，特别是在多个 Python 环境并存的机器上，容易把包装进 A 环境、又在 B 环境运行。
4. 场景一：给工作表添加保护与解除保护
现在进入核心操作。第一个场景是保护工作表中的单元格内容，让它不能被直接修改。
4.1 最小保护示例
创建一个新的 xlsx 文件，写入几个示例数据，然后开启工作表保护。
from openpyxl import Workbook wb = Workbook() ws = wb.active ws.title = "销售数据" # 写入两行示例数据 ws.append(["日期", "销售额", "备注"]) ws.append(["2025-01-01", 1200, "线下渠道"]) ws.append(["2025-01-02", 890, "线上渠道"]) # 开启工作表保护 ws.protection.sheet = True ws.protection.password = "123456" wb.save("protected_sheet.xlsx")运行后会生成protected_sheet.xlsx。用 Excel 打开这张表，你会发现单元格可以选中、可以查看，但一旦试图修改内容，Excel 会提示“您试图更改的单元格或图表受保护，因而为只读”。
这段代码里最重要的属性是ws.protection.sheet = True。它相当于在 Excel 界面里点击了“保护工作表”。password用来设置保护密码，注意这里的密码在保存时会以哈希形式写入文件，而不是明文，所以不要指望在 XML 里看到123456这几个字符。
4.2 允许使用者进行部分操作
默认情况下，启用工作表保护后，使用者仍可以选中单元格、滚动查看内容。如果你想修改“允许使用者做什么”的规则，需要设置 SheetProtection 对象上的其他属性。
例如，允许用户使用自动筛选和排序，但不允许修改单元格内容：
from openpyxl import Workbook wb = Workbook() ws = wb.active ws.append(["日期", "销售额"]) ws.append(["2025-01-01", 1200]) ws.append(["2025-01-02", 890]) # 开启自动筛选，便于用户自行过滤数据 ws.auto_filter.ref = ws.dimensions # 开启工作表保护 ws.protection.sheet = True ws.protection.password = "123456" # 这两种操作在保护状态下仍然允许 ws.protection.sort = False ws.protection.autoFilter = False wb.save("protected_with_filter.xlsx")这里需要解释一个容易混淆的点：在 openpyxl 的 SheetProtection 对象中，sort和autoFilter默认是False。当对应值为False时，Excel 会允许用户执行排序和使用自动筛选操作。这正好对应 Excel 保护对话框里的那一组复选框逻辑：勾选表示允许，不勾选表示禁止。
真正容易踩坑的地方在于，这些属性不是“启用某项功能”，而是“在保护状态下仍然放行某项能力”。如果只是把工作表保护打开，完全没有设置这些属性，用户在 Excel 里依然能排序，这一点和很多人以为的“保护了就不能排序”并不一样。
保护状态下的权限配置，建议在交付前至少做一次人工验证，用 Excel 打开生成的文件，实际试一下能否编辑、能否筛选、能否插入行。
4.3 解除工作表保护
解除工作表保护有两种情况。第一种比较简单：你记得保护密码，那么直接在 Excel 里点击“撤销工作表保护”并输入密码即可；如果希望通过 Python 批量解除，可以先把文件读进来，然后关闭保护标记。
from openpyxl import load_workbook wb = load_workbook("protected_sheet.xlsx") ws = wb["销售数据"] ws.protection.sheet = False ws.protection.password = None wb.save("unprotected_sheet.xlsx")这里需要说明一个边界：openpyxl 在加载文件时并不会校验工作表保护密码。但如果你拿到的是别人的文件，请先获得授权再执行这类操作。本文提供的技术只能用于处理自己创建的、或已经合法授权的 Excel 文件，不能用于解除他人设置的访问控制。
另外，如果是自己遗忘了工作表保护密码，由于工作表保护本身并不加密内容，从文件结构层面关闭保护标记是可行的。但请理解，这不是“破解密码”，而是重新生成一份不包含保护标记的文件。是否被允许，完全取决于你是不是文件内容的合法处理者。
5. 场景二：部分单元格锁定，其他区域允许编辑
“完全保护”只是最简单的一层。实际业务里更常见的是“只读区域 + 可填写区域”的混合模板。比如一张费用报销表：报销人信息、项目名称可以填，但金额合计列、税率列、校验规则一定要锁死。
Excel 的单元格保护规则是：只有当“工作表保护开启 + 单元格锁定状态为 True”时，这个单元格才是只读的。默认情况下，所有单元格的locked属性都是 True，因此一旦开启工作表保护，整张表就全部只读了。
要实现混合效果，需要在开启工作表保护之前，先把允许用户编辑的单元格设成locked=False。
from openpyxl import Workbook from openpyxl.styles import Protection wb = Workbook() ws = wb.active ws.title = "报销模板" # 构建表头 ws["A1"] = "项目说明" ws["B1"] = "金额" ws["C1"] = "备注" # 样例数据行：这些行允许填写 for row in range(2, 11): ws.cell(row=row, column=1).protection = Protection(locked=False) ws.cell(row=row, column=2).protection = Protection(locked=False) ws.cell(row=row, column=3).protection = Protection(locked=False) # 表头保持默认锁定状态，无需额外设置 # 最后开启工作表保护 ws.protection.sheet = True ws.protection.password = "123456" wb.save("editable_template.xlsx")打开生成的模板后，A 到 C 列的第 2 到第 10 行是可以输入的，表头和其他未解锁区域则处于只读状态。
这个场景在金融、财务和项目管理类表格中特别实用。建议把整个模板的“可编辑区域”统一规划清楚，不要把每个单元格的锁定状态散落在代码各处。项目里如果连续多个 sheet 都需要同样的规则，可以封装成函数：
from openpyxl.styles import Protection def unlock_range(ws, min_row=1, max_row=10, min_col=1, max_col=3): for row in ws.iter_rows(min_row=min_row, max_row=max_row, min_col=min_col, max_col=max_col): for cell in row: cell.protection = Protection(locked=False)这样代码会更直观，后续维护时不需要在一百行代码里逐个找单元格赋值。
6. 场景三：工作簿结构保护与解除
前面提到过，工作表保护关心的是单元格内容，工作簿结构保护关心的是 Sheet 本身的数量和顺序。如果一个工作簿里有“数据录入”这个 sheet 也有“参数表”这个 sheet，你不想让对方删除参数表，就可以给工作簿加上结构保护。
6.1 添加工作簿结构保护
openpyxl 对工作簿结构保护的支持封装在WorkbookProtection中：
from openpyxl import Workbook from openpyxl.workbook.protection import WorkbookProtection wb = Workbook() ws = wb.active ws.title = "数据录入" # 再建一张参数表 param_ws = wb.create_sheet("参数表") param_ws["A1"] = "税率" param_ws["B1"] = 0.06 # 开启工作簿结构保护 wb.security = WorkbookProtection( lockStructure=True, workbookPassword="123456" ) wb.save("structure_protected.xlsx")注意，lockStructure=True只禁止增删、隐藏、重命名工作表。它不会阻止用户在 sheet 内修改单元格，所以通常需要和工作表保护配合使用。
文件生成后，在 Excel 界面里点击“审阅 -> 保护工作簿”，你能看到结构保护状态被启用。试着右键点击“数据录入”这个 sheet 标签，在弹出的菜单里，删除、重命名、移动或复制都会变成灰色不可用状态。
6.2 解除工作簿结构保护
解除结构保护的代码同样直接：
from openpyxl import load_workbook wb = load_workbook("structure_protected.xlsx") wb.security.lockStructure = False wb.security.workbookPassword = None wb.save("structure_unprotected.xlsx")如果只是临时解除一会，建议另存为新文件，避免处理失败导致原文件被破坏。结构保护虽然看起来不如工作表保护常用，但在“模板文件对外分发”“报表自动生成”这些场景中价值很高，毕竟一个参数表被误删造成的返工成本，往往远高于设置这层保护的时间成本。
7. 场景四：处理带打开密码的加密 xlsx
文章开头已经强调过：openpyxl 不能用于生成带打开密码的 xlsx，也不能读取未被解密的加密文件。那么，如果你手里有一个加了打开密码的 Excel，如何在 Python 中处理？
7.1 知道密码时解密
如果你拥有这个文件，也知道打开密码，可以使用 msoffcrypto-tool 生成一个解密后的副本：
import msoffcrypto with open("encrypted_input.xlsx", "rb") as f: office_file = msoffcrypto.OfficeFile(f) if office_file.is_encrypted(): # 输入正确的文件打开密码 office_file.load_key(password="YourPassword", verify_password=True) with open("decrypted_output.xlsx", "wb") as out: office_file.decrypt(out) print("解密完成，已输出为 decrypted_output.xlsx") else: print("该文件并未加密，无需解密")这里的verify_password=True会在加载密码时先做一次校验，如果密码错误会直接抛出异常，而不会生成一个损坏的空文件。解密输出的新文件可以用 openpyxl 正常读取，再结合前面的保护逻辑进行批量处理。
需要特别提醒的是：msoffcrypto 处理的是文件级加密，核心能力是解密后读取，不是破解工具。如果密码丢失，这个库并不能帮你“找回来”。遇到遗忘密码的情况，优先查找备份或密码管理工具，而不是在互联网上寻找所谓爆破方案。
7.2 在 Windows 本机生成带打开密码的 xlsx
如果你确实需要在脚本里生成一个带打开密码的 xlsx，而且运行环境是 Windows 且安装了 Microsoft Office，可以通过 pywin32 调用 Excel COM 组件来完成。这个方案不适合 Linux 服务器，也不适合没有安装 Office 的环境。
import win32com.client as win32 excel = win32.gencache.EnsureDispatch("Excel.Application") excel.Visible = False excel.DisplayAlerts = False # 打开已有工作簿 book = excel.Workbooks.Open(r"C:\tmp\clear_report.xlsx") # 另存为带密码的 xlsx # FileFormat=51 表示 xlsx 格式 book.SaveAs( Filename=r"C:\tmp\encrypted_report.xlsx", FileFormat=51, Password="YourPassword" ) book.Close() excel.Quit()这段代码在保存时会给新文件设置文件打开密码。运行时屏幕上可能会短暂出现 Excel 进程，建议放到专门执行办公自动化的机器上，并确认路径里没有非法字符。
COM 自动化退出后，偶尔会有 Excel 进程残留。可以在 Python 脚本末尾增加进程清理逻辑，或者至少确认book.Close()和excel.Quit()都执行到了。更保险的做法是用try...finally包裹操作，避免中间抛错时 Office 进程一直挂在后台。
8. 常见问题与排查思路
实践过程中，你可能会遇到下面这些现象。整理成表格方便对照排查：
| 问题现象 | 可能原因 | 排查方式 | 解决方案 |
|---|---|---|---|
load_workbook报BadZipFile | 文件不是标准 xlsx，或已被文件级加密 | 尝试用 Excel 手动打开，确认是否需要密码 | 先用 msoffcrypto 解密，再交给 openpyxl |
| 工作表保护后仍能修改单元格 | 忘记先设置ws.protection.sheet = True | 检查代码中是否真正启用了保护标记 | 设置ws.protection.sheet = True后再保存 |
| 保护后单元格能改，但筛选不能用了 | 权限属性配置不当 | 检查 SheetProtection 中sort、autoFilter的值 | 将需要放行的能力显式设为False |
| 解除了保护但 Excel 打开仍提示只读 | 文件名可能被标记为“建议只读”或文件权限只读 | 查看文件属性，检查是否处于只读状态 | 取消文件系统只读属性，或检查 Office 信息保护策略 |
| 生成的文件打不开或提示需要修复 | openpyxl 版本过旧，或写入参数不兼容 | 升级 openpyxl 到最新版本 | python -m pip install -U openpyxl |
| COM 自动化后 Excel 进程不退出 | 中途异常导致Quit()未执行 | 打开任务管理器查看 EXCEL.EXE 进程 | 用try...finally保证退出，必要时结束残留进程 |
排查这类问题有一个共同原则：先缩小边界。同样是“不能保存”，可能是因为文件被 Excel 占用、也可能是因为没有权限写目录、还可能是因为保护逻辑写错了，不要在代码层面反复试，先确认当前文件的真实可写状态。
9. 安全边界与工程化建议
技术能力只是其中一半，另一半是使用边界。处理 Excel 保护类需求时，下面几个原则应该被放进团队规范里。
第一，Excel 工作表保护和工作簿结构保护并不是安全机制。它的设计目标是防止普通用户误操作，而不是阻止恶意用户读取数据。如果你要把文件发给外部人员，又要求敏感公式不可见，单靠”保护工作表“是没有意义的，正确做法是把文件转成 PDF、去除内部数据、或使用更正规的文件级权限控制方案。
第二，保护密码不要硬编码在业务代码中。新手喜欢直接在脚本里写password="123456"，这在学习调试时可以，但一旦代码进入仓库，密码就成了永久的明文痕迹。建议把密码读入环境变量或配置文件，同时在.gitignore中排除配置文件。CI 日志输出时也要注意，不要把密码打在日志里。
第三，批量处理任务要有异常隔离。不要一个文件报错就让整个循环中断。更推荐的做法是逐文件处理，记录成功和失败清单：
import traceback from pathlib import Path fail_list = [] for file_path in Path("reports").glob("*.xlsx"): try: # 在这里执行你的保护逻辑 pass except Exception: fail_list.append(str(file_path)) traceback.print_exc() print("处理完成，失败文件数为:", len(fail_list)) for item in fail_list: print(item)第四，尽量不覆盖原始文件。所有保护、解密、格式调整操作都先输出到新目录，确认结果无误后再决定是否替换原文件。这样做的成本很低，但能避免一次误操作毁掉整批数据。
第五，涉及他人文件的保护解除或密码解密时，先确认你已经拥有合法授权。这个边界不是形式问题，而是基本职业原则。本文所有示例只能用于处理你自己创建的 Excel 文件，或者你明确有权处理的业务文件。
10. 总结与下一步可以做的事
回到开头的需求：给 Excel 文件添加保护与解除保护，用 Python 解决的实际是把三类动作分别拆开。工作表保护限制内容编辑，工作簿结构保护限制 sheet 框架变动，文件级加密才真正把内容藏起来。三者对应不同的库、不同的处理逻辑、不同的安全强度，能分清这几点，基本就不会出现“我在 openpyxl 里找文件加密功能”这种方向性错误了。
如果你想继续深入，下一步可以试着把这些代码整合进自己的文件处理流程：先批量读取一批模板 xlsx，统一设置工作表保护，输出到指定目录；再写一个反向脚本，在需要二次加工时批量解除保护并另存。把两个方向的工具类沉淀到独立模块里，以后复用起来会方便很多。
更进一步，你还可以研究 Excel 的 OpenXML 结构，用压缩软件打开一个带保护的 xlsx，看看xl/worksheets/sheet1.xml里的sheetProtection节点长什么样。理解了文件底层表达，你才能真正理解为什么工作表保护不是加密，也才能在遇到奇怪的兼容性问题时不慌。
