Doxygen生成的refman.tex经MiKTeX编译PDF失败求助

问题描述 #

之前通过Doxywizard成功生成LaTeX文件refman.tex并编译为PDF，修改Doxywizard配置后，执行流程出现异常：

• Doxywizard执行成功，生成refman.tex文件
• 打开refman.tex选择pdfLaTex+MakeIndex+BibTex编译时，报错：Sorry, but "MiKTeX Compiler Driver" did not succeed
• 查看texify.log，仅显示：TeX engine failed for some reason
• 额外问题：MiKTeX目录中找不到texify文件夹及mcd.cpp文件

解决方案 #

1. 回溯Doxygen配置变更 #

• 检查近期修改的Doxygen配置项，重点核对：
  • GENERATE_LATEX：必须设为YES
  • LATEX_OUTPUT：确认输出目录存在且有读写权限
  • LATEX_CMD_NAME、MAKEINDEX_CMD_NAME、BIBTEX_CMD_NAME：确保指向MiKTeX对应工具的完整路径（例如C:\Program Files\MiKTeX\miktex\bin\x64\pdflatex.exe）
• 先恢复到之前能正常编译的配置，再逐步调整测试，定位引发问题的具体配置项

2. 修复MiKTeX环境 #

• 打开MiKTeX Console，进入Tasks标签页，依次执行：
  • Refresh file name database
  • Update package database
  • Install missing packages
• 验证MiKTeX工具路径：
  • 确认pdflatex.exe、makeindex.exe、bibtex.exe存在于MiKTeX的bin\x64（对应系统架构）目录下
  • 将该路径添加到系统环境变量PATH中，重启编辑器后重试编译

3. 手动分步编译排查 #

放弃IDE的一键编译，在LaTeX输出目录打开命令行窗口，依次执行以下命令：

pdflatex refman.tex
makeindex refman.idx
bibtex refman
pdflatex refman.tex
pdflatex refman.tex

• 每一步执行后查看控制台的具体错误提示（如缺失宏包、引用异常），针对性解决
• 若提示宏包缺失，通过MiKTeX Console搜索安装对应包

4. 修复MiKTeX安装完整性 #

• texify是MiKTeX的核心编译驱动，找不到相关文件说明安装不完整或损坏：
  • 卸载现有MiKTeX，下载最新官方安装包，选择完整安装（避免精简安装导致组件缺失）
  • 安装完成后，确认texify.exe存在于MiKTeX的bin\x64目录下

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