Doxygen 1.11.0复制只读图片至输出目录时出错的解决方案求助

• Doxygen 1.11.0版本在资源复制逻辑上做了变更，相比1.8.20新增了二次写入/校验步骤。第一次复制图片时，直接继承了源文件的只读权限，第二次尝试覆盖或更新该文件时，就会因权限不足触发报错。
• 新版本的增量生成或缓存机制存在异常：即便提前删除了输出目录，doxygen进程内可能残留状态判断，导致重复执行写入操作；或者在文件复制后的权限处理环节，错误地将目标文件锁为只读，后续流程未解锁就再次写入。

• 预处理源文件权限：临时移除源图片的只读属性，生成文档后再恢复。
  Linux/macOS下执行：

  chmod +w /path_to_source_images/images/an_image.png
  doxygen your_doxygen_config
  chmod -w /path_to_source_images/images/an_image.png
  

  Windows下执行：

  attrib -R "C:\path_to_source_images\images\an_image.png"
  doxygen your_doxygen_config
  attrib +R "C:\path_to_source_images\images\an_image.png"
  

• 强制完全生成：运行doxygen前，彻底清理输出目录（比如用脚本先执行rm -rf /path_to_output/html），同时检查doxygen配置文件，关闭可能的增量生成相关选项，确保输出目录被完全重建。
• 中转图片目录：将只读图片复制到临时目录，移除临时目录内图片的只读权限，把这个临时目录设为doxygen的图片源目录，生成完成后删除临时目录。
• 修复输出目录权限：确认输出目录所在路径有可写权限，避免文件被意外标记为只读。

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