CMake多项目组织方案咨询：同目录下可执行文件与内部库构建链接是否合理？

你的这个方案整体思路是合理的，CMake完全支持这种“根目录统筹+子目录独立构建”的结构，但有几个关键细节需要调整，否则会遇到构建错误，下面逐一说明：

• 第一个核心问题：子目录添加顺序错误
  你当前根目录的CMakeLists.txt里先添加了shelltool1、shelltool2，最后才添加lib1。但target_link_libraries要求依赖的目标（这里是lib1）必须已经被CMake创建才能生效。如果先处理工具的子目录，再处理lib1，执行target_link_libraries(shelltool1 lib1)时，CMake还不知道lib1这个目标，会直接抛出错误。
  修正方法：把add_subdirectory(lib1)放在最前面，确保库目标先被定义，再处理依赖它的可执行文件：

  add_subdirectory(lib1)
  add_subdirectory(shelltool1)
  add_subdirectory(shelltool2)
  
  target_link_libraries(shelltool1 lib1)
  target_link_libraries(shelltool2 lib1)
  

• 第二个需要补全的细节：源码变量${SRC}的定义
  你在shelltool1、shelltool2和lib1的CMakeLists.txt里直接用了${SRC}，但没有提前定义这个变量。每个子目录都需要明确列出自己的源码文件，比如在shelltool1的CMakeLists.txt里：

  set(SRC main.cpp tool_utils.cpp) # 根据实际源码文件调整
  add_executable(shelltool1 ${SRC})
  

  或者更直接地把源码写在add_executable里：

  add_executable(shelltool1 main.cpp tool_utils.cpp)
  

• 优化建议：自动传递头文件依赖
  如果shelltool1需要包含lib1的头文件，只靠链接还不够。建议在lib1的CMakeLists.txt里用target_include_directories把头文件目录设为PUBLIC，这样所有链接lib1的目标会自动继承这些include路径，不用每个工具都手动添加include_directories：

  add_library(lib1 ${SRC})
  # 假设lib1的头文件在当前目录的include子文件夹里
  target_include_directories(lib1 PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)
  

• 可选优化：在子目录内直接完成链接
  其实你也可以在每个工具的子目录里直接链接lib1，这样根目录的CMakeLists.txt只需要负责添加子目录，结构更清晰。比如在shelltool1的CMakeLists.txt里：

  add_executable(shelltool1 ${SRC})
  target_link_libraries(shelltool1 lib1)
  

  这种方式下，只要根目录先添加lib1的子目录，工具的子目录就能找到lib1目标，根目录的CMakeLists.txt就简化成：

  add_subdirectory(lib1)
  add_subdirectory(shelltool1)
  add_subdirectory(shelltool2)
  

调整子目录顺序并补全源码变量后，你的方案就能正常工作。如果结合target_include_directories和子目录内链接的写法，会让整个CMake结构更健壮、易维护。

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