Ubuntu 24.10下doxywizard无法调用doxygen生成输出的问题排查

问题背景 #

• 环境：Ubuntu 24.10，手动下载的doxygen 1.12.0（含doxywizard），未加入系统PATH，which doxygen无法定位到可执行文件
• 关键现象：
  • 命令行启动doxywizard正常：

    ~/mark/doxygen-1.12.0/bin$ ./doxywizard
    

  • 版本信息验证正常：

    ~/mark/doxygen-1.12.0/bin$ ./doxywizard --version
    Doxywizard version: 1.12.0 
    (c73f5d30f9e8b1df5ba15a1d064ff2067cbb8267), Qt version: created with 6.2.4, running with 6.6.2
    

    ~/mark/doxygen-1.12.0/bin$ ./doxygen -v
    1.12.0 (c73f5d30f9e8b1df5ba15a1d064ff2067cbb8267)
    

  • 配置项目保存后，点击“Run doxygen”仅提示：

    *** Failed to run doxygen

  • 命令行执行doxygen（指定正确路径或在bin目录下）可正常生成文档，/var/log无相关日志，GitHub issues未找到对应问题。

排查步骤 #

1. 手动指定Doxywizard中的doxygen路径 #

Doxywizard默认从系统PATH查找doxygen，因为你的版本不在PATH中，需手动配置：

• 打开Doxywizard，切换到Run标签页
• 找到Doxygen executable选项，填入绝对路径：~/mark/doxygen-1.12.0/bin/doxygen
• 保存配置后重新点击“Run doxygen”测试

2. 临时将bin目录加入PATH后启动Doxywizard #

从命令行启动前先配置环境变量，让Doxywizard能自动找到doxygen：

export PATH="$PATH:~/mark/doxygen-1.12.0/bin"
cd ~/mark/doxygen-1.12.0/bin
./doxywizard

之后再尝试运行doxygen。

3. 捕获Doxywizard的启动与运行日志 #

启动时保留命令行输出，可能会暴露错误细节：

cd ~/mark/doxygen-1.12.0/bin
./doxywizard 2>&1 | tee doxywizard.log

点击“Run doxygen”后，查看生成的doxywizard.log文件，查找具体失败原因。

4. 检查配置文件中的doxygen路径 #

打开你保存的配置文件myconfig.file，搜索DOXYGEN_EXECUTABLE字段：

• 若存在，确认其值为正确的绝对路径
• 若不存在，手动添加：

  DOXYGEN_EXECUTABLE       = ~/mark/doxygen-1.12.0/bin/doxygen
  

保存后用Doxywizard加载该配置，重新测试。

5. 验证可执行文件权限 #

确认doxygen和doxywizard拥有执行权限：

ls -l ~/mark/doxygen-1.12.0/bin/doxygen ~/mark/doxygen-1.12.0/bin/doxywizard

如果权限不足，执行以下命令添加：

chmod +x ~/mark/doxygen-1.12.0/bin/doxygen ~/mark/doxygen-1.12.0/bin/doxywizard

6. 模拟Doxywizard的调用命令 #

在Doxywizard的Run标签页，复制Command line中的完整命令，在终端执行（注意替换doxygen为绝对路径），查看具体报错信息，定位问题。

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