如何让Doxygen日志文件使用相对路径而非绝对路径？

针对你遇到的Doxygen日志输出绝对路径、无法统一提交到版本控制的问题，这里有几个靠谱的解决办法：

1. 配置Doxyfile的路径剥离参数 #

这是最直接的官方解决方案，之前你可能没配对参数组合：

• 打开你的Doxyfile，找到FULL_PATH_NAMES，确保它设置为YES（默认通常是YES，这个参数控制是否显示完整路径）
• 找到STRIP_FROM_PATH，将其设置为你的项目根目录的绝对路径。比如你的项目放在/Users/xxx/my_doxy_proj，就写：

  STRIP_FROM_PATH = /Users/xxx/my_doxy_proj
  

  Doxygen会自动把日志中所有路径的这个前缀去掉，剩下的就是相对于项目根的路径。
• 如果是团队协作，不想硬编码绝对路径，可以在生成Doxyfile时动态填充这个值。比如用CMake的话，可以加这么一行：

  set(DOXYGEN_STRIP_FROM_PATH ${CMAKE_CURRENT_SOURCE_DIR})
  

  这样每个用户构建时，脚本会自动把当前项目根目录的绝对路径传入Doxyfile。

2. 用脚本批量替换日志中的绝对路径 #

如果上面的配置方法没生效（比如某些特殊版本的Doxygen存在兼容问题），可以在Doxygen生成日志后，用脚本自动替换路径：

Shell脚本（Linux/macOS） #

写一个简单的shell脚本，放在项目根目录，每次运行Doxygen后执行：

#!/bin/bash
PROJ_ROOT=$(pwd)
# 替换日志中的项目根绝对路径为空，保留相对部分
sed -i.bak "s|$PROJ_ROOT/||g" doxygen.log
# 可选：删除备份文件
rm doxygen.log.bak

Python脚本（跨平台） #

如果团队里有Windows用户，用Python脚本更通用：

import os

# 获取当前项目根的绝对路径
proj_root = os.path.abspath(os.getcwd())
log_path = "doxygen.log"

with open(log_path, "r", encoding="utf-8") as f:
    log_content = f.read()

# 替换绝对路径前缀为相对路径起始
log_content = log_content.replace(f"{proj_root}/", "")

with open(log_path, "w", encoding="utf-8") as f:
    f.write(log_content)

把这个脚本加到你的构建流程里（比如Makefile、package.json的脚本命令），每次生成日志后自动处理。

3. 检查WARN_FORMAT参数是否被自定义 #

如果你修改过WARN_FORMAT参数，要确保它用的是$file变量，而不是硬编码的绝对路径格式。默认的WARN_FORMAT是：

WARN_FORMAT = "$file:$line: $text"

这个$file会受到前面FULL_PATH_NAMES和STRIP_FROM_PATH的控制，要是你改成了带绝对路径的格式，那前面的配置就没用了。

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