如何使用Python的ReportLab在PDF中创建文件相对链接？

你的项目结构如下：

project_root/
│
├── workspace/
│   └── generated_report.pdf
│
└── data/
    ├── folder_1/
    │   └── file_1.txt
    └── folder_2/
        └── file_2.txt

原代码的问题在于，你通过拼接PDF所在目录的上级路径和文件的相对路径，生成了绝对路径的file链接，一旦整个project_root文件夹移动位置，链接就会失效。要生成真正的相对链接，核心是计算从PDF文件所在目录（workspace）到目标文件的相对路径，直接用这个路径作为链接地址即可。

修正后的代码如下：

import os
from reportlab.platypus import Paragraph

def generate_link(pdf_path, file_path, styles):
    # 获取PDF文件所在的绝对目录
    pdf_dir = os.path.dirname(os.path.abspath(pdf_path))
    # 计算目标文件相对于PDF目录的相对路径
    relative_file_path = os.path.relpath(file_path, pdf_dir)
    # 把系统路径分隔符替换为PDF链接兼容的正斜杠（避免Windows反斜杠的问题）
    relative_link = relative_file_path.replace(os.sep, '/')
    # 构造相对链接的HTML标签
    return Paragraph(f'<a href="file://{relative_link}">{os.path.basename(file_path)}</a>', styles['BodyText'])

关键说明： #

• os.path.relpath(file_path, pdf_dir)：直接计算目标文件相对于PDF所在目录的相对路径，比如对于file_1.txt，会得到../data/folder_1/file_1.txt
• 替换路径分隔符为正斜杠：PDF的文件链接标准使用正斜杠，避免Windows系统下反斜杠被转义导致链接失效
• 链接格式用file://{relative_link}：这样PDF阅读器会以PDF文件所在位置为基准，解析相对路径找到目标文件

这样生成的链接，不管你把整个project_root文件夹移动到任何位置，只要workspace和data的相对结构保持不变，链接就能正常打开对应的文件。

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