CMake变量和函数怎么用？-C++-PHP中文网

cmake变量作用域严格分函数、目录和缓存三层，函数内set默认创建局部变量，作用域限于函数内部；修改父作用域需显式加parent_scope，参数处理应优先用argc/argv而非硬写形参，避免未定义行为。

cmake变量和函数怎么用？

直接说结论：CMake变量不是“定义完就能全局用”，函数不是“写完就能直接传参取返回值”——它们各自有严格的作用域规则和调用机制，不按规则来，message() 打印为空、set() 修改无效、参数在函数里“消失”都是常态。

CMake 函数内 set() 默认创建的是局部变量，作用域仅限于该函数内部。这是最常踩的坑：以为改了变量，结果调用完就丢了。

函数内想修改父作用域变量，必须加 PARENT_SCOPE： set(MY_VAR "new_value" PARENT_SCOPE)
不加 PARENT_SCOPE 的 set(MY_VAR "xxx") 在函数结束后自动销毁
顶层 CMakeLists.txt 中的 set() 是全局的，但子目录 add_subdirectory() 中的 set() 不会反向影响父目录

别只依赖形参（如 function(foo a b)），CMake 函数调用时实参数量可能和形参不一致，硬写形参会触发未定义行为。

CMake 4.3.2

CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。

下载

优先用 ARGC 和 ARGV：先检查 ${ARGC} 是否足够，再取 ${ARGV0}、${ARGV1} 等
形参只适合参数个数固定且明确的场景；可选参数、变长参数必须靠 ARGV + ARGN
ARGN 存的是“超出形参声明数量”的剩余参数，比如 function(log msg level) 调用 log "err" "warn" "extra" "info"，则 ARGN = "extra;info"

字符串拼接和列表追加是两套逻辑，混用会导致路径错乱或编译失败。

拼接字符串：set(SRC_LIST "${SRC_LIST} main.cpp") → 结果是 "file1.cpp main.cpp"（带空格，CMake 会当两个参数）
追加列表元素：list(APPEND SRC_LIST "main.cpp") 或 set(SRC_LIST ${SRC_LIST} "main.cpp") → 正确生成分号分隔的列表 "file1.cpp;main.cpp"
误用空格拼接后传给 add_executable()，CMake 会把带空格的整个字符串当做一个文件名，报 file not found

像 CMAKE_SOURCE_DIR、PROJECT_BINARY_DIR 这类内置变量是只读的，强行 set() 不生效，但不会报错——你改了它，后续逻辑却还在用原始值，调试时极难定位。

可安全覆盖的：自定义变量（SRC_LIST、ENABLE_LOG）、部分输出路径变量（EXECUTABLE_OUTPUT_PATH）
绝对不要碰的：所有以 CMAKE_、PROJECT_ 开头的内置变量（除非文档明确说可设）
不确定？先 message(STATUS "CMAKE_SOURCE_DIR=${CMAKE_SOURCE_DIR}") 看一眼原始值，再决定是否绕开它用自定义变量

真正麻烦的从来不是语法记不住，而是变量在哪个作用域、参数在哪个数组里、分号和空格哪天悄悄改变了语义——这些细节不盯住，cmake .. 表面成功，链接时找不到符号才是最耗时间的。