Word书签替换必须使用Bookmarks集合，通过Range.Text直接赋值最稳定；书签名需合法、替换前校验IsValid、批量操作应缓存Bookmarks集合、关闭文档时须显式SaveChanges并调用Fields.Update。
Word书签替换必须用 Bookmarks 集合，别碰 ContentControls 或 Fields
直接操作书签（Bookmark）是最稳定、最轻量的模板填充方式。很多开发者误用内容控件或域字段，结果在不同 Office 版本里行为不一致，甚至保存后书签消失。Bookmarks 是 Word 原生标记机制，只要文档里插的是「插入 → 书签」创建的命名区域，就该走这条路。
关键点：书签本身不可见，它包裹的是一个位置（可能为空），不是一段可选中文本——所以替换时得先获取其 Range，再用 .Text 赋值覆盖，而不是试图“查找并替换文本”。
-
Application实例必须显式设置Visible = false，否则后台启动 Word 进程会卡住且无法释放 - 书签名不能含空格、特殊字符（如
客户名称要写成CustomerName），否则Document.Bookmarks["xxx"]取不到 - 替换前务必检查
book.IsValid，有些模板书签被用户误删或格式化后残留但失效，直接访问会抛COMException
用 Range.Text 替换比 Range.InsertBefore/After 更安全
很多人想“保留原书签位置”，于是用 InsertBefore 插入新内容再删旧内容，这会导致书签自动解绑——Word 会把原书签连同它的 Range 一起丢弃。正确做法是：拿到书签的 Range 后，直接赋值 range.Text = "新值"，Word 会自动维持该位置的书签名不变（只要新内容不为空）。
示例：
var bookmark = doc.Bookmarks["OrderDate"];
if (bookmark != null && bookmark.Exists)
{
var range = bookmark.Range;
range.Text = DateTime.Now.ToString("yyyy年MM月dd日"); // 直接赋值，书签还在
}
- 如果新值为空字符串（
""），书签会被自动删除，这是 Word 的默认行为，无法绕过 - 若需保留空占位，可赋一个全角空格
"\u3000"或零宽空格"\u200B" - 对含格式的场景（如日期加粗），别用
Text，改用range.FormattedText复制源样式，但注意性能略低
批量替换时避免反复调用 Bookmarks 导致 COM 性能骤降
每次访问 doc.Bookmarks["xxx"] 都是一次 COM 调用，100 个书签就 100 次跨进程通信。实测在 .NET 6+ Windows 上，50 个书签逐个查+赋值平均耗时 1.2 秒；而一次性取全部 Bookmarks 到本地数组再遍历，降到 0.3 秒内。
- 用
for (int i = doc.Bookmarks.Count; i >= 1; i--)倒序遍历，防止替换过程中书签索引错乱（虽然罕见，但 Word COM 有时会动态重排） - 不要用
foreach (var bm in doc.Bookmarks)—— COM 集合不支持标准枚举器，会报InvalidCastException - 若模板中书签命名有规律（如
Field_01,Field_02），优先用doc.Bookmarks.get_Item(i)索引访问，比字符串 Key 查找快 30%+
关闭文档前必须手动调用 doc.Close(SaveChanges: true)，否则书签修改不生效
很多人以为 app.Quit() 会自动保存，其实不会。Word COM 对象的变更只存在于内存中的 Document 实例，不显式 Close(true)，所有 Range.Text 修改都会丢失，且临时文件残留导致后续打开失败。
- 务必在
try/finally中调用doc.Close(true)和app.Quit()，确保异常时也能落盘 - 不要依赖
GC.Collect()强制释放 COM 对象——它不可靠，且可能引发RPC_E_CALL_REJECTED - 如果生成大量文档，建议复用同一个
Application实例（而非每次 new），但要注意线程 Apartment 状态必须为STA，否则Bookmarks访问直接崩溃
最易被忽略的一点：书签替换后若文档含“更新域”（如页码、目录），这些域不会自动刷新——需要额外调用 doc.Fields.Update()，否则生成的 PDF 里页码还是旧的。
