用 Python 给 Excel 文件加保护、解除保护是办公自动化里看着简单、实际容易踩坑的一类需求。我最早接这类任务时以为只是调一个 lock 开关结果发现 Excel 里至少有三种不同的“保护”文件打开密码、工作簿结构保护、工作表单元格锁定。它们处理逻辑不一样用的 Python 库也不一样一旦混在一起脚本很容易变成一堆异常补丁。这篇文章想帮你把问题理清楚先判断你要保护的是哪一层再决定用什么工具最后顺着单文件到批量、加锁到解锁、正常流程到排错这条线落地。下面写到的代码和步骤我自己在 Windows 和 Linux 环境都验证过主要路径但每个环境的 Excel 版本、依赖版本不一定相同你落地时应该先用一个小文件跑通再往正式文件上铺。1. 先分清要保护的到底是哪一层文件、工作簿还是单元格很多人打开 Excel 的“保护”按钮时会看到一串菜单保护工作表、保护工作簿、用密码加密、标记为最终状态。这些功能名字接近实际用途差别很大。如果你一开始没分清后面写代码就会不停试错用处理“工作表保护”的方式去处理“打开密码”的文件openpyxl 连读都读不出来。1.1 三种保护的实际差别第一种是打开密码。这种保护作用在文件本身没有正确密码就打不开内容。实现上不是简单加个标记而是对文件内容做了加密处理所以普通的 Excel 读写库不一定能直接读取。第二种是工作簿结构保护。它保护的是 Sheet 层面防止别人新增、删除、隐藏、重命名或移动工作表。这种保护和单元格能不能编辑没有直接关系。第三种是工作表保护。它作用在单元格层面最常见的是“锁定单元格”。要注意的是Excel 里单元格默认是锁定状态但只有在你启用了工作表保护之后锁定才会真正生效。我把它们的差异整理成一张表方便你选工具时对照保护类型实际作用常用 Python 方案需要注意的点文件打开密码打开文件需要密码文件内容属于加密状态msoffcrypto-tool、Excel COM忘记密码后很难恢复建议保留备份工作簿结构保护防止增删、隐藏、移动工作表Excel COMopenpyxl 支持有限不同工具的表现差异较大工作表保护锁定单元格区域限制格式、插入、筛选等操作openpyxl、Excel COM适合防止误操作不适合作为机密保护只读推荐、标记最终版只是提醒性质不是强保护Excel COM、openpyxl不能阻止有权限的人直接另存修改1.2 按使用场景选择保护组合先想清楚最终用户是谁再决定加哪种保护。我平时接触到的场景基本是这三类如果你是给同事发一张销售填报模板希望只能填 C2 到 F100表头、公式和字段说明不能被改那就用“工作表保护”把指定区域解锁后开启保护。如果你担心同事把 Sheet 删掉或者把明细表隐藏起来那要加的是“工作簿结构保护”。如果你处理的是人事、财务这类敏感数据文件本身就不希望无关人员打开那应该加“打开密码”而且是内容加密级别的密码不是简单的结构保护。最容易被误解的是很多人以为“工作表保护”等于安全加密。实际上工作表保护更准确的定位是防止误操作。它不能让别人完全拿不到内容也无法阻止有权限的人通过其他方式修改副本。真正要保护数据不外泄要靠文件加密、目录权限和账号权限这些机制。2. 开始写代码前先把环境和文件格式理清楚Python 处理 Excel 的库很多但没有一个库能覆盖所有格式和所有保护类型。先确定输入文件是.xlsx还是老版.xls再决定走哪条路能省掉大量时间。2.1 .xlsx 和 .xls 的处理路线不同.xlsx本质上是按 Office Open XML 结构打包的文件openpyxl 这类纯 Python 库可以直接读写适合服务器环境不要求安装 Excel。.xls是老版二进制格式openpyxl 不处理它。即使你强行把后缀改成.xlsx读取时也会报错。要处理.xls最稳的方式是调用本机 Excel COM 接口也就是在 Windows 环境中使用pywin32或xlwings。这条路要求电脑上装了 Office并且 Excel 能正常启动。如果你的文件带打开密码处理链路还要往前加一步。无论是 openpyxl 还是其他直接解析 Excel XML 的库都无法读取一个处于文件加密状态的.xlsx。你需要先用密码解密出一个临时文件再在临时文件上做保护或修改操作。2.2 推荐依赖与干净的解释器环境我这里推荐安装三个库分别对应不同任务python -m pip install openpyxl python -m pip install pywin32 python -m pip install msoffcrypto-toolopenpyxl 用于.xlsx的工作表保护操作pywin32 用于 Windows 下调用 Excel 处理.xls、结构保护以及一些复杂格式msoffcrypto-tool 用来处理带打开密码的 Office 文件。如果你的电脑上已经有很多 Python 环境和各种测试包我建议先建一个独立虚拟环境避免后面出现“明明装了库但是代码跑起来说找不到模块”的问题。python -m venv excel-toolsWindows 激活命令excel-tools\Scripts\activatemacOS 或 Linux 激活命令source excel-tools/bin/activate经常有人在 VS Code 或 Notebook 里写 openpyxl终端执行时报ModuleNotFoundError: No module named openpyxl。这种问题大概率不是代码逻辑有错而是当前解释器和你装库的环境不是同一个。先运行pip --version或python --version确认环境指向再处理依赖。3. 给 Excel 添加保护从最小样例开始跑我自己的习惯是永远先跑单文件再套批量循环。不要一上来就把几十个文件丢进代码里因为一旦保护逻辑理解错了批量操作会把错误复制到每一份文件上。3.1 工作表保护能做什么不能做什么工作表保护启用以后默认会限制用户编辑锁定单元格也会限制很多结构操作比如删除行、插入行、修改格式等。但你要清楚两件事第一它能防误操作不能防破解第二它不改变文件本身的加密状态也不影响文件是否能被直接打开。如果你的需求是让用户只能填写指定区域那代码分两步先把填写区域解锁再开启工作表保护。顺序反了会出问题。如果你先开启保护再设置单元格解锁部分 Excel 版本会提示权限冲突用户仍然无法编辑。注意工作表保护适合防误操作不适合当文件安全边界。真正需要防泄露时请使用文件打开密码或权限系统。3.2 先给整张表加保护下面是一个最小实现给活动工作表加上密码保护from openpyxl import load_workbook wb load_workbook(销售模板.xlsx) ws wb.active # 开启工作表保护 ws.protection.sheet True # 设置保护密码后续解除时需要 ws.protection.password 123456 wb.save(销售模板_已保护.xlsx)保存完成后用 Excel 重新打开文件可以选中单元格但无法直接编辑。如果要去掉保护在 Excel 里单击“撤销工作表保护”输入密码即可。这里有个容易忽略的点工作表保护密码在 Excel 文件里并不是保留明文而是以哈希形式存放。因此如果你自己忘了密码openpyxl 也做不到从文件里“找回”原始密码。它直接重写文件、清除保护是可以的但那是另一条路我放到下一节讲。3.3 需要留出填写区域时先解锁指定区域再保护很多模板场景不需要用户编辑整张表。比如 A 列是产品编号B 列是公式计算金额只有 C 列填数量D 列填备注。这种情况下应该把 C、D 两列中需要填写的区域设为 unlocked再开启保护。单元格的锁定状态在 openpyxl 里通过Protection对象控制。默认lockedTrue要开放填写就设为lockedFalse。from openpyxl import load_workbook from openpyxl.styles import Protection wb load_workbook(销售模板.xlsx) ws wb.active # 第一步解锁用户需要填写的区域 for row in ws[C2:D200]: for cell in row: cell.protection Protection(lockedFalse) # 第二步开启工作表保护 ws.protection.sheet True ws.protection.password 123456 wb.save(销售模板_可填写.xlsx)打开文件后会看到C2 到 D200 可以录入其他区域仍然被锁定。表格里的公式不会因为用户误操作被删除。如果你还需要允许用户使用排序、筛选、插入超链接等功能可以在WorksheetProtection上找到对应属性。属性名通常和 Excel 保护对话框里的勾选项一一对应True 表示允许False 表示不允许。测试时不要凭感觉猜直接在 Excel 里设一遍、看一遍效果再回到代码里设置属性比较省事。3.4 老格式和结构保护用 Windows COM 更省事如果输入文件是.xls或者你要做的是工作簿结构保护我会直接用 Excel COM。openpyxl 对部分结构保护有基础支持但不同版本保存后再打开的行为并不完全一致没必要在项目里赌这种兼容性。import win32com.client as win32 excel win32.DispatchEx(Excel.Application) excel.Visible False excel.DisplayAlerts False try: wb excel.Workbooks.Open(rD:\data\报表.xls) # 保护工作簿结构防止增删工作表 wb.Protect(Password123456, StructureTrue, WindowsTrue) wb.Save() finally: wb.Close(SaveChangesFalse) excel.Quit()用 COM 时有一个非常重要的点Excel 是在后台真实启动的不要以为Visible False就完全没有进程。如果脚本中途崩溃或者你没有执行excel.Quit()任务管理器里会留下 EXCEL.EXE 进程。下一次再打开同一个文件就可能报文件被占用。所以脚本里一定要用try-finally或with方式保证释放。如果你想保护的是工作表而不是工作簿那是另一个方法。openpyxl 加的是ws.protectionCOM 里对应的是ws.Protect不要把wb.Protect当成锁定单元格来用。4. 解除保护先确认你面对的是哪一类“锁”解除保护和添加保护并不是简单的“把 True 改成 False”。面对不同锁走的路线完全不同。我建议按下面顺序先判断文件打开时是否需要密码。文件是否能被 openpyxl 直接打开。打开后工作表是否处于锁定编辑状态。是否禁止新增或删除 Sheet。很多报表会被同事设置成“打开即可读但不能改”然后你会看到文件中所有单元格都不能编辑。这时候首先要判断它到底是工作表保护还是文件本身的只读属性。两者处理方式不一样。4.1 用 openpyxl 清除工作表保护如果文件本身没有打开密码只是工作表被保护了openpyxl 可以直接打开并清除保护。from openpyxl import load_workbook wb load_workbook(受保护的工作表.xlsx) ws wb[Sheet1] # 关闭工作表保护 ws.protection.sheet False wb.save(已解除保护.xlsx)这个操作不需要输入原保护密码。原因是 openpyxl 并不会去校验密码它只是在重新生成 Excel XML 文件时不再写入 sheet protection 相关配置。对于你自己有权限处理的文件这是一个很实用的恢复手段。但我要多说一句边界如果一份文件是别人设置的并且对方明确不允许你修改那就不要用这种方式去绕过。自动化脚本可以用来恢复自己的文件、处理公司授权处理的报表不应该被用来突破别人的权限限制。4.2 文件打开密码要先用解密工具处理如果文件在打开时就要求输入密码那么它已经处于“文件加密”状态openpyxl 读不到内部结构。你需要先用正确密码解密。msoffcrypto-tool 适合处理这种场景。下面是一个示例import io import msoffcrypto from openpyxl import load_workbook with open(加密报表.xlsx, rb) as f: office_file msoffcrypto.OfficeFile(f) if office_file.is_encrypted(): office_file.load_key(password123456) decrypted io.BytesIO() office_file.decrypt(decrypted) decrypted.seek(0) # 读取解密后的内容 wb load_workbook(decrypted) print(wb.sheetnames)注意decrypt是指用你知道的正确密码把文件解密到内存不是猜测密码。解密后的内容如果直接保存成新文件那个新文件会变成没有打开密码的普通 Excel 文件。如果你希望最终文件继续保留打开密码就不要用这个方法生成明文文件直接交付最好在完成修改后用 Excel COM 或其他受控方式重新覆盖密码保存并在本地处理完后清理临时文件。4.3 忘记打开密码时的稳妥处理如果工作表保护密码忘了openpyxl 的方式通常可以救回来。结构保护密码忘了也可以用 COM 在没有修改 Sheet 的情况下重新保存来清除。但文件打开密码忘了情况会麻烦很多。文件本身是加密的没有正确密码解析工具拿不到内部内容。我的建议是先找备份、版本历史或文件原负责人。如果是团队内文件找管理员重置密码或重新生成文件。今后在自动化任务里先规划好密码管理不要临时把密码写在代码里更不要在明文日志里打印。不要轻易从来路不明的网站下载所谓找回密码工具。很多工具带有额外程序碰到的风险远大于省下的麻烦。4.4 COM 方式解除结构和工作表保护如果你处理的是.xls或者用 COM 更稳妥的.xlsx可以这样解除import win32com.client as win32 excel win32.DispatchEx(Excel.Application) excel.Visible False excel.DisplayAlerts False try: wb excel.Workbooks.Open(rD:\data\报表.xls) # 如果是工作簿结构保护 wb.Unprotect(Password123456) # 如果是工作表保护需要逐个工作表调用 for ws in wb.Worksheets: ws.Unprotect(Password123456) wb.Save() finally: wb.Close(SaveChangesFalse) excel.Quit()这段代码会先解除工作簿保护再解除当前工作簿里所有工作表的保护。实际使用时只需要调用你真正需要处理的那一个不要无脑全部解除。如果只处理某一张表却把结构保护也取消了反而会带来新的风险。5. 批量处理多文件、输出目录与失败清单只处理一两个文件时手动写脚本和手动操作差别不大。但一旦文件数量到几十上百份批量的价值就出来了。批量任务有一个基本原则不要把原文件原地覆盖。5.1 目录遍历与不覆盖原文件的策略我的通常做法是建立两个目录一个放待处理文件一个放处理结果。脚本从待处理目录读取文件把结果写入已处理目录。这样即使一批文件中有几个处理失败原始文件仍然保留可以修复后重跑。from pathlib import Path from openpyxl import load_workbook src_dir Path(./待处理) out_dir Path(./已处理) out_dir.mkdir(exist_okTrue) password 123456 for xlsx_path in src_dir.glob(*.xlsx): wb load_workbook(xlsx_path) for ws in wb.worksheets: ws.protection.sheet True ws.protection.password password out_path out_dir / xlsx_path.name wb.save(out_path)这段代码给每个工作簿中的所有工作表都开启了保护。如果你的列表里有“部分 Sheet 需要锁定、部分 Sheet 不需要锁定”的情况不能直接用这个循环要先把表格清单列出来按单子操作。5.2 批量解除保护与批量加锁要关注的事项批量解除保护时成功标准不只是“不报错”。我会额外检查以下几点每个 Sheet 是否都按预期解除保护。是否误删了公式、图表、透视表或数据验证。文件打开后是否提示损坏。原文件的格式和内容是否保持完整。这里有一个 openpyxl 常见的坑读取 Excel 时如果你使用了data_onlyTrue拿回来的是公式的缓存值而不是公式本身。如果此时再保存文件里的公式体系可能被破坏。处理保护和解除保护的任务时除非你明确知道要读值否则不要开data_onlyTrue。对有图表、透视表、图片、复杂数据验证的.xlsx建议先用 COM 方式处理或者把一个文件复制出来做验证。openpyxl 适合公式和格式相对规整的报表但它毕竟不是完整 Excel 内核面对复杂对象时可能重写后格式和交互有变化。5.3 记录日志让失败任务可以重跑批量任务最怕出现“全量处理完却发现部分文件失败”的情况。失败的判断标准不能只靠脚本最后是否抛出异常要对每个文件单独记录。from pathlib import Path from openpyxl import load_workbook src_dir Path(./待处理) out_dir Path(./已处理) out_dir.mkdir(exist_okTrue) success [] failed [] for xlsx_path in src_dir.glob(*.xlsx): try: wb load_workbook(xlsx_path) for ws in wb.worksheets: ws.protection.sheet True ws.protection.password 123456 out_path out_dir / xlsx_path.name wb.save(out_path) success.append(xlsx_path.name) except Exception as exc: failed.append((xlsx_path.name, repr(exc))) print(成功数量, len(success)) print(失败数量, len(failed)) for name, err in failed: print(name, err)把失败文件名和异常信息打印出来比只输出一个batch finished要可靠得多。处理完成之后再按成功清单抽查几份结果确认保护状态和内容完整性整个任务才算真正结束。注意批量场景不要一上来就开并发。openpyxl 本身可以并发跑但一旦批处理逻辑里有 COM、Excel进程、文件占用这些因素并行会让错误变得很难排查。先用单线程跑通再考虑是否值得优化速度。6. 经常碰到的报错与排查顺序实际使用中大部分人遇到问题不是卡在算法而是卡在文件格式、依赖环境和进程占用这些很基础的地方。这里会分享几个我排查时优先看的点。6.1 报错先看输入文件如果load_workbook报压缩包错误或者文件格式错误首先检查文件后缀是不是真的.xlsx。有些人把 CSV 直接改名为.xlsx或者把 HTML 表格下载下来改成 Excel 后缀都会让 openpyxl 报错。现象可能原因优先排查方向load_workbook 提示 BadZipFile文件不是标准 xlsx或文件仍处于打开密码加密状态检查后缀、用 Excel 打开确认文件格式PermissionError文件正在 Excel/WPS 中打开或目录无写入权限关闭正在查看文件的程序复制到临时目录再处理保存后打开提示文件损坏复杂对象被重写后不兼容图表、透视表多的文件改用 Excel COM保护看起来没有生效只是设置了只读推荐或没有启用工作表保护检查 Excel 菜单里的实际操作判断文件类型时不要只看图标和后缀最好在资源管理器里开启“显示文件扩展名”确认真实的扩展名。6.2 环境问题先看解释器和依赖ModuleNotFoundError: No module named win32com通常是没装 pywin32No module named openpyxl通常是当前解释器环境不对。处理方法很简单先确认当前 python 命令指向哪个解释器再使用python -m pip install openpyxl安装避免用 pip 和 python 不属于同一个环境的问题。如果本机没有安装 Office调用DispatchEx(Excel.Application)时也会失败这类问题不是代码能解决的。6.3 保护表现和预期不一致时按从外到内的顺序排查保护表现不对时我通常按这样的顺序排查先确认文件打开时是否需要密码。如果需要先用解密方式处理。再确认文件是不是老版.xls。如果是就切换 COM 路线。然后确认是整张表不能编辑还是部分单元格不能编辑。如果是部分单元格不能编辑很可能是单元格锁定状态没有设置对。最后确认你改的是哪个 Sheet。active 工作表不等于所有工作表批量操作时尤其要注意。我发现很多看似“工具不支持”的问题最后都是因为输入判断错了。文件格式没确认、保护类型没区分、环境没选对三个原因占了大多数。7. 落地的最后建议 Python给Excel加保护与解除保护：分层解析与实战指南
用 Python 给 Excel 文件加保护、解除保护是办公自动化里看着简单、实际容易踩坑的一类需求。我最早接这类任务时以为只是调一个 lock 开关结果发现 Excel 里至少有三种不同的“保护”文件打开密码、工作簿结构保护、工作表单元格锁定。它们处理逻辑不一样用的 Python 库也不一样一旦混在一起脚本很容易变成一堆异常补丁。这篇文章想帮你把问题理清楚先判断你要保护的是哪一层再决定用什么工具最后顺着单文件到批量、加锁到解锁、正常流程到排错这条线落地。下面写到的代码和步骤我自己在 Windows 和 Linux 环境都验证过主要路径但每个环境的 Excel 版本、依赖版本不一定相同你落地时应该先用一个小文件跑通再往正式文件上铺。1. 先分清要保护的到底是哪一层文件、工作簿还是单元格很多人打开 Excel 的“保护”按钮时会看到一串菜单保护工作表、保护工作簿、用密码加密、标记为最终状态。这些功能名字接近实际用途差别很大。如果你一开始没分清后面写代码就会不停试错用处理“工作表保护”的方式去处理“打开密码”的文件openpyxl 连读都读不出来。1.1 三种保护的实际差别第一种是打开密码。这种保护作用在文件本身没有正确密码就打不开内容。实现上不是简单加个标记而是对文件内容做了加密处理所以普通的 Excel 读写库不一定能直接读取。第二种是工作簿结构保护。它保护的是 Sheet 层面防止别人新增、删除、隐藏、重命名或移动工作表。这种保护和单元格能不能编辑没有直接关系。第三种是工作表保护。它作用在单元格层面最常见的是“锁定单元格”。要注意的是Excel 里单元格默认是锁定状态但只有在你启用了工作表保护之后锁定才会真正生效。我把它们的差异整理成一张表方便你选工具时对照保护类型实际作用常用 Python 方案需要注意的点文件打开密码打开文件需要密码文件内容属于加密状态msoffcrypto-tool、Excel COM忘记密码后很难恢复建议保留备份工作簿结构保护防止增删、隐藏、移动工作表Excel COMopenpyxl 支持有限不同工具的表现差异较大工作表保护锁定单元格区域限制格式、插入、筛选等操作openpyxl、Excel COM适合防止误操作不适合作为机密保护只读推荐、标记最终版只是提醒性质不是强保护Excel COM、openpyxl不能阻止有权限的人直接另存修改1.2 按使用场景选择保护组合先想清楚最终用户是谁再决定加哪种保护。我平时接触到的场景基本是这三类如果你是给同事发一张销售填报模板希望只能填 C2 到 F100表头、公式和字段说明不能被改那就用“工作表保护”把指定区域解锁后开启保护。如果你担心同事把 Sheet 删掉或者把明细表隐藏起来那要加的是“工作簿结构保护”。如果你处理的是人事、财务这类敏感数据文件本身就不希望无关人员打开那应该加“打开密码”而且是内容加密级别的密码不是简单的结构保护。最容易被误解的是很多人以为“工作表保护”等于安全加密。实际上工作表保护更准确的定位是防止误操作。它不能让别人完全拿不到内容也无法阻止有权限的人通过其他方式修改副本。真正要保护数据不外泄要靠文件加密、目录权限和账号权限这些机制。2. 开始写代码前先把环境和文件格式理清楚Python 处理 Excel 的库很多但没有一个库能覆盖所有格式和所有保护类型。先确定输入文件是.xlsx还是老版.xls再决定走哪条路能省掉大量时间。2.1 .xlsx 和 .xls 的处理路线不同.xlsx本质上是按 Office Open XML 结构打包的文件openpyxl 这类纯 Python 库可以直接读写适合服务器环境不要求安装 Excel。.xls是老版二进制格式openpyxl 不处理它。即使你强行把后缀改成.xlsx读取时也会报错。要处理.xls最稳的方式是调用本机 Excel COM 接口也就是在 Windows 环境中使用pywin32或xlwings。这条路要求电脑上装了 Office并且 Excel 能正常启动。如果你的文件带打开密码处理链路还要往前加一步。无论是 openpyxl 还是其他直接解析 Excel XML 的库都无法读取一个处于文件加密状态的.xlsx。你需要先用密码解密出一个临时文件再在临时文件上做保护或修改操作。2.2 推荐依赖与干净的解释器环境我这里推荐安装三个库分别对应不同任务python -m pip install openpyxl python -m pip install pywin32 python -m pip install msoffcrypto-toolopenpyxl 用于.xlsx的工作表保护操作pywin32 用于 Windows 下调用 Excel 处理.xls、结构保护以及一些复杂格式msoffcrypto-tool 用来处理带打开密码的 Office 文件。如果你的电脑上已经有很多 Python 环境和各种测试包我建议先建一个独立虚拟环境避免后面出现“明明装了库但是代码跑起来说找不到模块”的问题。python -m venv excel-toolsWindows 激活命令excel-tools\Scripts\activatemacOS 或 Linux 激活命令source excel-tools/bin/activate经常有人在 VS Code 或 Notebook 里写 openpyxl终端执行时报ModuleNotFoundError: No module named openpyxl。这种问题大概率不是代码逻辑有错而是当前解释器和你装库的环境不是同一个。先运行pip --version或python --version确认环境指向再处理依赖。3. 给 Excel 添加保护从最小样例开始跑我自己的习惯是永远先跑单文件再套批量循环。不要一上来就把几十个文件丢进代码里因为一旦保护逻辑理解错了批量操作会把错误复制到每一份文件上。3.1 工作表保护能做什么不能做什么工作表保护启用以后默认会限制用户编辑锁定单元格也会限制很多结构操作比如删除行、插入行、修改格式等。但你要清楚两件事第一它能防误操作不能防破解第二它不改变文件本身的加密状态也不影响文件是否能被直接打开。如果你的需求是让用户只能填写指定区域那代码分两步先把填写区域解锁再开启工作表保护。顺序反了会出问题。如果你先开启保护再设置单元格解锁部分 Excel 版本会提示权限冲突用户仍然无法编辑。注意工作表保护适合防误操作不适合当文件安全边界。真正需要防泄露时请使用文件打开密码或权限系统。3.2 先给整张表加保护下面是一个最小实现给活动工作表加上密码保护from openpyxl import load_workbook wb load_workbook(销售模板.xlsx) ws wb.active # 开启工作表保护 ws.protection.sheet True # 设置保护密码后续解除时需要 ws.protection.password 123456 wb.save(销售模板_已保护.xlsx)保存完成后用 Excel 重新打开文件可以选中单元格但无法直接编辑。如果要去掉保护在 Excel 里单击“撤销工作表保护”输入密码即可。这里有个容易忽略的点工作表保护密码在 Excel 文件里并不是保留明文而是以哈希形式存放。因此如果你自己忘了密码openpyxl 也做不到从文件里“找回”原始密码。它直接重写文件、清除保护是可以的但那是另一条路我放到下一节讲。3.3 需要留出填写区域时先解锁指定区域再保护很多模板场景不需要用户编辑整张表。比如 A 列是产品编号B 列是公式计算金额只有 C 列填数量D 列填备注。这种情况下应该把 C、D 两列中需要填写的区域设为 unlocked再开启保护。单元格的锁定状态在 openpyxl 里通过Protection对象控制。默认lockedTrue要开放填写就设为lockedFalse。from openpyxl import load_workbook from openpyxl.styles import Protection wb load_workbook(销售模板.xlsx) ws wb.active # 第一步解锁用户需要填写的区域 for row in ws[C2:D200]: for cell in row: cell.protection Protection(lockedFalse) # 第二步开启工作表保护 ws.protection.sheet True ws.protection.password 123456 wb.save(销售模板_可填写.xlsx)打开文件后会看到C2 到 D200 可以录入其他区域仍然被锁定。表格里的公式不会因为用户误操作被删除。如果你还需要允许用户使用排序、筛选、插入超链接等功能可以在WorksheetProtection上找到对应属性。属性名通常和 Excel 保护对话框里的勾选项一一对应True 表示允许False 表示不允许。测试时不要凭感觉猜直接在 Excel 里设一遍、看一遍效果再回到代码里设置属性比较省事。3.4 老格式和结构保护用 Windows COM 更省事如果输入文件是.xls或者你要做的是工作簿结构保护我会直接用 Excel COM。openpyxl 对部分结构保护有基础支持但不同版本保存后再打开的行为并不完全一致没必要在项目里赌这种兼容性。import win32com.client as win32 excel win32.DispatchEx(Excel.Application) excel.Visible False excel.DisplayAlerts False try: wb excel.Workbooks.Open(rD:\data\报表.xls) # 保护工作簿结构防止增删工作表 wb.Protect(Password123456, StructureTrue, WindowsTrue) wb.Save() finally: wb.Close(SaveChangesFalse) excel.Quit()用 COM 时有一个非常重要的点Excel 是在后台真实启动的不要以为Visible False就完全没有进程。如果脚本中途崩溃或者你没有执行excel.Quit()任务管理器里会留下 EXCEL.EXE 进程。下一次再打开同一个文件就可能报文件被占用。所以脚本里一定要用try-finally或with方式保证释放。如果你想保护的是工作表而不是工作簿那是另一个方法。openpyxl 加的是ws.protectionCOM 里对应的是ws.Protect不要把wb.Protect当成锁定单元格来用。4. 解除保护先确认你面对的是哪一类“锁”解除保护和添加保护并不是简单的“把 True 改成 False”。面对不同锁走的路线完全不同。我建议按下面顺序先判断文件打开时是否需要密码。文件是否能被 openpyxl 直接打开。打开后工作表是否处于锁定编辑状态。是否禁止新增或删除 Sheet。很多报表会被同事设置成“打开即可读但不能改”然后你会看到文件中所有单元格都不能编辑。这时候首先要判断它到底是工作表保护还是文件本身的只读属性。两者处理方式不一样。4.1 用 openpyxl 清除工作表保护如果文件本身没有打开密码只是工作表被保护了openpyxl 可以直接打开并清除保护。from openpyxl import load_workbook wb load_workbook(受保护的工作表.xlsx) ws wb[Sheet1] # 关闭工作表保护 ws.protection.sheet False wb.save(已解除保护.xlsx)这个操作不需要输入原保护密码。原因是 openpyxl 并不会去校验密码它只是在重新生成 Excel XML 文件时不再写入 sheet protection 相关配置。对于你自己有权限处理的文件这是一个很实用的恢复手段。但我要多说一句边界如果一份文件是别人设置的并且对方明确不允许你修改那就不要用这种方式去绕过。自动化脚本可以用来恢复自己的文件、处理公司授权处理的报表不应该被用来突破别人的权限限制。4.2 文件打开密码要先用解密工具处理如果文件在打开时就要求输入密码那么它已经处于“文件加密”状态openpyxl 读不到内部结构。你需要先用正确密码解密。msoffcrypto-tool 适合处理这种场景。下面是一个示例import io import msoffcrypto from openpyxl import load_workbook with open(加密报表.xlsx, rb) as f: office_file msoffcrypto.OfficeFile(f) if office_file.is_encrypted(): office_file.load_key(password123456) decrypted io.BytesIO() office_file.decrypt(decrypted) decrypted.seek(0) # 读取解密后的内容 wb load_workbook(decrypted) print(wb.sheetnames)注意decrypt是指用你知道的正确密码把文件解密到内存不是猜测密码。解密后的内容如果直接保存成新文件那个新文件会变成没有打开密码的普通 Excel 文件。如果你希望最终文件继续保留打开密码就不要用这个方法生成明文文件直接交付最好在完成修改后用 Excel COM 或其他受控方式重新覆盖密码保存并在本地处理完后清理临时文件。4.3 忘记打开密码时的稳妥处理如果工作表保护密码忘了openpyxl 的方式通常可以救回来。结构保护密码忘了也可以用 COM 在没有修改 Sheet 的情况下重新保存来清除。但文件打开密码忘了情况会麻烦很多。文件本身是加密的没有正确密码解析工具拿不到内部内容。我的建议是先找备份、版本历史或文件原负责人。如果是团队内文件找管理员重置密码或重新生成文件。今后在自动化任务里先规划好密码管理不要临时把密码写在代码里更不要在明文日志里打印。不要轻易从来路不明的网站下载所谓找回密码工具。很多工具带有额外程序碰到的风险远大于省下的麻烦。4.4 COM 方式解除结构和工作表保护如果你处理的是.xls或者用 COM 更稳妥的.xlsx可以这样解除import win32com.client as win32 excel win32.DispatchEx(Excel.Application) excel.Visible False excel.DisplayAlerts False try: wb excel.Workbooks.Open(rD:\data\报表.xls) # 如果是工作簿结构保护 wb.Unprotect(Password123456) # 如果是工作表保护需要逐个工作表调用 for ws in wb.Worksheets: ws.Unprotect(Password123456) wb.Save() finally: wb.Close(SaveChangesFalse) excel.Quit()这段代码会先解除工作簿保护再解除当前工作簿里所有工作表的保护。实际使用时只需要调用你真正需要处理的那一个不要无脑全部解除。如果只处理某一张表却把结构保护也取消了反而会带来新的风险。5. 批量处理多文件、输出目录与失败清单只处理一两个文件时手动写脚本和手动操作差别不大。但一旦文件数量到几十上百份批量的价值就出来了。批量任务有一个基本原则不要把原文件原地覆盖。5.1 目录遍历与不覆盖原文件的策略我的通常做法是建立两个目录一个放待处理文件一个放处理结果。脚本从待处理目录读取文件把结果写入已处理目录。这样即使一批文件中有几个处理失败原始文件仍然保留可以修复后重跑。from pathlib import Path from openpyxl import load_workbook src_dir Path(./待处理) out_dir Path(./已处理) out_dir.mkdir(exist_okTrue) password 123456 for xlsx_path in src_dir.glob(*.xlsx): wb load_workbook(xlsx_path) for ws in wb.worksheets: ws.protection.sheet True ws.protection.password password out_path out_dir / xlsx_path.name wb.save(out_path)这段代码给每个工作簿中的所有工作表都开启了保护。如果你的列表里有“部分 Sheet 需要锁定、部分 Sheet 不需要锁定”的情况不能直接用这个循环要先把表格清单列出来按单子操作。5.2 批量解除保护与批量加锁要关注的事项批量解除保护时成功标准不只是“不报错”。我会额外检查以下几点每个 Sheet 是否都按预期解除保护。是否误删了公式、图表、透视表或数据验证。文件打开后是否提示损坏。原文件的格式和内容是否保持完整。这里有一个 openpyxl 常见的坑读取 Excel 时如果你使用了data_onlyTrue拿回来的是公式的缓存值而不是公式本身。如果此时再保存文件里的公式体系可能被破坏。处理保护和解除保护的任务时除非你明确知道要读值否则不要开data_onlyTrue。对有图表、透视表、图片、复杂数据验证的.xlsx建议先用 COM 方式处理或者把一个文件复制出来做验证。openpyxl 适合公式和格式相对规整的报表但它毕竟不是完整 Excel 内核面对复杂对象时可能重写后格式和交互有变化。5.3 记录日志让失败任务可以重跑批量任务最怕出现“全量处理完却发现部分文件失败”的情况。失败的判断标准不能只靠脚本最后是否抛出异常要对每个文件单独记录。from pathlib import Path from openpyxl import load_workbook src_dir Path(./待处理) out_dir Path(./已处理) out_dir.mkdir(exist_okTrue) success [] failed [] for xlsx_path in src_dir.glob(*.xlsx): try: wb load_workbook(xlsx_path) for ws in wb.worksheets: ws.protection.sheet True ws.protection.password 123456 out_path out_dir / xlsx_path.name wb.save(out_path) success.append(xlsx_path.name) except Exception as exc: failed.append((xlsx_path.name, repr(exc))) print(成功数量, len(success)) print(失败数量, len(failed)) for name, err in failed: print(name, err)把失败文件名和异常信息打印出来比只输出一个batch finished要可靠得多。处理完成之后再按成功清单抽查几份结果确认保护状态和内容完整性整个任务才算真正结束。注意批量场景不要一上来就开并发。openpyxl 本身可以并发跑但一旦批处理逻辑里有 COM、Excel进程、文件占用这些因素并行会让错误变得很难排查。先用单线程跑通再考虑是否值得优化速度。6. 经常碰到的报错与排查顺序实际使用中大部分人遇到问题不是卡在算法而是卡在文件格式、依赖环境和进程占用这些很基础的地方。这里会分享几个我排查时优先看的点。6.1 报错先看输入文件如果load_workbook报压缩包错误或者文件格式错误首先检查文件后缀是不是真的.xlsx。有些人把 CSV 直接改名为.xlsx或者把 HTML 表格下载下来改成 Excel 后缀都会让 openpyxl 报错。现象可能原因优先排查方向load_workbook 提示 BadZipFile文件不是标准 xlsx或文件仍处于打开密码加密状态检查后缀、用 Excel 打开确认文件格式PermissionError文件正在 Excel/WPS 中打开或目录无写入权限关闭正在查看文件的程序复制到临时目录再处理保存后打开提示文件损坏复杂对象被重写后不兼容图表、透视表多的文件改用 Excel COM保护看起来没有生效只是设置了只读推荐或没有启用工作表保护检查 Excel 菜单里的实际操作判断文件类型时不要只看图标和后缀最好在资源管理器里开启“显示文件扩展名”确认真实的扩展名。6.2 环境问题先看解释器和依赖ModuleNotFoundError: No module named win32com通常是没装 pywin32No module named openpyxl通常是当前解释器环境不对。处理方法很简单先确认当前 python 命令指向哪个解释器再使用python -m pip install openpyxl安装避免用 pip 和 python 不属于同一个环境的问题。如果本机没有安装 Office调用DispatchEx(Excel.Application)时也会失败这类问题不是代码能解决的。6.3 保护表现和预期不一致时按从外到内的顺序排查保护表现不对时我通常按这样的顺序排查先确认文件打开时是否需要密码。如果需要先用解密方式处理。再确认文件是不是老版.xls。如果是就切换 COM 路线。然后确认是整张表不能编辑还是部分单元格不能编辑。如果是部分单元格不能编辑很可能是单元格锁定状态没有设置对。最后确认你改的是哪个 Sheet。active 工作表不等于所有工作表批量操作时尤其要注意。我发现很多看似“工具不支持”的问题最后都是因为输入判断错了。文件格式没确认、保护类型没区分、环境没选对三个原因占了大多数。7. 落地的最后建议