CMake变量与属性有何区别？二者核心差异解析

作为天天跟CMake打交道的开发者，我太懂这种困惑了——变量和属性乍看功能重叠，都能控制构建，但其实是CMake体系里两个定位完全不同的设计，核心差异主要在这几个维度：

1. 本质定位：无主的“键值容器” vs 有主的“对象元数据” #

• 变量是无归属的键值对，它的作用范围是「全局」或「特定作用域」（比如函数、目录、脚本块）。你可以把它理解成普通编程语言里的变量，用来存储全局配置、临时计算结果或者跨作用域传递的数据。
  比如预定义的CMAKE_SOURCE_DIR是全局变量，存储项目根目录路径；你自己定义的MY_PROJECT_VERSION可以在整个项目里引用。
• 属性是绑定到特定CMake对象的元数据，必须依附于某个实体存在——比如目标（target，可执行文件/库）、目录（directory）、源文件（source file）、测试用例（test）等。它的作用是给这个具体对象添加配置细节。
  比如目标属性OUTPUT_NAME用来指定生成的二进制文件名，源文件属性COMPILE_DEFINITIONS给单个源文件添加编译宏，都是针对特定对象生效的。

2. 作用范围与传播逻辑 #

• 变量的作用范围是层级隔离的：默认情况下，子目录无法直接访问父目录的变量，函数内部的变量也不会泄露到外部，必须通过set(... PARENT_SCOPE)手动传递，或者用CMAKE_INCLUDE_CURRENT_DIR之类的特殊设置。全局变量则能在整个项目中访问。
• 属性的传播是对象关联式的：部分属性支持继承和自动传播，尤其是带INTERFACE_前缀的属性——这是现代CMake模块化设计的核心。比如你给一个库设置INTERFACE_CXX_STANDARD 17，所有链接这个库的目标都会自动继承这个C++标准配置，完全不需要手动传递变量，这是变量做不到的。

3. 预定义实体的用途区分 #

CMake的预定义变量和属性分工明确：

• 预定义变量大多用来控制全局/作用域级的构建规则：比如CMAKE_BUILD_TYPE控制Debug/Release等构建类型，CMAKE_C_COMPILER指定C编译器路径，CMAKE_INSTALL_PREFIX设置安装目录。
• 预定义属性大多用来配置具体对象的细节：比如目标的LINK_LIBRARIES设置链接依赖，目录的INCLUDE_DIRECTORIES控制该目录下目标的头文件搜索路径，源文件的SKIP_BUILD_RPATH控制是否跳过构建时的RPATH设置。

4. 操作语法的差异 #

两者的设置、查询语法完全不同：

• 变量用通用的set()和直接引用语法：

  # 设置变量
  set(MY_PROJECT_VERSION "1.0.0")
  # 查询并使用变量
  message("Project version: ${MY_PROJECT_VERSION}")
  

• 属性需要用专门的对象属性命令：

  # 设置目标属性
  set_target_properties(my_executable PROPERTIES CXX_STANDARD 17)
  # 查询目标属性
  get_target_property(EXE_STANDARD my_executable CXX_STANDARD)
  message("Executable C++ standard: ${EXE_STANDARD}")
  
  # 设置目录属性
  set_property(DIRECTORY PROPERTY INCLUDE_DIRECTORIES "${PROJECT_SOURCE_DIR}/include")
  

总结：什么时候用哪个？ #

• 如果你需要存储全局配置、临时数据，或者跨作用域传递简单值——用变量。
• 如果你需要给某个具体的目标、目录、源文件添加专属配置，或者需要让配置在依赖链中自动传播——用属性。

现代CMake（3.0+）更推荐用属性配合target_*系列命令（比如target_compile_features、target_link_libraries）来管理项目，因为这种方式更模块化、更精准，能避免全局变量带来的作用域混乱。

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