使用CMake构建依赖<experimental/filesystem>的C++14项目时遇未定义符号问题

问题原因 #

这个错误是链接器找不到std::experimental::filesystem相关符号导致的。C++14中<experimental/filesystem>属于实验性组件，不会自动链接到标准库，必须手动指定链接对应的文件系统库才能解决符号未定义问题。

正确的CMake配置方案 #

1. 先明确启用C++14标准 #

在CMakeLists.txt中先指定编译标准，避免编译器默认标准不兼容：

set(CMAKE_CXX_STANDARD 14)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF) # 禁用GNU++14这类编译器扩展标准

2. 根据编译器添加对应链接库 #

不同编译器需要链接的文件系统库不同，用CMake的条件判断自动适配：

# GCC或Clang编译器
if(CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
    # GCC用stdc++fs，部分Clang版本也兼容；若Clang版本较新，可替换为c++fs
    target_link_libraries(你的可执行目标名 PRIVATE stdc++fs)
endif()

# MSVC（Visual Studio）编译器
if(MSVC)
    # 禁用experimental组件的 deprecation 警告
    target_compile_definitions(你的可执行目标名 PRIVATE _SILENCE_EXPERIMENTAL_FILESYSTEM_DEPRECATION_WARNING)
    # VS2017及以后版本无需额外链接库，编译器会自动处理
endif()

完整CMakeLists.txt示例 #

cmake_minimum_required(VERSION 3.10)
project(你的项目名)

# 设置C++14标准
set(CMAKE_CXX_STANDARD 14)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

# 创建可执行目标
add_executable(你的可执行目标名 main.cpp 其他源文件.cpp)

# 链接文件系统库
if(CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
    target_link_libraries(你的可执行目标名 PRIVATE stdc++fs)
endif()

if(MSVC)
    target_compile_definitions(你的可执行目标名 PRIVATE _SILENCE_EXPERIMENTAL_FILESYSTEM_DEPRECATION_WARNING)
endif()

额外注意点 #

• GCC版本低于5.3、Clang版本低于3.9的话，可能不支持<experimental/filesystem>，建议升级编译器。
• 运行二进制文件时，确保编译器的标准库动态路径能被系统识别，避免出现动态库找不到的问题。

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