在MSYS2 UCRT64环境下静态链接curl库编译二进制程序的问题排查

看起来你在MSYS2的UCRT64环境里静态编译curl示例程序时遇到了一堆未定义引用的链接错误，我来帮你拆解下问题和解决办法，这类问题在GCC环境里其实挺常见的。

最可能的核心问题：编译命令里的文件顺序不对 #

GCC的链接器是按命令行顺序处理输入的：它会先处理前面的文件，后面的库只为前面的文件提供符号支持。你当前的命令是把库参数放在源文件main.c前面，这就导致链接器扫描curl库的时候，还没看到main.c里用到的curl函数，所以不会把这些符号纳入最终的可执行文件里。

调整后的正确编译命令

把main.c移到库参数的前面，改成这样：

gcc -static-libgcc --static main.c `pkg-config.exe --cflags --static libcurl` `pkg-config.exe --libs --static libcurl` -o curl-static-test

额外的排查和验证步骤 #

如果调整顺序后还是有问题，可以试试下面的步骤确认环境：

1. 确认UCRT64的静态curl库已正确安装
   打开UCRT64终端，先确保装了对应的开发包：

   pacman -S mingw-w64-ucrt-x86_64-libcurl mingw-w64-ucrt-x86_64-gcc
   

   然后检查/ucrt64/lib目录下是否存在libcurl.a文件（静态库文件），如果没有说明安装有问题，重新安装上面的包即可。

2. 确保pkg-config指向UCRT64的库目录
   MSYS2不同环境的pkg-config配置是分开的，你可以先检查环境变量：

   echo $PKG_CONFIG_PATH
   

   正常应该包含/ucrt64/lib/pkgconfig，如果没有，手动设置：

   export PKG_CONFIG_PATH=/ucrt64/lib/pkgconfig:$PKG_CONFIG_PATH
   

   之后再重新运行pkg-config命令，确认输出的是UCRT64下的库参数。

3. 确认CURL_STATICLIB宏已正确定义
   从你的pkg-config输出看，已经拿到了-DCURL_STATICLIB参数，这个是静态链接curl必须的（否则会默认链接动态库的符号），这一步你已经做对了，但可以在编译时手动加上确保生效：

   gcc -static-libgcc --static -DCURL_STATICLIB main.c `pkg-config.exe --libs --static libcurl` -o curl-static-test
   

手动指定库路径的备选方案 #

如果pkg-config还是有问题，也可以跳过它，直接手动指定头文件和库路径：

gcc -static-libgcc --static -DCURL_STATICLIB -I/ucrt64/include main.c -L/ucrt64/lib -lcurl -lnghttp2 -lssh2 -lpsl -lbcrypt -ladvapi32 -lcrypt32 -lssl -lcrypto -lgdi32 -lwldap32 -lzstd -lbrotlidec -lz -lws2_32 -lidn2 -liconv -lunistring -o curl-static-test

按照上面的步骤调整后，应该就能成功编译出静态链接的curl可执行文件了。

备注：内容来源于stack exchange，提问作者almint