如何使用Fitz模块为PDF中的超链接添加可见边框？

问题分析 #

使用PyMuPDF给PDF超链接添加边框后无法显示，通常和链接属性设置方式、PDF阅读器默认配置有关，以下是几种可行解决方案：

方案1：插入链接时直接定义边框属性 #

无需事后单独设置链接边框，在插入链接的字典参数中直接指定边框和颜色属性，确保属性被正确写入PDF：

import fitz

doc = fitz.open("test.pdf")
page = doc[0]

# 插入URI链接时，直接包含边框与颜色配置
link_params = {
    'kind': 2,
    'xref': 0,
    'from': fitz.Rect(90, 240, 200, 270),
    'uri': 'https://www.google.fr',
    'id': '',
    'border': {'width': 1.0, 'dashes': [], 'style': 'S'},  # 实线边框，宽度1px
    'color': (1, 0, 1)  # 紫色边框，RGB浮点值范围0-1
}
page.insert_link(link_params)

doc.saveIncr()

方案2：检查PDF阅读器显示设置 #

很多PDF阅读器默认隐藏链接边框，需手动开启显示：

• Adobe Acrobat：进入「编辑→首选项→辅助工具」，勾选「显示链接边框」；
• 其他阅读器：查找「视图」或「设置」中的「链接显示」相关选项，开启边框显示。

方案3：用矩形注释模拟链接边框 #

若链接原生边框仍不生效，可直接在链接区域绘制矩形注释，这种方式兼容性更强：

import fitz

doc = fitz.open("test.pdf")
page = doc[0]

# 先插入超链接
link_rect = fitz.Rect(90, 240, 200, 270)
page.insert_link({
    'kind': 2,
    'xref': 0,
    'from': link_rect,
    'uri': 'https://www.google.fr',
    'id': ''
})

# 添加矩形注释作为边框
border_annot = page.add_rect_annot(link_rect)
border_annot.set_border(width=1.0, dashes=[], style='S')
border_annot.set_colors(stroke=(1, 0, 1))
border_annot.update()  # 必须调用update使注释生效

doc.saveIncr()

额外注意事项 #

• 若增量保存（saveIncr()）无效，尝试使用doc.save("new_test.pdf")另存为新文件，避免原PDF的缓存或格式问题；
• 颜色值需使用0-1范围的RGB浮点值，若需转换十六进制颜色，可按hex_val / 255计算对应浮点值。

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