如何消除Doxygen编译文档时的/test路径不可读警告？

问题原因 #

警告里的/test是根目录路径，说明你的Doxyfile.in中@srcdir@变量未被CMake正确替换为包内test文件夹的实际路径，导致Doxygen错误尝试访问根目录下的test目录，而非你包内的目标文件夹。

解决方案 #

1. 修正EXAMPLE_PATH的变量引用 #

将Doxyfile.in中的EXAMPLE_PATH配置替换为和INPUT一致的CMake标准变量，确保路径基准统一：

EXAMPLE_PATH           = @CMAKE_CURRENT_SOURCE_DIR@/test

你的INPUT已经用@CMAKE_CURRENT_SOURCE_DIR@指向包的根目录，复用该变量可直接定位到包内的test文件夹，避免路径解析偏差。

2. 重新生成Doxyfile #

修改Doxyfile.in后，在build目录重新执行CMake配置命令（如cmake ..），让CMake重新替换变量生成正确的Doxyfile。

3. 验证路径正确性 #

打开生成的Doxyfile，检查EXAMPLE_PATH的值是否为包内test文件夹的实际路径（比如/home/yourname/your_package/test或相对路径），确认不是/test。

额外排查 #

若警告仍存在，检查是否有其他Doxygen配置项（如FILE_PATTERNS、EXCLUDE）错误引用了/test路径，或用ls -l确认包内test文件夹的可读权限（Ubuntu默认权限通常无问题）。

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