在文档协作与分发过程中,如何确保内容完整且可控,是许多用户关注的安全需求。Word 文档的“限制编辑”功能不同于文件级加密——它不会阻止他人打开或阅读文档,而是精确控制用户能执行的操作:例如仅允许添加批注、仅以修订模式修改,或完全禁止编辑。
如果只是手动点击 Word 客户端中的“审阅→限制编辑”面板,处理一两个文档还好。但面对批量文件,或需要嵌入自动化流程时,就必须借助程序化手段了。本次我们基于 Free Spire.Doc for Python 这个免费库,介绍如何用代码实现 Word 文档的各类编辑限制。
1. 环境准备
1.1 库的安装
通过 pip 直接安装即可,运行环境无需依赖 Microsoft Office 或 WPS:
pip install Spire.Doc
需要说明:免费版库在读写文件时,有 500 段落和 25 个表格的限制——不过对大多数日常办公场景而言,这个量级基本够用。
1.2 核心方法与枚举
文档保护的核心入口是 Document.Protect() 方法,搭配 ProtectionType 枚举来指定限制级别。该枚举共有五个取值,恰好对应 Word 客户端中限制编辑面板的全部选项。
2. 五种保护类型详解
2.1 保护类型对照
| 枚举值 | 对应 Word 功能 | 行为说明 |
|---|---|---|
AllowOnlyReading | 不允许任何更改(只读) | 整篇文档禁止编辑,用户仅可查看内容 |
AllowOnlyRevisions | 修订 | 用户可修改内容,但所有变更均以修订痕迹记录 |
AllowOnlyComments | 批注 | 正文不可修改,仅允许插入批注进行评论 |
AllowOnlyFormFields | 填写窗体 | 仅窗体域可输入,其余区域锁定 |
NoProtection | 无限制 | 解除所有编辑限制 |
2.2 只读保护(最严格)
只读模式,顾名思义,就是将文档完全锁定。用户只能查看,无法进行任何修改。对于对外发布正式版本来说,这是最稳妥的方式。
from spire.doc import *
from spire.doc.common import *
# 创建Document对象并加载文档
doc = Document()
doc.LoadFromFile("示例文档.docx")
# 设置为只读模式,密码为"123456"
doc.Protect(ProtectionType.AllowOnlyReading, "123456")
# 保存文档
doc.Sa veToFile("只读文档.docx")
doc.Close()
设置完成后,在 Word 中打开该文档,会看到功能区的编辑命令全部变灰——想修改内容?系统会弹出“限制编辑”的提示。

2.3 修订模式保护
修订模式在多人审阅场景中非常实用。所有修改都会被标记为插入、删除或格式变更的痕迹,文档所有者后续可以逐一接受或拒绝,避免出现“改完都不知道谁动了什么”的混乱情况。
from spire.doc import *
from spire.doc.common import *
doc = Document()
doc.LoadFromFile("示例文档.docx")
# 设置为仅允许修订模式
doc.Protect(ProtectionType.AllowOnlyRevisions, "123456")
doc.Sa veToFile("修订模式文档.docx")
doc.Close()

2.4 批注模式保护
批注模式下,审阅者不能直接修改正文,只能在旁边添加批注发表意见。这种方式在初稿评审阶段特别适用——既能让别人提建议,又不用担心原文被随手改动。
from spire.doc import *
from spire.doc.common import *
doc = Document()
doc.LoadFromFile("示例文档.docx")
# 设置为仅允许批注
doc.Protect(ProtectionType.AllowOnlyComments, "123456")
doc.Sa veToFile("仅批注文档.docx")
doc.Close()

2.5 窗体字段保护
如果文档中插入了下拉框、文本框等窗体控件,使用 AllowOnlyFormFields 可以将正文锁定,只允许用户在窗体字段中输入内容。这种模式在制作申请表单模板时应用较多。
from spire.doc import *
from spire.doc.common import *
doc = Document()
doc.LoadFromFile("表单文档.docx")
# 设置为仅允许填写表单
doc.Protect(ProtectionType.AllowOnlyFormFields, "123456")
doc.Sa veToFile("表单保护文档.docx")
doc.Close()

3. 解除文档保护
如果知道保护密码,想要解除限制也很简单,只需将保护类型设为 NoProtection:
from spire.doc import *
from spire.doc.common import *
doc = Document()
doc.LoadFromFile("受保护文档.docx")
# 移除文档编辑限制
doc.Protect(ProtectionType.NoProtection, "123456")
doc.Sa veToFile("已解除限制文档.docx")
doc.Close()
注意事项:
- 密码必须与设置保护时使用的密码一致,否则解除操作无效。
- 如果文档设置保护时未设密码,调用
Protect(ProtectionType.NoProtection)时可以省略密码参数。 - 该操作仅移除编辑限制,不会影响文档的内容和格式。
4. 进阶:指定区域可编辑
实际业务中,经常遇到“整体锁定 + 局部开放”的需求。例如一份合同,正文和条款全部锁死,只留出签署日期和乙方名称两处可以填写——这种效果可以通过可编辑区域来实现。
实现思路:先将整篇文档设为只读保护,然后在指定位置插入 PermissionStart 和 PermissionEnd 标记,这两个标记之间的内容即为豁免区域。
from spire.doc import *
from spire.doc.common import *
doc = Document()
doc.LoadFromFile("示例文档.docx")
# 获取第一节第三段作为示例位置
section = doc.Sections[0]
paragraph = section.Paragraphs[2]
# 在段落起始处插入可编辑区域起始标记
permission_start = PermissionStart(doc, "edit_area_001")
paragraph.ChildObjects.Insert(0, permission_start)
# 在段落末尾插入可编辑区域结束标记
permission_end = PermissionEnd(doc, "edit_area_001")
paragraph.ChildObjects.Add(permission_end)
# 设置文档保护时,这些标记范围内的内容将不受限制
doc.Protect(ProtectionType.AllowOnlyReading, "123456")
doc.Sa veToFile("部分可编辑文档.docx")
doc.Close()
几个关键要点:
PermissionStart和PermissionEnd必须使用相同的permissionId才能配对。- 可编辑区域的起止标记必须插入到同一段落内,跨段落标记可能导致行为异常。
- 只有在文档处于保护状态时,可编辑区域的限制才会生效;未保护文档中这些标记没有实际作用。
- 想移除可编辑区域的话,遍历文档子对象,删除对应的
PermissionStart/PermissionEnd即可。
通过以上方法,你可以灵活地为 Word 文档设置不同级别的编辑限制,从简单的只读保护到精细的权限控制,基本都能覆盖。
