cmake 有多行注释吗

是的，CMake 支持多行注释，但需要满足以下条件：

1. 多行注释语法

在 CMake 3.0 及以上版本 中，可以使用 #[[ ... ]] 语法包裹多行内容作为注释。例如：

#[[
  这是一个多行注释
  可以跨越多行
  不会被CMake解释
]]
project(MyProject)

2. 兼容性说明

• 版本要求：多行注释语法仅在 CMake 3.0 及以上版本中有效。如果使用旧版本（如 2.x），需改用单行注释（每行以 # 开头）或通过条件语句（如 if(FALSE)）包裹代码块实现类似效果。
• 替代方案（旧版本）：

  # 逐行注释
  # project(MyProject)
  # add_executable(...)
  
  # 或使用条件语句
  if(FALSE)
    add_executable(disabled_target ...)
  endif()

3. 注意事项

• 多行注释内的内容必须完全包含在 #[[ 和 ]] 之间，不能嵌套其他块注释。
• 注释内容不会影响 CMake 配置流程，但需确保语法正确（如括号匹配）。

4. 官方文档参考

• https://cmake.org/cmake/help/latest/manual/cmake-language.7.html#comments 明确指出：

  Block comments are supported in CMake 3.0 and later using #[[ ... ]].

总结

• 支持情况：多行注释在 CMake 3.0+ 中原生支持，语法为 #[[ 多行内容 ]]。
• 旧版本兼容：若使用旧版 CMake，需改用单行注释或条件语句模拟多行注释。
• 推荐做法：建议升级到 CMake 3.0 或更高版本以使用多行注释语法，提升代码可读性。