CMake报错：无法为未构建目标指定链接库，如何解决？

问题描述 #

执行cmake -B build -S source时触发错误，核心报错信息：

CMake Error at CMakeLists.txt:7 (target_link_libraries):
Cannot specify link libraries for target "venus" which is not built by this
project.

完整构建日志：

$ cmake -B build -S source 
-- The C compiler identification is AppleClang 14.0.0.14000029
-- The CXX compiler identification is AppleClang 14.0.0.14000029
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: /Library/Developer/CommandLineTools/usr/bin/cc - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: /Library/Developer/CommandLineTools/usr/bin/c++ - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
CMake Error at CMakeLists.txt:7 (target_link_libraries):
  Cannot specify link libraries for target "venus" which is not built by this
  project.


-- Configuring incomplete, errors occurred!
See also "/Users/user/Projects/Venus/build/CMakeFiles/CMakeOutput.log".
See also "/Users/user/Projects/Venus/build/CMakeFiles/CMakeError.log".

项目结构 #

.
├── build
└── source
    ├── CMakeLists.txt
    └── main.cpp

原source/CMakeLists.txt内容 #

cmake_minimum_required(VERSION 3.24.2)

project(venus)

# GLFW
find_package(glfw3 3.3 REQUIRED)
target_link_libraries(venus glfw)

# OPENGL
find_package(OpenGL REQUIRED)
target_link_libraries(venus OpenGL::GL)

add_executable(venus main.cpp)

source/main.cpp内容 #

#include <iostream>
#include <GLFW/glfw3.h>

int main() {
  std::cout << "Starting Up Venus..." << std::endl;
  return 0;
}

错误原因 #

CMake的target_link_libraries命令要求操作的目标必须已经存在。原配置中，target_link_libraries(venus ...)写在了add_executable(venus main.cpp)之前，此时CMake尚未创建venus这个可执行目标，因此触发错误。

修复方案 #

调整命令顺序，先创建目标，再添加链接库：

修改后的source/CMakeLists.txt（基础版） #

cmake_minimum_required(VERSION 3.24.2)

project(venus)

# 先查找依赖库
find_package(glfw3 3.3 REQUIRED)
find_package(OpenGL REQUIRED)

# 创建可执行目标
add_executable(venus main.cpp)

# 为目标添加链接库
target_link_libraries(venus glfw)
target_link_libraries(venus OpenGL::GL)

优化版（合并链接命令+添加作用域关键字） #

cmake_minimum_required(VERSION 3.24.2)

project(venus)

find_package(glfw3 3.3 REQUIRED)
find_package(OpenGL REQUIRED)

add_executable(venus main.cpp)

# 使用PRIVATE明确依赖作用域，避免不必要的依赖传递
target_link_libraries(venus PRIVATE glfw OpenGL::GL)

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