PAYATHON 2026

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 只改生成器,不改编译器,所以两个生成器都可能报同一个错误。

解决步骤

  1. 先确认当前 gcc 来自哪里:
gcc --version
where gcc

如果输出指向 C:/MinGW/bin/gcc.exe,建议换成 MinGW-w64。

  1. 安装 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
  1. 调整 PATH,让新工具链排在 C:/MinGW/bin 前面。MSYS2 UCRT64 下一般是:
C:/msys64/ucrt64/bin

MINGW64 则是:

C:/msys64/mingw64/bin

可以用 where gcc、where cmake 确认实际调用的是哪个。

  1. 删除旧构建目录,重新配置。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。

  1. 验证:
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 的一个合理原因。

备注:内容仅供参考。