使用pywin32保护Excel工作表时无法设置权限属性

我正在使用pywin32进行Python Excel自动化项目，需求是保护所有包含公式的单元格：先解锁全部单元格，再仅锁定含公式的单元格。调用sheet.Protect方法时，设置了Password、Contents=True、UserInterfaceOnly=True，同时将AllowFormattingCells、AllowFormattingColumns、AllowFormattingRows、AllowInsertingColumns、AllowInsertingRows、AllowSorting、AllowFiltering均设为True，但保护后检查这些属性均返回False。打开Excel文件后，工作表已被保护，仅能编辑未锁定单元格，无法执行格式设置、插入行列、筛选等操作。手动在Excel中设置保护则功能正常，我已尝试调整Contents和UserInterfaceOnly的组合，但问题仍未解决。

环境信息 #

• Python版本：3.11.9
• pywin32版本：306
• Excel版本：Microsoft® Excel® for Microsoft 365 MSO (Version 2402 Build 16.0.17328.20550) 64-bit
• Windows版本：Windows 11 Enterprise 23H2（OS build 22631.4317）

复现代码 #

import win32com.client


excel_app = win32com.client.DispatchEx("Excel.Application")
excel_app.Visible = False
workbook = excel_app.Workbooks.Open("path_to_file.xlsx")

sheet = workbook.Sheets("Sheet1")

all_cells = sheet.Cells
merge_cells = sheet.Cells(1, 1).MergeArea
edited_cell = merge_cells.Cells(1, 1)
value = edited_cell.Formula if edited_cell.HasFormula else edited_cell.Value

edited_cell.Formula = "=1+1"

formula_cells = all_cells.SpecialCells(Type=-4123)  # -4123 represents xlCellTypeFormulas

all_cells.Locked = False
formula_cells.Locked = True

if isinstance(value, str) and value.startswith("="):
    edited_cell.Formula = value
else:
    edited_cell.Value = value
    merge_cells.Locked = False


sheet.Protect(
    Password="random_password",
    Contents=True,
    UserInterfaceOnly=True,
    AllowFormattingCells=True,
    AllowFormattingColumns=True,
    AllowFormattingRows=True,
    AllowInsertingColumns=True,
    AllowInsertingRows=True,
    AllowSorting=True,
    AllowFiltering=True,
)

print("AllowFormattingCells: ", sheet.Protection.AllowFormattingCells)
print("AllowFormattingColumns: ", sheet.Protection.AllowFormattingColumns)
print("AllowFormattingRows: ", sheet.Protection.AllowFormattingRows)
print("AllowInsertingColumns: ", sheet.Protection.AllowInsertingColumns)
print("AllowInsertingRows: ", sheet.Protection.AllowInsertingRows)
print("AllowSorting: ", sheet.Protection.AllowSorting)
print("AllowFiltering: ", sheet.Protection.AllowFiltering)

workbook.Save()

excel_app.Quit()

解决方案 #

1. 移除UserInterfaceOnly参数或设为False #

UserInterfaceOnly=True仅在当前Excel会话中生效，保存文件后该设置会丢失，且会干扰其他保护属性的持久化。去掉该参数或显式设为False，同时确保调用Protect前工作表处于未保护状态：

# 先取消已存在的保护
if sheet.ProtectContents:
    sheet.Unprotect(Password="random_password")

# 重新设置保护，移除UserInterfaceOnly
sheet.Protect(
    Password="random_password",
    Contents=True,
    AllowFormattingCells=True,
    AllowFormattingColumns=True,
    AllowFormattingRows=True,
    AllowInsertingColumns=True,
    AllowInsertingRows=True,
    AllowSorting=True,
    AllowFiltering=True,
)

2. 使用Excel内置常量替代魔法数字 #

直接调用pywin32提供的Excel常量，避免数字参数的歧义：

from win32com.client import constants

# 替换SpecialCells的魔法数字
formula_cells = all_cells.SpecialCells(constants.xlCellTypeFormulas)

# 调用Protect时使用常量明确参数含义
sheet.Protect(
    Password="random_password",
    Contents=constants.xlProtectContents,
    AllowFormattingCells=True,
    AllowFormattingColumns=True,
    AllowFormattingRows=True,
    AllowInsertingColumns=True,
    AllowInsertingRows=True,
    AllowSorting=True,
    AllowFiltering=True,
    UserInterfaceOnly=False
)

3. 临时启用Excel可见性调试 #

后台模式（Visible=False）可能导致属性刷新不及时，临时设置excel_app.Visible=True，手动验证保护设置是否正确，再调整代码逻辑。

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