使用xlwings生成Excel HYPERLINK链接点击报错无法打开指定文件如何解决

• 直接通过给单元格赋值HYPERLINK公式的方式，缺少Excel识别本地文件必需的file:/// URI协议前缀，仅写入纯路径会导致部分版本Excel解析路径失败，哪怕表面显示路径和手动插入的一致
• 公式写法不符合Excel规范，缺少第二个显示文本参数也可能触发兼容性问题
• 写入公式的方式本身不如Excel原生插入链接的接口稳定，无法适配所有格式的文件链接

直接使用xlwings封装的原生超链接插入API，效果和手动点击Excel「插入链接」按钮完全一致，支持所有格式的本地文件：

# 指向Excel文件的示例
ws.range(15, 8).add_hyperlink(
    address=r"C:\file.xlsx",  # 目标文件绝对路径，支持任意格式
    text_to_display="点击打开Excel文件"  # 单元格显示的文本，如需显示路径直接填路径即可
)

# 指向非Excel文件的示例，比如PDF、图片、exe等，仅需修改address参数即可
ws.range(16, 8).add_hyperlink(
    address=r"C:\test.pdf",
    text_to_display="点击打开PDF文件"
)

该方法不需要额外处理路径转义、协议前缀，只要文件路径真实存在，系统安装了对应格式的默认打开程序，点击链接就能正常唤起。

如果必须使用公式实现，需要补充file:///协议前缀，同时修正转义逻辑：

# 注意Python字符串转义，路径部分要么用4个反斜杠，要么用原始字符串包裹
ws.range(15, 8).formula = r'=HYPERLINK("file:///C:\file.xlsx", "点击打开文件")'

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