Mac M1环境下如何用CMake链接libconfig++？编译报错求助

原配置的核心问题 #

你的CMake代码混合了多种库获取方式（find_library/FetchContent/find_package），逻辑冗余且未正确关联libconfig++的头文件路径与官方导出的链接目标，导致编译时找不到libconfig.h++。

方案一：使用Homebrew安装本地库（推荐） #

1. 先通过Homebrew安装libconfig（包含C++版本）：

brew install libconfig

Mac M1上Homebrew默认路径为/opt/homebrew，CMake会自动识别该路径下的库配置。

2. 修改CMake配置：

# 查找libconfig++的官方配置文件
find_package(libconfig++ CONFIG REQUIRED)

# 为目标链接库，使用官方导出的目标自动处理头文件与链接逻辑
target_link_libraries(MyProject PRIVATE
    common_lib
    sfml-graphics
    sfml-audio
    sfml-window
    sfml-system
    fftw
    libconfig++::libconfig++
)

方案二：使用FetchContent从源码构建 #

如果依赖源码构建而非系统库，调整CMake代码如下：

include(FetchContent)

FetchContent_Declare(libconfig
    GIT_REPOSITORY https://github.com/hyperrealm/libconfig.git
    GIT_TAG v1.7.3  # 指定稳定版本
)

# 强制启用C++库构建（默认仅构建C库）
set(BUILD_CXX ON CACHE BOOL "Build C++ bindings" FORCE)
# 禁用示例与测试以加快构建
set(BUILD_EXAMPLES OFF CACHE BOOL "Build examples" FORCE)
set(BUILD_TESTS OFF CACHE BOOL "Build tests" FORCE)

FetchContent_MakeAvailable(libconfig)

# 链接官方目标，自动处理头文件路径与库链接
target_link_libraries(MyProject PRIVATE
    common_lib
    sfml-graphics
    sfml-audio
    sfml-window
    sfml-system
    fftw
    libconfig++::libconfig++
)

关键说明 #

使用libconfig++::libconfig++这个官方导出的目标后，CMake会自动处理：

• 头文件包含路径（无需手动调用include_directories或find_path）
• 库文件链接路径与依赖项
• 适配Mac M1架构的编译选项

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