python-docx生成的超链接无法点击，添加换行后恢复正常的问题咨询

核心问题：超链接的OOXML结构不符合规范 #

你的add_hyperlink函数存在两个关键错误，导致Word无法识别为可点击的超链接：

• 错误使用w:anchor属性：w:anchor是用于链接文档内部书签的属性，而非外部URL。外部URL需要通过关联文档的关系部件（Relationships）来定义，直接用w:anchor绑定URL会让Word无法解析为外部链接。
• 未注册文档关系：Word的OOXML规范中，外部超链接必须在文档的.rels关系文件中注册对应的URL条目。你的代码直接插入w:hyperlink元素，没有完成这一步注册，导致Word不认为这是一个有效的可点击链接。

为什么添加换行后超链接恢复正常？ #

当你添加换行时，Word会自动触发XML结构校验与修复机制。它会识别到这段格式异常的链接文本，尝试将其转换为符合规范的超链接格式——相当于Word帮你补全了缺失的关系注册步骤，所以超链接变得可点击了。

修正后的add_hyperlink函数 #

以下是符合OOXML规范的实现，利用python-docx内部机制正确创建超链接：

from docx import Document
from docx.shared import RGBColor
from docx.oxml import OxmlElement
from docx.oxml.ns import qn
from docx.enum.text import WD_BREAK

def add_hyperlink(paragraph, text, url):
    # 获取文档的关系部件，注册超链接关系
    part = paragraph.part
    r_id = part.relate_to(url, docx.opc.constants.RELATIONSHIP_TYPE.HYPERLINK, is_external=True)
    
    # 创建超链接元素
    hyperlink = OxmlElement('w:hyperlink')
    hyperlink.set(qn('w:rId'), r_id)
    
    # 创建文本运行并设置样式
    run = OxmlElement('w:r')
    rPr = OxmlElement('w:rPr')
    
    color = OxmlElement('w:color')
    color.set(qn('w:val'), '0000FF')
    rPr.append(color)
    run.append(rPr)
    
    # 添加链接文本
    t = OxmlElement('w:t')
    t.text = text
    run.append(t)
    
    hyperlink.append(run)
    paragraph._p.append(hyperlink)

# 使用示例
doc = Document()
base_url = "https://example.com/"
path = "docs/report.docx"

p1 = doc.add_paragraph("file : ", style='Normal')
add_hyperlink(p1, base_url + path, base_url + path)
# 现在无需额外换行，超链接也能正常点击
doc.save("test.docx")

内容的提问来源于stack exchange，提问作者김도현