如何在MS Word邮件合并域中保留值的前导空格

Word邮件合并默认会自动裁剪传入文本首尾的普通半角空格，docx-mailmerge库没有覆盖这个默认规则，所以会出现前导空格被清除的问题，以下两种方案都可以解决，按需选择即可：

方案1：代码侧替换前导空格（无需改模板，推荐） #

普通半角空格（Unicode \u0020）会被Word合并逻辑裁剪，替换为不间断半角空格（Unicode \u00A0，对应Word里按Ctrl+Shift+Space输入的空格）就可以保留前导缩进，这个字符的显示宽度、打印效果和普通半角空格完全一致，不会导致排版错位。
修改后的代码示例：

from mailmerge import MailMerge

def preserve_leading_space(input_str: str) -> str:
    # 自动统计前导普通空格数量，替换为不间断空格
    leading_space_len = len(input_str) - len(input_str.lstrip(' '))
    return "\u00A0" * leading_space_len + input_str.lstrip(' ')

def main():
    temp = "string.docx"
    str_data = preserve_leading_space("  Test String")
    doc = MailMerge(temp)
    doc.merge(string_data=str_data)
    file_name = "out_string.docx"
    doc.write(file_name)

如果前导空格数量固定，也可以直接写死替换逻辑，不需要单独写预处理函数。

方案2：修改Word模板（无需调整代码） #

如果不方便改代码，可以直接调整模板规避裁剪规则：

• 打开模板文件string.docx，按Alt+F9切换到域代码显示模式
• 找到对应域{ MERGEFIELD string_data }，将光标移到域的最前面，按Ctrl+Shift+Space插入1个不间断空格
• 再次按Alt+F9切回正常编辑视图，保存模板即可
  这种方式下Word会判定该位置已有固定内容，不会触发首尾空格裁剪逻辑，合并时传入的前导空格可以正常保留。

注意：不要用全角空格替代前导空格，全角空格宽度是普通半角空格的2倍，会导致排版错位。

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