Python docx-mailmerge如何保留Word合并域插入值的首尾空格

问题原因 #

docx-mailmerge 库默认会对传入合并域的字符串做首尾空白截断处理，本质是源码中对传入值调用了strip()方法，和Word本身的渲染逻辑无关。你遇到的首尾空格丢失，是库层面的默认清洗规则导致的。

可行解决方法 #

• 方法1：首尾空格替换为不间断空格（推荐，无侵入、兼容性最好）
  Word识别的不间断空格字符编码为\u00A0，这个字符不会被docx-mailmerge的清洗规则截断，渲染出来的视觉效果和普通半角空格完全一致，只需要把待插入字符串首尾的普通空格替换为该字符即可，中间的空格不需要改动。
  参考实现代码：

  from docx_mailmerge import MailMerge
  
  def preserve_leading_trailing_space(s: str) -> str:
      # 替换前导空格
      lead_space_len = len(s) - len(s.lstrip(' '))
      s = s.replace(' ', '\u00A0', lead_space_len)
      # 替换尾部空格
      trail_space_len = len(s) - len(s.rstrip(' '))
      reversed_s = s[::-1]
      reversed_s = reversed_s.replace(' ', '\u00A0', trail_space_len)
      return reversed_s[::-1]
  
  # 原始带首尾空格的字符串
  str_value = "    Hello I'm         John Doe  "
  processed_value = preserve_leading_trailing_space(str_value)
  
  doc = MailMerge("template.docx")
  doc.merge(phrase=processed_value)
  doc.write("output.docx")
  

  执行后生成的Word文档里，首尾空格会完整保留，和预期显示效果完全一致。

• 方法2：修改库源码去掉截断逻辑（不推荐，可维护性差）
  找到当前Python环境中docx-mailmerge的安装目录，打开其中的merge.py文件，搜索定位到对合并值调用.strip()的代码行，注释或删除该行即可。该方法的缺点是库升级、切换运行环境后需要重复修改，容易出现环境不一致问题。

注意：不要使用全角空格替代首尾普通空格，不同字体、不同排版设置下全角空格的宽度和半角空格存在差异，会导致排版错位，使用\u00A0不间断空格是跨场景兼容性最好的方案。

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