PAYATHON 2026

Windows 终端调用 MSYS2 MinGW32 make 编译失败

技术问小赵

结论

从 Windows 终端直接运行 make 时,shell 并不在 MSYS2 的 MinGW32 环境里。此时 make 和 gcc 的平台检测、头文件搜索路径都与 MinGW32 终端不同,Makefile 会走 Unix 分支并编译 src/backends/unix/main.c,所以 realpath、getuid、fcntl、F_SETFL 等 POSIX 接口会报未声明。应在 MSYS2 MinGW32 环境中执行 make,或在 Code::Blocks 中让构建命令通过该环境运行,同时保证 MSYSTEM=MINGW32,并让 PATH 里的 /mingw32/bin 优先。

为什么会这样

MSYS2 同时提供 MSYS、MINGW32、MINGW64、UCRT64 等环境。Windows 的 cmd/PowerShell 不会自动设置 MSYSTEM,也不会自动把 MinGW32 的 gcc、头文件和库放到正确位置。在 Windows 终端里直接运行 make 时,可能调用到 MSYS 的 make,又配上错误的 gcc 或 PATH,结果 Makefile 的平台判断与 MinGW32 终端不一致。日志中出现对 src/backends/unix/main.c 的编译,说明平台选择已经不对;implicit declaration 表明当前编译环境没有看到这些 POSIX 声明或宏,源码本身没有突然损坏。

推荐做法

1. 先在 MSYS2 MinGW32 终端里验证

打开 C:\msys64\mingw32.exe,或从命令行启动:

C:\msys64\msys2_shell.cmd -mingw32

进入项目目录并检查环境:

cd /d/q2dev/yquake2-master
echo $MSYSTEM
which make
which gcc
gcc --version
make

echo $MSYSTEM 应输出 MINGW32,which gcc 应指向 /mingw32/bin/gcc.exe 或等价路径。make 可以来自 /usr/bin/make,但 PATH 和 MSYSTEM 必须正确。这里能成功,就说明项目和 Makefile 在正确环境下没有问题。

2. 如果必须从 Windows 终端调用,先包一层 MSYS2 shell

不要在 D:\q2dev\yquake2-master> 下直接跑 make,改用 MinGW32 shell:

C:\msys64\msys2_shell.cmd -mingw32 -defterm -here -no-start -c "cd /d/q2dev/yquake2-master && make"

MSYS2 里的 /d/q2dev/... 对应 Windows 的 D:\q2dev\...。这样 MSYSTEM 和 PATH 会按 MinGW32 环境设置,不会混用。

3. Code::Blocks 中配置工具链和 Make 命令

在 Code::Blocks 里可以这样配置:

  • Settings -> Compiler -> Toolchain executables,编译器目录指向 C:\msys64\mingw32(按实际安装路径调整)。
  • C compiler 用 gcc.exe,C++ compiler 用 g++.exe。
  • Make program 可用 C:\msys64\usr\bin\make.exe 或当前环境中实际存在的 mingw32-make.exe,不要指向旧版 MinGW 的 make。
  • 给 Code::Blocks 的构建环境设置 MSYSTEM=MINGW32,并让 PATH 以 C:\msys64\mingw32\bin;C:\msys64\usr\bin 开头。
  • 更稳妥的做法是加一个包装脚本,让 Code::Blocks 调用它,避免 IDE 继承 Windows 全局 PATH 里的其他编译器。

示例包装脚本 build_mingw32.cmd:

@echo off
set MSYSTEM=MINGW32
set PATH=C:\msys64\mingw32\bin;C:\msys64\usr\bin;%PATH%
cd /d D:\q2dev\yquake2-master
C:\msys64\usr\bin\make.exe %*

然后在 Code::Blocks 的 Make 命令里调用这个脚本,并把目标参数传进去。

注意事项

  • 先在 cmd 里执行 where gcc、where make,确认没有先命中旧版 MinGW、Strawberry Perl 或其他工具链自带的程序。混用多个安装是这类问题最常见的原因。
  • \usr\bin\make 本身不一定有问题。关键是它由哪个 shell、哪套 PATH、哪个 CC 调用。MSYS2 的 make 在 MinGW32 shell 里工作正常,符合预期。
  • 如果仍然看到 src/backends/unix/main.c 被编译,先检查平台选择。给 Unix 后端硬补 Windows 声明只会掩盖环境配置问题。
  • 对 yquake2 这类项目,优先使用官方支持的 MSYS2 MinGW32 构建流程;没有确认 Makefile 逻辑前,不要随意改平台判断。
  • 若确实要从 cmd 直接运行,至少先设置 MSYSTEM=MINGW32 和正确的 PATH;仍建议用 msys2_shell.cmd -mingw32 包一层,避免环境不完整。

备注:内容仅供参考。