如何隐藏Python tracebacks中的文件绝对路径，仅输出相对路径？

Python本身没有内置的全局配置参数可以直接强制traceback输出相对路径，但是可以通过以下两种简便方式实现需求。

方案1：使用第三方库快速实现 #

如果不介意安装额外依赖，relpath-tb是专门用于修改traceback路径格式的轻量库，操作步骤如下：

• 安装依赖

pip install relpath-tb

• 在项目入口文件开头添加启用代码

import relpath_tb
# root参数填项目根目录的路径，不填默认使用当前工作目录
relpath_tb.enable(root="C:/Users/user/Documents/project")

配置完成后所有traceback输出的文件路径都会自动转为相对于root参数的相对路径，你的示例场景会直接输出project_align/src/main.py。

方案2：自定义异常钩子（无额外依赖） #

如果不想安装第三方库，可以通过重写sys.excepthook自定义异常处理逻辑，自己实现路径替换，代码示例如下：

import sys
import os
from traceback import format_exception

def custom_excepthook(exc_type, exc_value, exc_traceback):
    # 可替换为你自己的项目根目录绝对路径
    project_root = "C:/Users/user/Documents/project"
    # 格式化原始traceback
    tb_content = format_exception(exc_type, exc_value, exc_traceback)
    # 逐行替换绝对路径为相对路径
    for line_idx, line_content in enumerate(tb_content):
        if 'File "' in line_content:
            # 提取原始绝对路径
            path_start = line_content.find('File "') + 6
            path_end = line_content.find('", line ')
            abs_path = line_content[path_start:path_end]
            # 转换为相对路径
            try:
                rel_path = os.path.relpath(abs_path, project_root)
                tb_content[line_idx] = line_content.replace(abs_path, rel_path)
            except ValueError:
                # Windows跨盘符场景转换失败时保留原路径
                continue
    # 输出修改后的traceback
    sys.stderr.write(''.join(tb_content))

# 注册自定义异常钩子
sys.excepthook = custom_excepthook

# 测试代码
if __name__ == "__main__":
    raise Exception

该方案完全基于Python标准库实现，可灵活自定义路径转换规则，适配不同项目结构。

注意事项 #

• 两种方案都仅作用于当前Python进程，不会影响系统其他Python程序的traceback输出
• 若使用IDE运行代码，部分IDE会默认接管异常输出，需要关闭IDE的内置异常捕获功能才能看到修改后的效果

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