必须选posix线程模型，因安装阶段即决定是否包含pthread.h和libwinpthread；win32版本无pthread支持，编译会报“fatal error: pthread.h: no such file or directory”。
MinGW-w64安装时必须选 posix 线程模型
不是“装完再改”，而是安装阶段就决定有没有 pthread.h 和 libwinpthread。MinGW-w64 提供两个线程模型选项：posix 和 win32，只有选 posix 才会自带 pthread 支持。
常见错误是下载了 win32 版本（比如某些官网默认链接、旧教程推荐的版本），结果编译时直接报 fatal error: pthread.h: No such file or directory —— 头文件压根不存在，更别提链接了。
- 从 mingw-w64.org 或 MSYS2 官网下载时，务必确认 installer 名称含
posix（如x86_64-13.2.0-release-posix-seh-rt_v12-rev0.7z） - 用 MSYS2 安装更可靠：运行
pacman -S mingw-w64-x86_64-gcc，它默认带posix线程模型和winpthreads - 已装错？别折腾 patch，直接删掉整个 MinGW 目录，重装
posix版本——混用 win32/posix 运行时会导致符号冲突或undefined reference to `pthread_create`
编译命令里加 -pthread 不是可选，是必须
-pthread 不只是加个链接参数，它会同时：
- 在预处理阶段定义
_REENTRANT和_GNU_SOURCE（影响头文件行为） - 自动添加
-I路径指向pthread.h所在目录 - 在链接阶段插入
-lwinpthread（注意：不是-lpthread）
所以不要写成 gcc main.c -o a.exe -lpthread —— 这在 MinGW-w64 下会失败，因为实际库名是 libwinpthread.a，且依赖顺序和宏定义都缺位。
正确写法只有一条：gcc -pthread main.c -o a.exe。位置无关（放源文件前或后都行），但不能省略。
链接时报 undefined reference to `pthread_create` 的真实原因
这个错误表面是链接失败，但根源几乎总是以下之一：
- 用了
win32版 MinGW-w64（没winpthreads，-pthread变成空操作） - 手动写了
-lpthread覆盖了-pthread的自动行为（MinGW 下没有libpthread.a，只有libwinpthread.a） - 项目里混用了 C++ 的
std::thread和 C 的pthread，但没统一工具链（例如用 MSVC 编译器配 MinGW 的 pthread 库）
验证是否真有 pthread 支持：检查安装目录下是否存在 lib/libwinpthread.a 和 include/pthread.h。不存在？说明安装的不是 posix 版本。
运行时报 libwinpthread-1.dll 找不到
这是动态链接的副作用——程序依赖 libwinpthread-1.dll，但系统 PATH 里没有它所在路径（通常是 mingw64/bin）。
不想配 PATH 或分发 DLL？静态链接最干净：
- 编译时加
-static-libwinpthread：把 pthread 运行时打进去，生成单文件 EXE - 顺手加
-static-libgcc -static-libstdc++，彻底消灭所有依赖 DLL - 注意：
-static-libwinpthread必须和-pthread同时出现，否则 GCC 不会识别该开关
命令示例：gcc -pthread -static-libwinpthread -static-libgcc -static-libstdc++ main.c -o a.exe。生成的 a.exe 可直接双击运行，无需任何 DLL。
真正麻烦的不是找不到 pthread，而是误以为问题出在“怎么装库”，其实关键动作只有两个：装对版本（posix）、用对参数（-pthread）。其余都是这一步错位后的连锁反应。
