使用NetOffice操作Word替换占位符失效且丢失格式如何解决？

问题根因 #

你遇到的执行失败、Find.Text赋值后读取为空都是典型的NetOffice Word对象模型使用误区：

1. 每次访问document.Content都会生成一个全新的Range实例，对应的document.Content.Find也是全新的Find对象，你没有持有实例引用直接赋值，赋值后访问的又是新实例的Text属性，自然返回空字符串，这是预期行为。
2. Find.Execute的参数没有显式指定匹配规则，默认会继承Word上次执行查找时的配置（比如开启了通配符匹配、全字匹配等），就会出现占位符匹配不到的情况。

修正后可运行代码 #

// 初始化Word实例
Application word = new Application();
word.Visible = false;

// 打开模板，第三个参数是只读，如果你要保存修改建议设为false
Document document = word.Documents.Open(fileName, false, false);

// 提前持有Find对象引用，避免每次生成新实例
Find find = document.Content.Find;
find.ClearFormatting();
find.Replacement.ClearFormatting();
// 显式指定所有匹配规则，避免继承旧配置
find.MatchCase = false;
find.MatchWholeWord = false;
find.MatchWildcards = false;
find.MatchSoundsLike = false;
find.MatchAllWordForms = false;
find.Wrap = WdFindWrap.wdFindContinue;

foreach (LetterField field in fields)
{
    find.Text = "{" + field.Key + "}";
    find.Replacement.Text = field.Value;
    // 按参数顺序传入，最后一个参数为替换全部
    find.Execute(Replace: WdReplace.wdReplaceAll);
}

// 替换完成后保存、关闭、释放资源
document.Save();
document.Close();
word.Quit();

注意事项 #

• 不要直接修改document.Content.Text，该属性是纯文本快照，赋值会直接覆盖整个文档的所有格式、图片、表格等非文本元素，符合你遇到的现象。
• 如果占位符存在跨字符格式的情况（比如占位符的{是粗体，后面的文字是常规），可以先调用document.Content.Select()选中全文后再执行替换，兼容格式拆分的场景。
• 调试时如果要验证匹配结果，不要读取find.Text，可以直接打印document.Content.Text查看占位符是否存在，或者执行替换后直接判断Execute的返回值是否为true即可。

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