如何使用python-docx或其他库修改Word文档中的所有超链接？

阿华AIGC实验室

2026-4-14

我完全理解你的困扰——python-docx的Hyperlink对象确实没有提供直接修改address的接口，这也是很多开发者踩过的坑。咱们一步步来解决这个问题：

为什么你之前的方法没用？

首先，hyperlink.address = "www.google.com"报错是因为这个属性是只读的，python-docx并没有实现它的setter方法。而你尝试把link变量直接赋值成字符串，只是修改了循环里的临时变量，根本没碰文档里的实际元素，所以保存后完全没变化。

解决方案1：用python-docx操作底层XML/关系（跨平台）

python-docx基于Open XML格式，我们可以绕过顶层的Hyperlink类，直接操作底层的关系对象来修改链接地址。每个超链接的实际地址存在文档的"关系部件"里，通过r:id关联到文档中的超链接元素。

具体代码如下：

from docx import Document
from docx.opc.constants import RELATIONSHIP_TYPE as RT

# 1. 加载文档和链接映射（这里替换成你从CSV读取的映射）
document = Document("你的原始文档.docx")
link_mapping = {
    "旧链接1.com": "新链接1.com",
    "旧链接2.com": "新链接2.com",
    # 更多映射...
}

# 2. 先建立rId到关系对象的映射，方便快速查找
rel_id_map = {rel.rId: rel for rel in document.part.rels.values()}

# 3. 遍历文档中所有段落（包括表格里的）的超链接
def update_hyperlinks_in_paragraphs(paragraphs):
    for paragraph in paragraphs:
        for hyperlink in paragraph.hyperlinks:
            # 获取超链接对应的rId
            r_id = hyperlink._element.get("r:id")
            if not r_id:
                continue
            # 找到对应的关系对象
            rel = rel_id_map.get(r_id)
            if rel and rel.reltype == RT.HYPERLINK:
                old_address = rel.target
                # 如果旧地址在映射里，替换成新地址
                if old_address in link_mapping:
                    rel._target = link_mapping[old_address]

# 更新普通段落的超链接
update_hyperlinks_in_paragraphs(document.paragraphs)

# 更新表格单元格里的超链接
for table in document.tables:
    for row in table.rows:
        for cell in row.cells:
            update_hyperlinks_in_paragraphs(cell.paragraphs)

# 4. 保存修改后的文档
document.save("更新后的文档.docx")

这段代码的核心是：通过hyperlink._element获取底层XML元素，拿到r:id后找到对应的关系对象，直接修改其_target属性来更新链接地址。

解决方案2：用win32com直接调用Word COM接口（Windows专属）

如果你是在Windows环境下，并且安装了Microsoft Word，用win32com会更简单直观，它直接调用Word的原生API，支持直接修改超链接的Address属性：

import win32com.client as win32

# 初始化Word应用（后台运行，不打开窗口）
word = win32.gencache.EnsureDispatch('Word.Application')
word.Visible = False

# 打开文档
doc = word.Documents.Open("你的原始文档.docx")

# 链接映射（同样替换成你的实际映射）
link_mapping = {
    "旧链接1.com": "新链接1.com",
    "旧链接2.com": "新链接2.com",
}

# 遍历所有超链接并修改
for hyperlink in doc.Hyperlinks:
    old_address = hyperlink.Address
    if old_address in link_mapping:
        hyperlink.Address = link_mapping[old_address]

# 保存并关闭
doc.SaveAs("更新后的文档_win32.docx")
doc.Close()
word.Quit()

这个方法不需要关心底层XML，代码更简洁，但缺点是只能在Windows上用，而且依赖Word软件。