cmake中function与macro本质差异在于作用域、参数解析和return行为：函数有独立作用域、参数为真实变量、return可提前退出；宏是文本替换、argv需${}展开、return行为不可控。
要搞清楚CMake中function和macro的本质差异，不能只看语法相似性——它们在变量作用域、参数解析机制、return行为上完全不同，直接决定你封装逻辑时会不会意外污染父作用域或参数失效。
作用域：函数隔离变量，宏直接替换
函数会创建独立作用域，内部set()修改的变量默认不会影响外部；宏则是在调用位置做纯文本替换，所有变量操作都发生在调用者的上下文中。
写一个测试对比：
先设初始值：set(result "original")、set(modified "original")；
再定义宏：macro(test_macro v) set(result ${v}) set(modified "changed") endmacro()；
定义函数：function(test_func v) set(result ${v}) set(modified "changed") endfunction()；
调用宏后，message("result: ${result}")输出 【from macro】，modified也变成 【changed】；
调用函数后，result和modified仍为 【original】 —— 因为函数内赋值只在自身作用域生效。
这一步不加PARENT_SCOPE就改不了外层变量，是函数安全性的核心保障。
参数处理：ARGV/ARGN不是变量，是字符串替换
宏和函数都支持ARGV0、ARGN等内置变量，但它们本质不同：
在宏里，ARGV1不是真正的CMake变量，而是预处理器式文本替换；所以if(ARGV1)会报错，必须写成if(${ARGV1})或if(DEFINED ARGV1)。
函数中ARGV1是真实变量，可直接用于if()、foreach(IN LISTS)等命令；
宏中ARGN不能直接放进foreach(loop IN LISTS ARGN)，会提示“list variable not set”，得先set(list_var "${ARGN}")再遍历。
【宏里所有ARGV/ARGN相关判断必须加${}包裹或用DEFINED检测】
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
return行为：函数可提前退出，宏慎用return
函数中return()会立即跳出函数体，回到调用点继续执行；
宏中return()不终止宏本身，而是返回到宏被展开的位置——可能跳到CMakeLists.txt中间某行，引发不可预测行为；
实际项目中，宏体内出现return()往往导致后续命令被跳过，且无明确报错提示。
若需条件退出，函数更可靠；宏建议用if()...endif()包裹逻辑块，避免return。
重载与覆盖：后定义的同名function/macro会直接覆盖前者
无论先定义函数再定义同名宏，还是反过来，后出现的那个会完全覆盖前一个；
CMake不支持重载，只认最后注册的实现；
若想保留原命令，可用_original_name方式手动备份，例如function(_add_executable)包装原add_executable。
适用场景选择
方法一：优先用function封装复杂逻辑
涉及多层嵌套、变量修改、条件分支、需要return提前退出的场景，一律用function——作用域隔离+参数安全+语义清晰。
方法二：macro仅用于简单代码注入
比如批量添加源文件、生成固定格式target_link_libraries语句、重复调用相同命令序列，且不依赖内部变量状态时，macro更轻量。
方法三：混合使用——函数内调用macro
把macro当作“模板片段”塞进function里，既能享受函数作用域保护，又能复用macro的文本替换能力；例如function解析参数后，用macro生成多个target_compile_definitions。
