如何在CMake中全局引入Zstd，使项目及测试文件均可调用

以下是调整后的CMakeLists.txt，解决Zstd全局访问问题并优化整体配置：

set(CMAKE_C_STANDARD 23)
# 建议通过cmake命令行参数(-DCMAKE_C_COMPILER=gcc)指定编译器，而非硬编码
set(CMAKE_C_COMPILER gcc)

project(main
    VERSION 1.0.0
    LANGUAGES C)

set(CMAKE_EXPORT_COMPILE_COMMANDS 1)

# 引入cwalk库
add_subdirectory(vendor/cwalk)

# 引入Zstd库，指定子编译目录避免污染主build目录
add_subdirectory(vendor/zstd/build/cmake zstd_build)

# 定义datastructs库 - 替换GLOB为显式文件列表，避免CMake漏检新增文件
add_library(datastructs
    vendor/datastructs/xxx.c
    vendor/datastructs/yyy.c
)
target_include_directories(datastructs
    PUBLIC ${PROJECT_SOURCE_DIR}/vendor/datastructs
)
# 无需用target_sources添加头文件，PUBLIC include目录已让依赖方可见头文件

# 定义项目核心LIB库
add_library(LIB
    lib/aaa.c
    lib/bbb.c
)
target_include_directories(LIB
    PUBLIC ${PROJECT_SOURCE_DIR}/lib
)
# 将Zstd、cwalk、datastructs链接到LIB，所有依赖LIB的目标会自动继承这些依赖
target_link_libraries(LIB
    PUBLIC libzstd_static cwalk datastructs
)

# 主可执行文件
add_executable(main main.c)
target_link_libraries(main PRIVATE LIB)

# 测试程序配置
if(WIN32)
    add_executable(test2 test/test2.c)
    target_link_libraries(test2 PRIVATE LIB)

    add_executable(test3 test/test3.c)
    target_link_libraries(test3 PRIVATE LIB)

    add_executable(test4 vendor/datastructs/tests.c)
    target_link_libraries(test4 PRIVATE LIB)
elseif(UNIX)
    add_executable(test1 test/test1.c)
    target_link_libraries(test1 PRIVATE LIB)
endif()

关键修改说明 #

• Zstd全局访问实现：

  1. 移除了原main单独添加的Zstd include目录，因为libzstd_static目标本身已经通过PUBLIC属性暴露了自身的头文件目录，只要链接该目标就能自动获取include路径。
  2. 将libzstd_static通过target_link_libraries(LIB PUBLIC ...)链接到核心LIB库，这样所有依赖LIB的目标（包括测试程序）都会自动继承Zstd的头文件路径和链接依赖，实现全局可访问。

• CMake配置优化：

  • 替换file(GLOB)为显式文件列表：GLOB不会自动检测新增文件，显式列出文件能确保CMake始终识别所有源码文件，避免构建遗漏。
  • 移除冗余的target_sources(INTERFACE ...)：头文件只需通过target_include_directories(PUBLIC)暴露，依赖方会自动在该目录下查找头文件。
  • 测试程序统一链接核心LIB库：所有测试程序通过target_link_libraries关联LIB，自动获得Zstd、cwalk、datastructs的依赖，无需单独配置每个测试的include和链接。
  • Zstd子目录添加编译目录zstd_build：避免Zstd的构建文件直接混入主项目build目录，保持结构整洁。

额外提示 #

• 如果你的Zstd版本使用的是动态库，将libzstd_static替换为libzstd_shared即可。
• 编译器建议通过cmake命令行参数指定（如cmake .. -DCMAKE_C_COMPILER=gcc），而非硬编码在CMakeLists.txt中，提升配置灵活性。

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