如何在CMake中设置变量为只读/常量，防止其被覆盖？

CMake本身并没有原生提供"只读变量"的特性，但我们可以通过几种巧妙的方式来模拟这个需求，让变量被设置后无法被轻易覆盖，同时触发警告。下面是几种实用的方案：

方案一：利用缓存变量的特性 #

CMake的缓存变量默认是不能被普通set()命令修改的，必须加上FORCE选项才能覆盖。我们可以利用这一点来实现类似只读的效果：

# 将变量设置为缓存变量，FORCE确保初始值生效
set(VAR "content" CACHE STRING "我的只读变量" FORCE)

# 尝试修改变量（无FORCE选项）
set(VAR "overridden")

当执行上面的代码时，CMake会自动输出警告：

VAR is already in cache, ignoring set() command.

而且VAR的值会保持为content不变。如果有人想要强制覆盖，必须显式加上FORCE，这就给了我们足够的提示和控制权。

优点：无需额外编写宏/函数，利用CMake原生特性实现，简单直接。
缺点：变量会被存入CMakeCache.txt中，属于全局缓存变量，而非本地内部变量。

方案二：自定义宏实现真正的内部只读变量 #

如果你需要的是普通的内部变量（不存入缓存），可以通过自定义宏来标记变量为只读，并拦截后续的修改操作：

# 维护一个只读变量的列表，用来跟踪哪些变量不可修改
set(READONLY_VARS "")

# 自定义宏：设置只读变量
macro(set_readonly VAR_NAME VALUE)
    # 设置变量初始值
    set(${VAR_NAME} "${VALUE}")
    # 将变量加入只读列表
    list(APPEND READONLY_VARS "${VAR_NAME}")
endmacro()

# 重载原生的set命令，拦截对只读变量的修改
macro(set VAR_NAME)
    # 检查当前变量是否在只读列表中
    list(FIND READONLY_VARS "${VAR_NAME}" _IS_READONLY)
    if(NOT _IS_READONLY EQUAL -1)
        # 输出警告信息
        message(WARNING "variable ${VAR_NAME} is readonly, cannot be overridden")
    else()
        # 调用原生的set命令处理正常变量
        _set(${VAR_NAME} ${ARGN})
    endif()
endmacro()

# 使用示例
set_readonly(VAR "content")
set(VAR "overridden") # 这里会触发警告，VAR的值仍为"content"

这个方案的核心是重载了set宏，每次调用set时都会先检查目标变量是否被标记为只读，如果是则输出警告并忽略修改；否则执行原生的set操作。

优点：适用于内部变量，不会写入缓存，完全自定义控制警告信息。
注意事项：重载set宏可能会影响其他依赖原生set选项的代码，比如带PARENT_SCOPE、CACHE等参数的场景。如果需要兼容这些场景，可以在重载的宏里添加对参数的处理，传递给原生_set命令。

方案三：结合全局钩子（进阶） #

如果你需要在整个项目中强制保护某些变量，可以利用CMake的CMAKE_PROJECT_INCLUDE机制，在项目初始化时加载自定义的策略文件，全局拦截变量修改。不过这个方案相对复杂，适合大型项目的全局规范。

总结来说，如果你只需要简单的保护，方案一足够好用；如果需要内部变量的只读特性，方案二更灵活。

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