问题根源分析 #

你遇到的问题大概率是两个原因叠加导致的：

• 有些Excel单元格看似为空，实则包含了隐形的空白字符（比如不小心输入的空格）；
• 即便你用str(cell.value or '')得到空字符串，Word邮件合并模板里字段之间的空格在手动合并时会被自动忽略，但mailmerge库会严格保留这些空格，当字段为空时就会留下一个多余的空格。

针对性解决方案 #

我给你两个层面的优化，彻底解决这个问题：

1. 编写单元格值清洗函数，确保空单元格返回真正的空字符串

先写一个辅助函数，不仅处理None类型的空单元格，还会清除单元格里的空白字符，确保空值统一返回''：

def get_clean_cell_value(cell):
    """清洗单元格值，空单元格返回真正的空字符串"""
    raw_value = cell.value
    if raw_value is None:
        return ''
    # 转换为字符串并去除前后所有空白（包括空格、换行等）
    cleaned_str = str(raw_value).strip()
    # 如果清洗后为空，返回空字符串，否则返回清洗后的值
    return cleaned_str if cleaned_str else ''

2. 过滤空字段，跳过空行

在合并时，先过滤掉空的字段，并且跳过那些8个字段全空的行，避免无效合并：

from __future__ import print_function
import os
import openpyxl
from mailmerge import MailMerge
from datetime import date

# 辅助清洗函数
def get_clean_cell_value(cell):
    raw_value = cell.value
    if raw_value is None:
        return ''
    cleaned_str = str(raw_value).strip()
    return cleaned_str if cleaned_str else ''

os.chdir(r'CURRENT WORKING FOLDER')
wb = openpyxl.load_workbook('FullMerge.xlsm', data_only=True)
sheet = wb["Database"]
# 删除首行表头
sheet.delete_rows(sheet.min_row, 1)

template = "FullMerge.docx"
document1 = MailMerge(template)

# 遍历数据行（假设8个字段对应列1到列8）
for row_num in range(1, sheet.max_row + 1):
    # 获取8个字段的清洗后的值
    field1 = get_clean_cell_value(sheet.cell(row=row_num, column=1))
    field2 = get_clean_cell_value(sheet.cell(row=row_num, column=2))
    field3 = get_clean_cell_value(sheet.cell(row=row_num, column=3))
    field4 = get_clean_cell_value(sheet.cell(row=row_num, column=4))
    field5 = get_clean_cell_value(sheet.cell(row=row_num, column=5))
    field6 = get_clean_cell_value(sheet.cell(row=row_num, column=6))
    field7 = get_clean_cell_value(sheet.cell(row=row_num, column=7))
    field8 = get_clean_cell_value(sheet.cell(row=row_num, column=8))
    
    # 检查这一行是否所有字段都为空，是的话跳过
    all_empty = not any([field1, field2, field3, field4, field5, field6, field7, field8])
    if all_empty:
        continue
    
    # 如果模板是按单个字段合并，直接传入清洗后的值
    document1.merge(
        First=field1,
        Second=field2,
        Third=field3,
        Fourth=field4,
        Fifth=field5,
        Sixth=field6,
        Seventh=field7,
        Eighth=field8
    )

document1.write("FinishedMerge.docx")

3. 额外优化：避免模板中空字段导致的多余空格

如果你的Word模板里是类似«First» «Second» «Third»这样的字段拼接，即使字段为空，模板里的空格会保留。这时候可以换一种方式：在Python里先把有效字段拼接成无多余空格的字符串，再合并到模板的单个字段中。

比如模板里只保留一个«CombinedFields»字段，然后在代码里处理：

# 把非空字段收集起来，用空格连接
combined_fields = ' '.join(filter(None, [field1, field2, field3, field4, field5, field6, field7, field8]))
document1.merge(CombinedFields=combined_fields)

这样就彻底避免了空字段带来的多余空格，效果和手动合并完全一致。

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