使用g++编译C++ Asio网络代码时出现未定义引用错误的原因？

尝试在C中使用Asio库进行网络开发，但编译链接阶段失败。开发环境为Visual Studio Code + MinGW/g，系统默认include路径为C:\msys64\mingw64\include，编译时额外指定了Asio的include路径。

主文件代码 #

#include <iostream>
#include <asio.hpp>
#include <asio/ts/buffer.hpp>
#include <asio/ts/internet.hpp>

int main()
{
    return 0;
}

编译命令及错误输出 #

C:\Users\2022\Desktop\TUTORIALS\C++\SocketsTutorial>g++ main.cpp -o main.exe -I C:\Users\2022\Downloads\asio-1.24.0\asio-1.24.0\include
C:/msys64/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/11.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: C:\Users\2022\AppData\Local\Temp\cc33Br48.o:main.cpp:(.text$_ZN4asio6detail17winsock_init_base7startupERNS1_4dataEhh[_ZN4asio6detail17winsock_init_base7startupERNS1_4dataEhh]+0x74): undefined reference to `__imp_WSAStartup'
C:/msys64/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/11.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: C:\Users\2022\AppData\Local\Temp\cc33Br48.o:main.cpp:(.text$_ZN4asio6detail17winsock_init_base7cleanupERNS1_4dataE[_ZN4asio6detail17winsock_init_base7cleanupERNS1_4dataE]+0x35): undefined reference to `__imp_WSACleanup'
collect2.exe: error: ld returned 1 exit status

这是典型的链接阶段缺少系统套接字库的问题，WSAStartup和WSACleanup是Windows系统套接字API（Winsock）的核心函数，Asio在Windows平台下依赖这些函数，但编译时未链接对应的库文件。

解决方法：在编译命令中添加链接Winsock库的参数，MinGW/g++环境下需要链接ws2_32库，修改后的编译命令如下：

g++ main.cpp -o main.exe -I C:\Users\2022\Downloads\asio-1.24.0\asio-1.24.0\include -lws2_32

补充说明：

• Asio是仅头文件（header-only）库，不需要链接Asio自身的静态/动态库，但它依赖系统底层网络库，Windows平台下为Winsock2，因此必须显式链接ws2_32。
• 后续使用UDP/TCP等更多网络功能时，无需额外添加其他Asio相关库，保持链接ws2_32即可。

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