windows上安装gcc实为选择mingw-w64发行版，推荐msys2或便携版winlibs；需正确配置path、指定c++标准（如-std=c++20）、匹配gdb与编译器版本及abi，否则将出现命令未找到、头文件缺失、链接错误或调试失效等问题。
Windows 上直接装 GCC 就是装 MinGW-w64
Windows 本身没有 GCC，所谓“安装 GCC”实际是选一个 MinGW-w64 发行版。主流就两个：msys2（推荐）和 winlibs（便携免安装）。别碰老掉牙的 MinGW（非 -w64），它不支持 64 位默认、没 std::filesystem、连 std::format 都编译不过。
常见错误现象：g++: command not found 或 cannot find -lstdc++——基本是 PATH 没配对，或者混用了不同发行版的 bin 目录。
-
msys2装完必须运行mingw64.exe（不是msys2.exe），它才加载正确的环境变量 - 如果只想要命令行可用，用
winlibs更省事：解压后把mingw64\bin加进系统 PATH 即可 - 别把多个 MinGW 的
bin同时加进 PATH，g++ --version输出版本混乱就是信号
验证 GCC 是否真能编译 C++17/20 代码
很多教程说“装完就能用”，但默认 g++ 不开 C++ 标准，std::optional 一写就报错，不是环境问题，是编译参数漏了。
使用场景：写现代 C++ 项目，尤其用到 std::span、std::ranges、模块（Modules）等特性时，必须显式指定标准。
立即学习“C++免费学习笔记（深入）”；
- 基础编译命令必须带
-std=c++17或-std=c++20，例如：g++ -std=c++20 main.cpp -o main - 用
g++ --version看到的是 GCC 版本，不是默认 C++ 标准；GCC 11+ 默认仍是c++14 - 某些 IDE（如 VS Code + C/C++ 扩展）会忽略你配置的
c_cpp_properties.json中的"cppStandard"，最终还得靠编译命令里的-std=
PATH 配错导致头文件找不到或链接失败
典型错误信息：fatal error: bits/c++config.h: No such file or directory 或 undefined reference to `WinMain'。这不是缺库，是 g++ 找错了头文件路径或链接目标。
根本原因：Windows 下 MinGW-w64 有多个 ABI 变种（ucrt / msvcrt）、多个架构（x86_64 / i686），路径一错，include 和 lib 就全乱套。
- 确认你用的是
ucrt版本（推荐），它的 include 路径里有ucrt字样；msvcrt版本在 Win11 上可能缺 API - 检查
g++ -v -E main.cpp输出里的#include <...> search starts here:</...>段，看列出的路径是否对应你安装的 MinGW-w64 目录 -
undefined reference to `WinMain'多半是你写了int main()却被当成了 Windows GUI 程序链接——加-mconsole强制控制台子系统
VS Code 或 CLion 里调试不进断点？检查 GDB 是否匹配
MinGW-w64 自带的 gdb.exe 必须和 g++.exe 来自同一发行版、同一 ABI、同一位宽，否则调试器根本读不懂符号表，断点灰掉、变量显示 <optimized out></optimized> 是常态。
性能影响：错配 GDB 不仅断点失效，单步执行可能卡死，甚至崩溃退出。
- 用
gdb --version和g++ --version对比版本号，二者主版本必须一致（如都是 13.2.0） - 运行
file gdb.exe和file g++.exe（在 msys2 终端或 Git Bash 里），确认都是PE32+ executable (console) x86-64 - CLion 用户注意：
Settings > Build > Toolchain里 “Debugger” 必须指向 MinGW-w64 自带的gdb.exe，不能用系统 PATH 里别的 GDB
最常被忽略的一点：MinGW-w64 的调试信息默认用 DWARF 格式，但 Windows 原生调试器（如 VS 自带的）完全不认——你得用配套的 GDB，且不能关 -g 编译选项。
