如何用Python及python-docx向现有Word文档表格指定单元格插入数据？

索引不一致的核心原因 #

• 合并单元格干扰：python-docx的单元格索引按存储逻辑计数，合并区域仅保留左上角单元格的索引，视觉上的行列顺序和实际索引序列不匹配，是最常见的索引错位原因
• 表格计数错误：Document.tables列表从0开始计数，若文档存在隐藏表格、嵌套表格，很容易选错目标表格

python-docx 可行定位方案 #

方案1：锚点内容定位（最稳定） #

若表格存在固定表头/标识文字，可遍历匹配锚点内容后偏移到目标单元格，不受合并单元格影响：

from docx import Document

doc = Document("目标文档.docx")
table = doc.tables[0]  # 调整索引选择对应表格
target = None

for row_idx, row in enumerate(table.rows):
    for col_idx, cell in enumerate(row.cells):
        if cell.text.strip() == "锚点文字":  # 替换为实际的固定标识文字，比如“总计”
            # 示例：取锚点右侧1列的单元格，向下偏移则取table.rows[row_idx+1].cells[col_idx]
            target = row.cells[col_idx + 1]
            break
    if target:
        break

if target:
    target.text = "待写入的数据"
doc.save("输出文档.docx")

方案2：预打印索引映射确认规则 #

不确定索引对应关系时，先运行脚本打印所有单元格的索引和内容，对照Word文档确认对应规则，不要主观猜测索引：

from docx import Document
doc = Document("目标文档.docx")
table = doc.tables[0]
for row_idx, row in enumerate(table.rows):
    for col_idx, cell in enumerate(row.cells):
        print(f"行索引:{row_idx} 列索引:{col_idx} 内容:{cell.text.strip()}")

方案3：书签定位 #

提前在Word中给目标单元格插入自定义书签，直接通过书签定位，完全不需要处理索引：

from docx import Document
doc = Document("目标文档.docx")
for bk in doc.bookmarks:
    if bk.name == "自定义书签名":
        bk.parent.text = "待写入的数据"
        break
doc.save("输出文档.docx")

替代模块推荐 #

如果文档格式复杂、合并单元格较多，可使用win32com.client模块（仅Windows系统可用，需本地安装Office Word），直接调用Word原生接口操作，行列索引和视觉呈现完全一致，无索引错位问题：

import win32com.client as win32

word = win32.gencache.EnsureDispatch('Word.Application')
word.Visible = False
doc = word.Documents.Open(r"目标文档的绝对路径.docx")
# 表格、行、列索引均从1开始计数，和视觉上的顺序完全一致
table = doc.Tables(1)
table.Cell(2, 3).Range.Text = "待写入的数据"
doc.Save()
doc.Close()
word.Quit()

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