如何通过CMake查找用户自定义CMake函数的定义位置？

CMake自带的追踪方案 #

CMake的--trace参数可以完整输出构建过程中执行的所有CMake指令，包括自定义函数的定义和调用逻辑：

• 执行构建命令时添加--trace，并过滤函数定义的关键字：

  cmake --trace -S <源码目录> -B <构建目录> 2>&1 | grep -n "function(你的自定义函数名"
  

  输出结果会明确显示函数定义所在的文件路径和行号。如果该自定义逻辑是用macro定义的，把function替换成macro即可。
• 若想减少冗余输出，只关注目标函数相关的操作，可以结合grep的上下文参数，比如显示匹配行前后5行：

  cmake --trace -S <源码目录> -B <构建目录> 2>&1 | grep -A5 -B5 "function(你的自定义函数名"
  

外部文本搜索工具 #

如果需要更直接的定位，或者CMake版本过低（--trace在CMake 2.8.5及以上支持），直接用文本搜索工具遍历源码树是高效方案：

• 使用系统自带的grep：

  grep -r "function(你的自定义函数名" <源码根目录> --include="CMakeLists.txt" --include="*.cmake"
  

  加上--include参数可以只搜索CMake相关文件，避免无关结果。
• 用更快的ripgrep工具（需单独安装）：

  rg "function(你的自定义函数名" <源码根目录> -g "CMakeLists.txt" -g "*.cmake"
  

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