cmake -E cmake_symlink_library等命令的作用是什么？定义在何处？

问题背景 #

调研SOCI数据库连接库构建流程时，在生成的build.make文件中发现两类未在公开文档记载的cmake -E子命令调用：

• 符号链接操作相关片段：

... build.make:        cd /build/build_scripts/libs/soci_build/src/core && $(CMAKE_COMMAND) -E cmake_symlink_library ../../lib/libsoci_core.so.4.0.0 ../../lib/libsoci_core.so.4.0 ../../lib/libsoci_core.so

• 彩色输出相关片段：

$(CMAKE_COMMAND) -E cmake_echo_color ....

全局grep检索项目代码、CMake模块文件均未找到上述命令的定义或重定义内容，需要明确cmake_symlink_library的具体作用，以及这类cmake -E子命令的实际定义位置。

具体解答 #

cmake_symlink_library 命令作用 #

这是CMake内置的跨平台共享库软链接专用命令，专门适配类Unix系统下共享库的版本链接规范，接收的三个参数按顺序对应：

• 第一参数：带完整版本号的共享库实体二进制文件，示例中为../../lib/libsoci_core.so.4.0.0
• 第二参数：带主次版本号的软链接文件，示例中为../../lib/libsoci_core.so.4.0，执行命令后该软链接会指向第一参数的实体文件
• 第三参数：无版本后缀的编译期链接软链接，示例中为../../lib/libsoci_core.so，执行命令后该软链接会指向第二参数的版本软链接，编译器链接阶段默认查找的就是这个无版本后缀的文件
  该命令会自动处理跨平台差异：Windows平台下不会创建软链接，还会自动适配不同系统的库命名规则，不需要构建脚本额外写平台判断逻辑做兼容。
  另一个cmake_echo_color是CMake内置的跨平台彩色文本输出命令，用于构建过程中输出带颜色的提示信息，支持指定文字颜色、是否换行等参数，避免依赖不同系统echo命令的差异化颜色控制语法。

这类内部子命令的定义位置 #

所有以cmake_开头的-E子命令都属于CMake的内部专用命令，不对外公开，因此不会出现在官方公开的cmake -E命令帮助文档中。
这类命令不是通过CMake脚本层定义的，逻辑直接编译在cmake二进制程序内部，具体实现在CMake源码的命令行入口实现文件cmcmd.cxx的命令分发逻辑中，因此在项目目录、本地CMake模块里grep不可能找到相关定义。

这类内部命令没有稳定的行为、参数承诺，不同CMake版本可能调整参数规则、修改逻辑甚至直接删除对应命令，不要在自己手写的构建脚本里调用这类cmake_前缀的内部-E子命令，日常使用仅调用官方文档列出的公开-E命令即可。

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