CMake 报错 Cannot determine link language 排查

CMake 工程在 configure 阶段报 Cannot determine link language for target "xxx"，多数情况不是编译器的问题，而是目标没有拿到任何源文件。本文从一个真实写法错误出发，说明报错含义、网上常见的绕过写法为什么不彻底、正确的源文件收集方式，以及顺带发现的一个 include_directories 路径坑。

现象与出错的写法

执行 cmake 时报错：

CMake Error: Cannot determine link language for target "ErrorManager"

报错的字面意思是 CMake 无法确定链接该目标时该用哪种语言。出问题的 CMakeLists.txt：

cmake_minimum_required(VERSION 3.2)

project(ErrorMgr)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -pthread -fPIC -fpermissive")

include_directories(${CMAKE_SOURCE_DIR}/include)

add_executable(ErrorManager src/)      # 问题在这里

target_link_libraries(ErrorManager yaml-cpp)

add_executable(ErrorManager src/) 把目录当作源文件传了进去。CMake 的 add_executable() 接受的是源文件列表，目录不会被展开，于是目标实际没有任何源文件——没有源文件就无法推断链接语言，configure 阶段直接报错。

绕过写法：LINKER_LANGUAGE

参考 Stack Overflow 上的同名问题，常见的处理是显式声明链接语言：

set_target_properties(ErrorManager PROPERTIES LINKER_LANGUAGE CXX)

加上后 cmake 确实不再报错。但 make 阶段换了个报错：链接器找不到 main() 函数。

这是意料之中的结果：LINKER_LANGUAGE 只是替 CMake 补上了「用 C++ 链接」这个声明，绕过了语言推断；目标依然没有源文件，缺 main() 的根因没有解决。这类「先把报错压下去」的写法适合源文件确实存在、只是语言推断失效的场景，不适合掩盖源文件缺失。

正确写法：先收集源文件，再传给 add_executable

aux_source_directory(src/ SRC_LIST)
add_executable(ErrorManager ${SRC_LIST})

# add_executable(ErrorManager ${PROJECT_SOURCE_DIR}/src)  # 错误：目录不能当源文件
# add_executable(ErrorManager src/)                       # 错误：同上

aux_source_directory() 把目录下的源文件收集进变量，再整体传入。但这个命令在官方文档中不推荐用来收集源文件：目录里新增文件时 CMakeLists.txt 本身没有变化，构建系统不会自动重新运行 cmake，必须手动重来；而且它只收集当前目录一层，不递归子目录。它的设计用途是配合模板实例化目录。

日常工程更稳妥的做法是在 add_executable() / target_sources() 里显式列出源文件；希望少维护清单时可以用 file(GLOB CONFIGURE_DEPENDS ...)，但要了解其局限性（构建时重新检查 glob 有成本，且对删除文件的处理不完全可靠）。

顺带的坑：include_directories 少了前导斜杠

同一份 CMakeLists.txt 里还有一处隐蔽问题：

include_directories(usr/include)     # 想写的是系统路径 /usr/include

少了前导 /，usr/include 会被解释为相对当前源码目录的路径，几乎必然指向不存在的位置；而 /usr/include 本就在编译器默认搜索路径中，这行整体是多余的。头文件找不到的问题有时就藏在这样的路径拼写里。

要点

• Cannot determine link language 的常见根因是目标没有任何源文件：目录被当源文件传入、路径拼错、glob 没匹配到文件。
• set_target_properties(... LINKER_LANGUAGE CXX) 只是补上语言声明，不解决缺源文件的问题，慎用来压报错。
• add_executable() 不接受目录，要么显式列出源文件，要么先用 aux_source_directory() / file(GLOB) 收集成变量再传入。
• include_directories() 的路径要区分绝对与相对：系统路径写 /usr/include，相对路径以当前源码目录为基准。