LINK_WHAT_YOU_USE

3.7 版本中新增。

这是一个布尔选项，当设置为 TRUE 时，会添加一个链接时检查，以打印出正在链接但未为目标提供任何符号的共享库列表。这旨在作为一种代码规范检查。

由 CMAKE_<LANG>_LINK_WHAT_YOU_USE_FLAG 指定的标志将传递给链接器，以便命令行中指定的所有库都将链接到目标中。然后，由 CMAKE_LINK_WHAT_YOU_USE_CHECK 指定的命令将在链接目标后运行，以检查二进制文件中是否包含不必要链接的共享库。

注意

目前，它仅支持 ELF 平台，并且仅适用于可执行文件和共享库或模块库目标。对于任何其他目标和配置，此属性将被忽略。

当目标创建时，此属性会根据 CMAKE_LINK_WHAT_YOU_USE 变量的值进行初始化（如果该变量已设置）。