如何让CMake在target_link_libraries未指定PRIVATE/PUBLIC等关键字时报错？

针对大型项目里强制要求target_link_libraries必须带PRIVATE/PUBLIC/INTERFACE关键字的需求，有几种通用的落地方式：

1. 用CMake内置策略直接报错 #

CMake 3.15及以上版本已经内置了专门的策略来处理这个问题：

cmake_policy(SET CMP0028 NEW)

这个策略的NEW行为会把不带关键字的target_link_libraries调用直接判定为错误，中断CMake配置流程。如果想全局生效，也可以在执行CMake时通过命令行参数设置：

cmake -DCMAKE_POLICY_DEFAULT_CMP0028=NEW ..

这种方式最省心，完全依赖CMake原生机制，不需要额外写脚本。

2. 重载target_link_libraries做自定义检查 #

如果项目还需要兼容3.15以下的CMake版本，可以自己封装一层target_link_libraries函数，强制检查关键字：

function(target_link_libraries target)
  set(has_keyword FALSE)
  # 遍历所有参数，检查是否包含指定关键字
  foreach(arg ${ARGN})
    if(arg STREQUAL "PRIVATE" OR arg STREQUAL "PUBLIC" OR arg STREQUAL "INTERFACE")
      set(has_keyword TRUE)
      break()
    endif()
  endforeach()

  if(NOT has_keyword)
    message(FATAL_ERROR "错误：target_link_libraries调用必须指定PRIVATE/PUBLIC/INTERFACE关键字，目标：${target}")
  endif()

  # 调用CMake原生的target_link_libraries
  _target_link_libraries(${target} ${ARGN})
endfunction()

把这段代码放在项目根CMakeLists.txt最开头，所有后续的target_link_libraries调用都会经过检查，一旦违规就直接报错终止配置。

3. CI流程里加静态检查 #

在持续集成（CI）环节，可以用静态检查工具或者自定义脚本扫描所有CMakeLists.txt文件，找出不符合规范的调用。比如用Python写个简单脚本，遍历所有CMake文件，匹配target_link_libraries的调用模式，检查是否包含关键字。

这种方式适合作为代码提交的前置检查，在代码合并前就拦截违规写法，避免问题流入后续环节。

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