4. Windows UDP 编程基础：从 Winsock 到实战
聊到 Windows 下的 UDP 编程，绕不开的就是 Winsock。说白了，它就是 Windows 平台上的套接字规范。我刚开始从 Linux 转到 Windows 做网络编程时，第一反应是“这玩意儿怎么这么啰嗦？”——多了一堆初始化、清理的步骤。但后来我理解了，Windows 的生态就是这样，它要兼容各种版本的协议栈，所以必须有一套显式的启动和关闭机制。
这一章，我们就来啃下 Winsock 编程的基石。你掌握了这些，后面的 UDP 收发才算真正有了落脚点。
4.1 为什么需要 Winsock？
很多人会问：UDP 不就是 sendto 和 recvfrom 吗？在 Windows 上直接调不行吗？
嗯，还真不行。Windows 的套接字实现是以 DLL 形式提供的——ws2_32.dll。你的程序在调用任何 socket 函数之前，必须先告诉系统：“嘿，我要用网络功能了，请把协议栈加载好。” 这个过程就是 Winsock 初始化。
我见过不少新手，代码写好了，一运行就崩，报错码是 10093。什么意思？就是 WSAStartup 没调，或者调了但失败了。所以，别嫌麻烦，这是 Windows 的规矩。
核心要点： Windows 下所有 socket 操作，都必须先经过 WSAStartup 注册，结束后必须 WSACleanup 注销。这不是可选项，是强制项。
4.2 WSADATA 结构：你拿到了什么？
WSAStartup 的第一个参数是你请求的版本号，第二个参数是一个输出参数——WSADATA 结构体。这个结构体里装的是系统实际支持的 Winsock 实现信息。
我个人习惯，每次初始化后都会打印一下 WSADATA 的内容，尤其是在跨平台移植或者对接不同 Windows 版本时。它就像一张“能力清单”，告诉你当前环境能干什么、不能干什么。
| 字段 | 含义 | 我常用的检查点 |
|---|---|---|
wVersion |
你实际获得的版本号（主版本+次版本） | 确认是否 >= 2.2 |
wHighVersion |
系统支持的最高版本号 | 如果高于请求版本，说明有升级空间 |
szDescription |
协议栈描述字符串 | 调试时看一眼，确认加载的是哪个厂商的栈 |
szSystemStatus |
系统状态字符串 | 一般用不上，但出错时它可能给出线索 |
iMaxSockets |
最大并发套接字数（已废弃，仅供参考） | 别信这个值，现代 Windows 基本不限制 |
iMaxUdpDg |
UDP 数据报最大长度 | 通常是 65507 字节，但实际受 MTU 限制 |
我的小技巧： 在初始化后，用 LOBYTE(wsaData.wVersion) 和 HIBYTE(wsaData.wVersion) 分别取出主版本和次版本。比如请求 2.2，实际拿到 2.2 才算成功。如果拿到 1.1，很多高级功能（比如重叠 I/O）就用不了。
4.3 WSAStartup 与 WSACleanup：成对出现
这两个函数必须成对出现，就像 malloc 和 free 一样。我见过有人只调了 WSAStartup，程序退出时忘了 WSACleanup。短期内看不出问题，但如果你写的是一个长期运行的服务，或者频繁加载卸载 DLL，资源泄漏就会累积。
4.3.1 WSAStartup 的正确姿势
#include <winsock2.h>
#pragma comment(lib, "ws2_32.lib")
WSADATA wsaData;
int iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
if (iResult != 0) {
printf("WSAStartup failed: %d\n", iResult);
return 1;
}
// 检查版本
if (LOBYTE(wsaData.wVersion) != 2 || HIBYTE(wsaData.wVersion) != 2) {
printf("Could not find Winsock 2.2\n");
WSACleanup();
return 1;
}
这里有个坑：MAKEWORD(2, 2) 表示请求 2.2 版本。但系统可能只支持 2.0 或 1.1。所以一定要检查返回的 wVersion。我曾经在一个 Windows Server 2003 的老机器上部署程序，请求 2.2 返回成功，但 wVersion 却是 2.0——有些功能表现就不一样。
4.3.2 WSACleanup 的调用时机
我的原则是：程序退出前，或者不再需要任何 socket 操作时，立即调用。如果你写的是 DLL，在 DLL_PROCESS_DETACH 里调用。如果是 EXE，在 main 函数 return 之前。
// 程序结束前
WSACleanup();
注意： WSACleanup 会关闭所有未关闭的套接字。但我不建议依赖这个行为——你应该在调用它之前，显式地 closesocket 每一个 socket 描述符。否则，如果某个 socket 正在阻塞操作中，WSACleanup 的行为是未定义的。
4.4 Windows 特有 API 对比：它和 Linux 有什么不同？
如果你是从 Linux 转过来的，你会发现 Windows 的 API 名字长得像，但细节上全是坑。我整理了一个对比表，你写代码时对照着看，能省不少调试时间。
| 功能 | Linux API | Windows API | 关键差异 |
|---|---|---|---|
| 创建套接字 | socket() |
socket() |
Windows 需要先 WSAStartup；返回值是 SOCKET 类型，不是 int |
| 关闭套接字 | close() |
closesocket() |
千万别用 close()，那是文件描述符的；closesocket() 才是正道 |
| 错误码获取 | errno |
WSAGetLastError() |
Windows 的错误码和 Linux 不一样，比如 WSAEWOULDBLOCK 对应 Linux 的 EAGAIN |
| 设置非阻塞 | fcntl() + O_NONBLOCK |
ioctlsocket() + FIONBIO |
Windows 没有 fcntl，必须用 ioctlsocket |
| 发送数据 | sendto() |
sendto() |
函数名一样，但参数类型有差异：Windows 的 len 是 int，Linux 是 size_t |
| 接收数据 | recvfrom() |
recvfrom() |
同上，len 参数类型不同；fromlen 在 Windows 是 int*，Linux 是 socklen_t* |
避坑指南： 我曾经在跨平台代码里直接用 #ifdef _WIN32 包裹了 closesocket 和 WSAGetLastError，但忘了处理 ioctlsocket。结果在 Windows 上编译通过，运行时设置非阻塞失败，程序卡死在 recvfrom 上。排查了半天才发现是 fcntl 在 Windows 上根本不存在。
4.5 一张图看懂 Winsock 初始化流程
下面这张 SVG 图，把整个初始化和清理的流程串起来了。你写代码前，先对着这张图走一遍逻辑，基本不会漏步骤。
4.6 实战中的几个习惯
最后，分享几个我自己的编码习惯，算不上什么高深技巧，但能帮你少踩坑：
- 初始化代码单独封装：我习惯写一个
InitWinsock()函数，返回 bool，内部完成WSAStartup和版本检查。这样主程序逻辑干净，也方便单元测试。 - 错误码转字符串：
WSAGetLastError()返回的是数字，调试时很难看。我通常会写一个GetWinsockErrorString()，把常见错误码映射成可读的文字。比如 10054 就是“连接被重置”，10060 是“连接超时”。 - 不要忽略返回值：
WSAStartup返回 0 才表示成功。非零值直接退出，别尝试继续。我见过有人忽略返回值，结果后面socket()返回INVALID_SOCKET，排查了半天才发现是初始化没通过。 - 多线程环境注意引用计数：
WSAStartup和WSACleanup在进程内部是有引用计数的。你调一次WSAStartup，计数 +1；调一次WSACleanup，计数 -1。计数归零时才真正卸载。所以，如果你在多线程里各自调了WSAStartup，记得每个线程都要对应调WSACleanup，否则最后一个线程退出时可能出问题。
一句话总结： Windows UDP 编程的第一步，就是把 WSAStartup 和 WSACleanup 焊死在你的代码里。这一步稳了，后面的 sendto 和 recvfrom 才能跑得顺畅。