CMake LaTeX自定义目标仅指定ALL时运行的问题排查

1. 移除ALL参数后，自定义文档目标不会被默认构建目标（如all/DEFAULT）包含，因此默认执行make/ninja时不会触发文档构建。
2. 原ALL模式下每次都强制编译，是因为自定义命令未正确声明依赖关系，导致CMake无法检测源文件是否变更，只能每次都执行编译命令。
3. 你之前的CSV场景生效，是因为CSV文件是某个可执行/库目标的输入依赖，CMake在构建该目标时会自动检查并生成CSV；而LaTeX文档是独立目标，无其他默认目标依赖它，因此不会自动触发。

方案1：保留ALL但让CMake智能判断是否重构 #

解决原ALL模式下每次编译的问题，同时让文档随默认构建自动更新（仅当依赖变更时）：

# 配置文档路径
set(DOC_SOURCE ${CMAKE_CURRENT_SOURCE_DIR}/docs/doc1.tex)
set(DOC_OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/docs/doc1.pdf)

# 定义LaTeX编译命令，明确依赖与中间产物
add_custom_command(
  OUTPUT ${DOC_OUTPUT}
  # 两次pdflatex处理交叉引用，若用bibtex需追加对应命令
  COMMAND pdflatex -output-directory=${CMAKE_CURRENT_BINARY_DIR}/docs ${DOC_SOURCE}
  COMMAND pdflatex -output-directory=${CMAKE_CURRENT_BINARY_DIR}/docs ${DOC_SOURCE}
  # COMMAND bibtex ${CMAKE_CURRENT_BINARY_DIR}/docs/doc1  # 若有参考文献则启用
  MAIN_DEPENDENCY ${DOC_SOURCE}
  # 声明所有额外依赖：bib文件、自定义样式文件等
  DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/docs/doc1.bib
          ${CMAKE_CURRENT_SOURCE_DIR}/docs/custom.sty
  # 声明中间产物，避免CMake判定构建失败
  BYPRODUCTS ${CMAKE_CURRENT_BINARY_DIR}/docs/doc1.aux
             ${CMAKE_CURRENT_BINARY_DIR}/docs/doc1.log
             ${CMAKE_CURRENT_BINARY_DIR}/docs/doc1.blg
             ${CMAKE_CURRENT_BINARY_DIR}/docs/doc1.bbl
  COMMENT "Building LaTeX document: doc1.pdf"
)

# 创建带ALL的自定义目标，仅在依赖变更时触发构建
add_custom_target(build_doc ALL DEPENDS ${DOC_OUTPUT})

方案2：移除ALL但实现依赖变更触发构建 #

如果不想让文档随默认构建执行，可移除ALL，通过以下方式触发：

1. 手动执行构建命令：make build_doc（Makefile生成器）或ninja build_doc（Ninja生成器）
2. 将文档目标关联到install等必执行目标，执行make install时自动检查并构建：

# 自定义命令部分同方案1，省略...

# 创建不带ALL的自定义目标
add_custom_target(build_doc DEPENDS ${DOC_OUTPUT})

# 关联到install目标，执行安装时自动构建文档（依赖变更时）
install(FILES ${DOC_OUTPUT} DESTINATION ${CMAKE_INSTALL_DOCDIR})
add_dependencies(install build_doc)

• 必须声明所有依赖：包括.tex主文件、.bib参考文献、.sty样式文件等，否则CMake无法检测源文件变更。
• 处理LaTeX中间文件：用BYPRODUCTS声明aux/log/bbl等中间文件，避免CMake因文件缺失判定构建失败，同时支持自动清理。
• 多次编译LaTeX：处理交叉引用、参考文献时需多次执行pdflatex，必要时追加bibtex命令。

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