使用openpyxl执行workbook.save()保存后表格勾选标记消失问题

问题原因 #

勾选标记消失是openpyxl对Excel表单控件支持不完善导致的：
你表格中使用的勾选框属于Excel表单类控件，并非单元格内的普通文本/字符，openpyxl在读写.xlsx文件时默认不会保留这类非单元格内容的控件节点，调用workbook.save()时会直接丢弃控件相关的配置，最终表现为勾选框消失。
降级到3.0.5版本后打开文件报错，是因为该版本在处理带控件的.xlsx文件时，会错误修改文件内部的XML结构，导致Excel识别为文件损坏。

解决方案 #

方案1：换用支持保留控件的库操作Excel（推荐） #

使用xlwings库操作Excel，它通过调用系统安装的Excel程序原生接口读写文件，不会丢失表单控件、自定义格式等原生属性，示例代码如下：

import xlwings as xw

# 后台运行Excel，不弹出界面
with xw.App(visible=False, add_book=False) as app:
    workbook = app.books.open('example.xlsx')
    sheet = workbook.sheets[0]
    # 此处添加你的表格修改逻辑
    workbook.save('example.xlsx')
    workbook.close()

该方案完全兼容Excel所有原生特性，不会出现格式、控件丢失问题，仅要求运行环境安装有Excel程序。

方案2：替换为字符类勾选标记 #

如果必须使用openpyxl操作，可以将原有表单复选框替换为单元格内存储的字符类勾选标记，openpyxl读写时不会丢失：

• 直接使用Unicode字符：☑️代表已勾选、⬜代表未勾选，直接写入单元格即可
• 如需更贴近原生效果，可使用Wingdings 2字体实现：单元格输入R设置字体为Wingdings 2即为带勾选的方框，输入£设置字体为Wingdings 2即为空白方框。

方案3：调整openpyxl加载参数（兼容性差，仅作临时测试） #

加载文件时添加keep_vba=True参数，部分场景下可保留控件配置：

workbook = load_workbook(filename='example.xlsx', keep_vba=True)

注意该参数仅对.xlsm格式生效，且3.0.x版本的openpyxl仍然大概率会丢失控件配置，不建议正式环境使用。

内容的提问来源于stack exchange，提问作者Guigui