SDL3 CMake 在 Windows 下构建失败:intrin.h 缺失
数据小陈
结论
这个错误多半是 Windows 下的 MinGW 工具链太旧或不匹配造成的,CMakeLists.txt 本身通常没问题。SDL3 的 SDL_assert.h 在 MinGW 路径下会包含 <intrin.h>,而 C:/MinGW/bin/gcc.exe 这类 MinGW.org 旧环境可能没有这个头文件,也可能缺少 SDL3 需要的编译器内建支持。改用 MinGW-w64(推荐 MSYS2 的 UCRT64/MINGW64),清掉构建缓存后重新生成即可。
原因
intrin.h是编译器或平台相关的头文件,不属于 C 标准库。- SDL3 在实现断言和断点时会根据编译器选择
__debugbreak或类似的 intrinsic,MinGW 分支可能因此引入<intrin.h>。 C:/MinGW通常是旧 MinGW.org 的安装路径;SDL3 当前版本一般按 MinGW-w64 环境构建。旧环境缺少头文件或 ABI 不匹配时,编译 vendored/SDL 的 C 源文件就会失败。- 换成 Ninja 或 MinGW Makefiles 只改生成器,不改编译器,所以两个生成器都可能报同一个错误。
解决步骤
- 先确认当前 gcc 来自哪里:
gcc --version
where gcc
如果输出指向 C:/MinGW/bin/gcc.exe,建议换成 MinGW-w64。
- 安装 MinGW-w64。推荐用 MSYS2,装好后打开对应终端(UCRT64 或 MINGW64):
pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-cmake mingw-w64-ucrt-x86_64-ninja
MINGW64 则用:
pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja
- 调整 PATH,让新工具链排在
C:/MinGW/bin前面。MSYS2 UCRT64 下一般是:
C:/msys64/ucrt64/bin
MINGW64 则是:
C:/msys64/mingw64/bin
可以用 where gcc、where cmake 确认实际调用的是哪个。
- 删除旧构建目录,重新配置。Ninja 是单配置生成器,换编译器后必须清缓存:
rm -rf build
cmake -S . -B build -G Ninja -DCMAKE_EXPORT_COMPILE_COMMANDS=1 -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++
cmake --build build
如果 CMake 还缓存着旧编译器,可以把 -DCMAKE_C_COMPILER 和 -DCMAKE_CXX_COMPILER 指向新编译器的完整路径,或者直接删掉 build。
- 验证:
gcc -print-file-name=include
进入该目录或 GCC include 路径,确认里面能搜到 intrin.h。也可以直接重新构建,错误应该会消失。
备选方案
不想用 MinGW 的话,可以用 MSVC + Ninja。请在 Developer Command Prompt for VS 或 x64 Native Tools Command Prompt 中执行:
cmake -S . -B build -G Ninja -DCMAKE_EXPORT_COMPILE_COMMANDS=1 -DCMAKE_C_COMPILER=cl -DCMAKE_CXX_COMPILER=cl
cmake --build build
这种方式同样能生成 compile_commands.json,但需要 Visual Studio 的 C++ 工具链和 Windows SDK。
注意事项
- 不要只改生成器;
intrin.h缺失属于编译器环境问题。 - 切换工具链后一定删除
build/,否则 CMake 可能继续使用旧的编译器缓存。 - 如果项目要跨 Linux/Windows,建议在 Windows 上固定用 MinGW-w64 或 MSVC 其中一套,并避免在 PATH 中同时混用多个 MinGW。
CMAKE_EXPORT_COMPILE_COMMANDS=1只在 Makefile/Ninja 等生成器下生成compile_commands.json,Visual Studio 生成器不支持;这也是这里用 Ninja 的一个合理原因。
备注:内容仅供参考。
