如何让qdoc 6.5.1覆盖已存在的非空html输出目录？

QDoc 6.5.1没有内置配置项允许直接覆盖非空输出目录，你可以通过以下方式解决这个问题：

• 预清理输出目录后再生成
  在执行qdoc命令前，手动清空或删除./html目录，再运行生成命令：

  • Linux/macOS终端：

    rm -rf ./html && qdoc project.qdocconf
    

  • Windows PowerShell：

    Remove-Item -Recurse -Force ./html; qdoc project.qdocconf
    

  • Windows命令提示符（CMD）：

    rmdir /s /q html && mkdir html && qdoc project.qdocconf
    

• 使用QDoc的清理命令
  先执行QDoc的清理命令删除整个输出目录，再执行生成命令：

  qdoc --clean project.qdocconf
  qdoc project.qdocconf
  

  --clean参数会彻底移除配置文件中指定的输出目录，后续qdoc生成文档时会自动重建该目录。

• 编写自动化脚本
  如果需要频繁生成文档，可以写一个简单的脚本（比如bash脚本或Windows批处理文件），把清理和生成步骤整合在一起，一键执行。

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