如何使用CMake在编译时禁用库依赖（规避预处理器地狱）

针对多可选模块的场景，不用堆砌全局预处理器宏，结合CMake的现代特性和C++17的编译时能力，可以实现更简洁的架构：

1. 目标隔离+编译时常量替代全局宏 #

核心思路是把每个可选模块封装成独立CMake目标，通过option控制启用状态，同时用C++17 constexpr常量替代预处理器宏，避免代码里满是嵌套#ifdef。

CMake配置 #

# 定义可选模块开关
option(ENABLE_LOGGING "启用日志模块" ON)
option(ENABLE_NETWORKING "启用网络模块" OFF)

# 生成结构化配置头（用constexpr替代#define）
configure_file(
  ${CMAKE_CURRENT_SOURCE_DIR}/config.h.in
  ${CMAKE_CURRENT_BINARY_DIR}/include/my_lib/config.h
  @ONLY
)

# 核心库目标
add_library(my_core STATIC core.cpp)
target_compile_features(my_core PRIVATE cxx_std_17)
# 引入生成的配置头
target_include_directories(my_core PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/include)

# 日志模块：仅当开关开启时构建并链接
if(ENABLE_LOGGING)
  add_library(my_logging STATIC logging.cpp)
  target_compile_features(my_logging PRIVATE cxx_std_17)
  target_link_libraries(my_logging PRIVATE spdlog) # 依赖的第三方日志库
  target_link_libraries(my_core PRIVATE my_logging)
endif()

# 网络模块：同理
if(ENABLE_NETWORKING)
  add_library(my_networking STATIC networking.cpp)
  target_link_libraries(my_networking PRIVATE asio)
  target_link_libraries(my_core PRIVATE my_networking)
endif()

配置头模板（config.h.in） #

#pragma once

namespace my_lib_config {
  inline constexpr bool enable_logging = @ENABLE_LOGGING@;
  inline constexpr bool enable_networking = @ENABLE_NETWORKING@;
}

C++代码中的使用 #

#include "my_lib/config.h"
#include "logging.h"

void core_function() {
  // 用编译时常量替代#ifdef，编译器会自动优化不可达分支
  if (my_lib_config::enable_logging) {
    log_info("核心函数执行中");
  }
  
  // 业务逻辑代码
}

这种方式下，代码没有嵌套预处理器指令，可读性大幅提升，且CMake的目标隔离能避免依赖混乱。

2. 组件化管理多可选模块 #

如果可选模块数量较多，可以用CMake列表变量实现组件化，让用户按需选择要启用的模块：

CMake配置 #

# 默认只构建核心组件
set(MY_LIB_COMPONENTS "core" CACHE STRING "要构建的组件列表，用逗号分隔")

# 核心组件
add_library(my_core STATIC core.cpp)
target_compile_features(my_core PRIVATE cxx_std_17)

# 处理日志组件
if("logging" IN_LIST MY_LIB_COMPONENTS)
  add_library(my_logging STATIC logging.cpp)
  target_link_libraries(my_logging PRIVATE spdlog)
  target_link_libraries(my_core PRIVATE my_logging)
  target_compile_definitions(my_core PRIVATE ENABLE_LOGGING)
endif()

# 处理网络组件
if("networking" IN_LIST MY_LIB_COMPONENTS)
  add_library(my_networking STATIC networking.cpp)
  target_link_libraries(my_networking PRIVATE asio)
  target_link_libraries(my_core PRIVATE my_networking)
endif()

用户可以通过命令行指定要启用的组件：

cmake -DMY_LIB_COMPONENTS="logging,networking" ..

关键技巧总结 #

• 避免全局target_compile_definitions，把编译定义限制在具体目标内
• 用C++17 constexpr常量替代预处理器宏，减少代码中的#ifdef嵌套
• 每个可选模块做成独立CMake目标，通过条件判断控制构建与链接
• 复杂场景用组件化方式，让用户更灵活地选择模块

内容的提问来源于stack exchange，提问作者B-S-E