Windows下Clang搭配CMake构建C++项目失败求助

场景说明 #

• Windows环境下的C++文件结构：

foo.cpp // 包含int main()，引入bar.hpp
bar.cpp
bar.hpp

• Clang配置：按LLVM「使用Visual Studio」指南完成配置，已将Clang所在目录加入系统PATH，版本信息：

clang++ --version

clang version 18.0.0 (https://github.com/llvm/llvm-project.git 81d04709f86968431ecab1df12a17279d057daa9)
Target: x86_64-pc-windows-msvc
Thread model: posix
InstalledDir: C:\llvm-project\build_vs\Release\bin

• 手动编译正常：执行clang++ .\bar.cpp .\foo.cpp可成功生成a.exe

现有CMake配置 #

cmake_minimum_required(VERSION 3.28.0)
set(CMAKE_TRY_COMPILE_TARGET_TYPE "STATIC_LIBRARY")
project(CMakeProjectCpp VERSION 0.1.0 LANGUAGES CXX)

include(CTest)
enable_testing()

set(CPACK_PROJECT_NAME ${PROJECT_NAME})
set(CPACK_PROJECT_VERSION ${PROJECT_VERSION})
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
set(CMAKE_VERBOSE_MAKEFILE ON)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

set(SOURCES
    foo.cpp
    bar.cpp
    bar.hpp
)

set(CMAKE_GENERATOR "Ninja")

add_executable(CMakeProjectCpp ${SOURCES})

if(CMAKE_CXX_COMPILER_ID STREQUAL "Clang")
    target_compile_options(CMakeProjectCpp PRIVATE
        -Wall
        -Wextra
        # Add other Clang-specific flags
    )
endif()

问题现象 #

• 使用MinGW的g++（版本g++.exe (xPack MinGW-w64 GCC x86_64) 13.2.0）构建正常，日志如下：

C:\cmake-3.28.0-rc1-windows-x86_64\bin\cmake.EXE --build c:/codebase/build --config Debug --target all --
[build] [2/3  33% :: 0.314] Building CXX object CMakeFiles/CMakeProjectCpp.dir/bar.cpp.obj
[build] [2/3  66% :: 0.328] Building CXX object CMakeFiles/CMakeProjectCpp.dir/foo.cpp.obj
[build] [3/3 100% :: 0.733] Linking CXX executable CMakeProjectCpp.exe
[driver] Build completed: 00:00:00.772
[build] Build finished with exit code 0

• 切换到Clang工具链后构建失败，错误日志：

[build] [3/3 100% :: 0.532] Linking CXX executable CMakeProjectCpp.exe
[build] FAILED: CMakeProjectCpp.exe 
[build] C:\Windows\system32\cmd.exe /C "cd . && C:\llvm-project\build_vs\Release\bin\clang++.exe -fuse-ld=lld-link -nostartfiles -nostdlib -O0 -D_DEBUG -D_DLL -D_MT -Xclang --dependent-lib=msvcrtd -g -Xclang -gcodeview -Xlinker /subsystem:console CMakeFiles/CMakeProjectCpp.dir/foo.cpp.obj CMakeFiles/CMakeProjectCpp.dir/bar.cpp.obj -o CMakeProjectCpp.exe -Xlinker /MANIFEST:EMBED -Xlinker /implib:CMakeProjectCpp.lib -Xlinker /pdb:CMakeProjectCpp.pdb -Xlinker /version:0.0   -lkernel32 -luser32 -lgdi32 -lwinspool -lshell32 -lole32 -loleaut32 -luuid -lcomdlg32 -ladvapi32 -loldnames  && cd ."
[build] clang++: error: unable to execute command: program not executable
[build] clang++: error: linker command failed with exit code 1 (use -v to see invocation)

解决方案 #

错误核心是CMake给Clang自动添加了-nostartfiles和-nostdlib参数，这两个参数会强制链接器跳过标准启动文件与标准库，而手动编译时并没有这些参数，因此可以正常生成可执行文件。同时需要明确Clang使用MSVC兼容的标准库逻辑，避免工具链混淆。

修改后的CMakeLists.txt如下：

cmake_minimum_required(VERSION 3.28.0)
set(CMAKE_TRY_COMPILE_TARGET_TYPE "STATIC_LIBRARY")
project(CMakeProjectCpp VERSION 0.1.0 LANGUAGES CXX)

include(CTest)
enable_testing()

set(CPACK_PROJECT_NAME ${PROJECT_NAME})
set(CPACK_PROJECT_VERSION ${PROJECT_VERSION})
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
set(CMAKE_VERBOSE_MAKEFILE ON)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

set(SOURCES
    foo.cpp
    bar.cpp
    bar.hpp
)

set(CMAKE_GENERATOR "Ninja")

add_executable(CMakeProjectCpp ${SOURCES})

if(CMAKE_CXX_COMPILER_ID STREQUAL "Clang")
    # 确保Clang生成MSVC兼容的代码，适配系统标准库
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fms-compatibility-version=19.30")
    # 指定使用lld-link作为链接器（若不在PATH需写绝对路径）
    set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -fuse-ld=lld-link")
    # 移除导致跳过标准库的错误参数
    string(REPLACE "-nostartfiles" "" CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS}")
    string(REPLACE "-nostdlib" "" CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS}")

    target_compile_options(CMakeProjectCpp PRIVATE
        -Wall
        -Wextra
        # 其他Clang专属编译参数
    )
endif()

额外建议：配置CMake时直接指定工具链，避免自动检测混淆：

cmake -G Ninja -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_C_COMPILER=clang ..

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