Quarkus配合GraalVM构建原生镜像提示找不到stdio.h如何解决

错误根因 #

fatal error C1083: Cannot open include file: 'stdio.h'错误和版本不匹配无关，是执行构建命令的终端未加载完整MSVC编译环境变量导致的：cl.exe可执行文件路径已被识别，但缺少Windows SDK头文件、库文件的路径配置。

解决步骤 #

步骤1：确认Visual Studio安装组件完整 #

除了MSVC基础组件，必须同时安装对应版本的Windows 10/11 SDK：

• 打开Visual Studio Installer，在「工作负载」标签页勾选「使用C++的桌面开发」，该负载会默认包含MSVC、对应版本Windows SDK、编译调试工具等全套依赖，确认安装所有缺失组件后再执行后续操作。

步骤2：使用Visual Studio专用终端执行构建 #

Windows下不能直接用普通cmd或PowerShell执行native构建，必须使用配套的64位原生工具终端：

• 在开始菜单找到「x64 Native Tools Command Prompt for VS 2019」（和你安装的VS版本对应），右键选择「以管理员身份运行」
• 不要使用x86版本终端，也不要在普通终端手动添加cl.exe路径，专用终端会自动配置好所有头文件、库文件、工具链的环境变量

步骤3：验证环境后执行构建 #

在打开的x64原生工具终端中，先执行cl命令验证环境，正常会输出cl.exe的版本信息，无报错提示。
之后切换到你的Quarkus项目根目录，执行构建命令：

mvn clean package -Pnative

注意事项 #

• 不要用WSL终端编译Windows原生镜像，WSL环境编译出来的是Linux平台可执行文件
• 如果之前手动配置过自定义INCLUDE、LIB环境变量，建议先临时清空避免冲突
• 你当前使用的GraalVM 21.2.0与VS2019的组合兼容，无需更换版本

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