简介：这是一份基于C++与Winsock API实现的简易聊天系统源码包，面向C/C++初学者及网络编程入门学习者，聚焦Windows平台下的TCP套接字通信原理与客户端-服务器架构实践。资源共56个文件，涵盖3个核心CPP源文件（chatClient.cpp/chatServer.cpp等）、2个头文件（.h）、5个CMake构建脚本、4个可执行文件（.exe）及配套调试符号（.pdb）、日志（.log）和说明文档（README.md），完整呈现从代码编写、CMake跨平台构建到本地调试运行的全流程。压缩包仅1.23MB，轻量易解压，所有源码均经实机测试可直接编译运行。目前已有44人下载学习，适合课程设计、大作业或工程实训项目，提供清晰的模块划分与可扩展结构，读者可快速理解网络通信逻辑，并基于现有框架添加多线程、消息加密或图形界面等进阶功能。
1. 一个 Win32 控制台聊天系统：不依赖 Qt/MFC，纯 C++ + Winsock 实现双端互通，适合网络编程入门者手撕 TCP 连接逻辑
你刚学完《计算机网络》的 TCP 三次握手，课本上画着 SYN、SYN-ACK、ACK 的箭头，但敲socket(AF_INET, SOCK_STREAM, 0)时还是发懵？想跑通一个真正能发消息、收消息、断连重试的最小可行聊天系统，却卡在WSAStartup返回失败、connect()阻塞超时、或者服务端accept()后客户端消息全丢——别折腾 GUI 框架了。这个项目就是为这种时刻准备的：它只有两个.cpp文件（server.cpp和client.cpp），零第三方依赖，用原生 Winsock API 实现完整的 TCP 客户端/服务端双向通信，支持多客户端连接（服务端用select()轮询）、消息粘包处理（按\n分帧）、异常断连检测（recv()返回 0 或 -1 时主动清理）。它不是玩具 demo，而是某高校网络编程实训课的 baseline 工程——学生交作业前必须在这个基础上加功能。如果你的目标是「看懂 socket 生命周期、亲手填满sockaddr_in结构体、理解阻塞/非阻塞切换代价、搞清closesocket和WSACleanup的调用顺序」，那这个 ZIP 就是你该解压的第一个包。
2. 环境准备与编译运行：Visual Studio 2019+ 即可开箱即用，无需额外安装 SDK
2.1 开发环境确认：检查 Windows SDK 版本与 Winsock 头文件路径
这个项目基于 Windows 原生 API，必须使用 Visual Studio（VS）系列 IDE 编译，MinGW 或 Clang for Windows 会因winsock2.h符号冲突直接报错。我实测过 VS 2017/2019/2022 全部兼容，关键不是 VS 版本，而是 Windows SDK 版本。打开 VS 的项目属性 →常规 → Windows SDK 版本，确认选的是10.0或更高（如10.0.22621.0）。如果显示<继承自父级或项目默认值>，点开下拉菜单手动选一个10.x开头的版本。为什么？因为老版 SDK（如 8.1）里winsock2.h缺少SOCKET_ERROR宏定义，而项目代码里大量使用该宏判断send()/recv()失败。若编译时报错error C2065: 'SOCKET_ERROR' : undeclared identifier，八成是 SDK 版本太低。
提示：VS 安装时若没勾选「Windows 10/11 SDK」，需重新运行 VS Installer → 修改 → 勾选对应 SDK 组件并安装。不要试图手动复制
winsock2.h到项目目录——头文件依赖整套 SDK 符号表，硬拷贝会导致链接时WSAStartup@8未解析。
2.2 项目结构与文件清单：两个源码 + 一个批处理，无隐藏配置
解压 ZIP 后你会看到三个文件：
server.cpp // 服务端主逻辑：创建监听 socket、accept 新连接、select 轮询收发 client.cpp // 客户端主逻辑：连接服务端、发送用户输入、接收并打印服务端消息 run.bat // 一键编译并启动服务端（调试用）注意：没有.sln或.vcxproj文件。这是故意为之——项目用最简方式组织，避免新手被 VS 项目配置绕晕。所有编译参数都写死在run.bat里，你只需双击它，或在 VS 的「开发者命令提示符」中执行cl /EHsc server.cpp ws2_32.lib即可生成server.exe。
2.3 编译命令详解：cl编译器参数含义逐个拆解
run.bat的核心命令是：
cl /EHsc /Fe:server.exe server.cpp ws2_32.lib/EHsc：启用 C++ 异常处理（/EHa是结构化异常，这里不需要），sc表示只捕获throw抛出的 C++ 异常，对 Winsock 错误码无效，但防止std::string构造失败崩溃；/Fe:server.exe：指定输出可执行文件名为server.exe（Fe= File executable）；server.cpp：源文件名；ws2_32.lib：最关键！这是 Winsock 2 的导入库，必须显式链接。若漏掉，链接阶段会报LNK2019: unresolved external symbol _WSAStartup@8。client.cpp同理，编译时也必须加ws2_32.lib。
注意：
cl命令必须在 VS 自带的「x64 本机工具命令提示符」中运行（开始菜单搜索即可）。普通 CMD 里cl不在 PATH 中，会提示'cl' is not recognized。
2.4 运行流程：先启服务端，再开多个客户端，验证连接状态
- 双击
run.bat（它会编译并立即运行server.exe），终端显示：[Server] Listening on 127.0.0.1:8080... - 新开一个命令行窗口，进入同目录，执行：
客户端连接成功后显示：client.exe 127.0.0.1 8080[Client] Connected to 127.0.0.1:8080 Enter message (type 'quit' to exit): - 在服务端窗口，你会看到类似日志：
其中[Server] New client connected: 127.0.0.1:54321 (fd=184)fd=184是 Windows 下的 socket 句柄值（非 Unix 的文件描述符，但作用类似）。 - 在任一客户端输入文字（如
Hello Server!）并回车，另一端立刻收到并打印。输入quit可断开当前客户端。
提示：服务端支持多个客户端同时连接。你可以在不同命令行窗口启动多个
client.exe，它们都会出现在服务端日志里，且彼此消息隔离——这是select()轮询实现的多路复用效果，不是线程池。
3. 核心模块拆解：从WSAStartup到closesocket，一条 TCP 连接的完整生命周期
3.1 服务端初始化：WSAStartup必须早于任何 socket 操作
server.cpp开头的初始化代码是整个项目的基石：
#include <winsock2.h> #include <ws2tcpip.h> #pragma comment(lib, "ws2_32.lib") // 链接指令，等效于命令行加 ws2_32.lib int main() { WSADATA wsaData; int result = WSAStartup(MAKEWORD(2, 2), &wsaData); // 请求 Winsock 2.2 版本 if (result != 0) { printf("WSAStartup failed: %d\n", result); return 1; } // ... 后续 socket 创建 }MAKEWORD(2,2)生成版本号0x0202（低位字节=2，高位字节=2），表示请求 Winsock 2.2。若系统只支持 2.0，WSAStartup会返回WSASYSNOTREADY，但通常 Windows 7+ 都支持 2.2；WSADATA结构体包含实际加载的版本信息（wsaData.wVersion），项目虽未校验，但生产环境必须检查wsaData.wVersion是否等于请求值，否则可能调用到不存在的函数；WSACleanup()必须在main()结束前调用，否则资源泄漏。项目在return 0前调用，位置正确。
3.2 监听 socket 创建：socket()+bind()+listen()三步缺一不可
服务端创建监听 socket 的关键代码段：
SOCKET listenSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP); if (listenSocket == INVALID_SOCKET) { printf("socket failed: %ld\n", WSAGetLastError()); WSACleanup(); return 1; } sockaddr_in service; ZeroMemory(&service, sizeof(service)); service.sin_family = AF_INET; service.sin_addr.s_addr = inet_addr("127.0.0.1"); // 绑定到本地回环 service.sin_port = htons(8080); // 端口转网络字节序 if (bind(listenSocket, (SOCKADDR*)&service, sizeof(service)) == SOCKET_ERROR) { printf("bind failed: %ld\n", WSAGetLastError()); closesocket(listenSocket); WSACleanup(); return 1; } if (listen(listenSocket, SOMAXCONN) == SOCKET_ERROR) { // SOMAXCONN ≈ 200 printf("listen failed: %ld\n", WSAGetLastError()); closesocket(listenSocket); WSACleanup(); return 1; }AF_INET表示 IPv4 地址族；SOCK_STREAM表示面向连接的字节流（TCP）；IPPROTO_TCP明确协议，虽然传 0 也可，但显式写出更清晰；inet_addr("127.0.0.1")将点分十进制转为网络字节序整数。若要监听所有网卡，用INADDR_ANY（即0x00000000）；htons(8080)是host-to-network short，将主机字节序（小端）的 16 位端口号转为网络字节序（大端）。这是 TCP/IP 协议栈强制要求，漏掉会导致端口绑定到错误值（如 8080 变成0x1F90→0x901F= 36895）；SOMAXCONN是系统定义的最大挂起连接数，Windows 下通常是 200。它控制listen()队列长度，不是并发连接数上限。
3.3 客户端连接逻辑：connect()的阻塞行为与超时控制
客户端连接代码（client.cpp）：
SOCKET connectSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP); if (connectSocket == INVALID_SOCKET) { printf("socket failed: %ld\n", WSAGetLastError()); WSACleanup(); return 1; } sockaddr_in serverAddr; ZeroMemory(&serverAddr, sizeof(serverAddr)); serverAddr.sin_family = AF_INET; serverAddr.sin_addr.s_addr = inet_addr(argv[1]); // IP 从命令行传入 serverAddr.sin_port = htons(atoi(argv[2])); // 端口从命令行传入 // 关键：connect 默认是阻塞的，会卡住直到连接成功或失败 if (connect(connectSocket, (SOCKADDR*)&serverAddr, sizeof(serverAddr)) == SOCKET_ERROR) { printf("connect failed: %ld\n", WSAGetLastError()); closesocket(connectSocket); WSACleanup(); return 1; } printf("[Client] Connected to %s:%s\n", argv[1], argv[2]);argv[1]和argv[2]分别是 IP 和端口，所以运行时必须带参数：client.exe 127.0.0.1 8080；connect()阻塞时间取决于系统 TCP 重传策略，默认约 21 秒（3 次 SYN 重传，间隔 1s/2s/4s）。若服务端未启动，客户端会卡 21 秒才报错。项目未实现非阻塞 connect，这是刻意为之——新手先理解阻塞模型，再学ioctlsocket()切非阻塞；WSAGetLastError()返回具体错误码，如10061（WSAECONNREFUSED）表示服务端拒绝连接（端口无监听），10060（WSAETIMEDOUT）表示超时。
3.4 消息收发核心：select()轮询与\n分帧防粘包
服务端用select()同时监控监听 socket 和已连接客户端 socket，避免为每个连接开线程：
fd_set readfds; struct timeval timeout; timeout.tv_sec = 1; // select 最多等 1 秒 timeout.tv_usec = 0; while (true) { FD_ZERO(&readfds); FD_SET(listenSocket, &readfds); // 总是监控监听 socket int maxSock = listenSocket; // 将所有活动客户端 socket 加入 readfds for (int i = 0; i < clientCount; i++) { if (clientSockets[i] != INVALID_SOCKET) { FD_SET(clientSockets[i], &readfds); if (clientSockets[i] > maxSock) maxSock = clientSockets[i]; } } int activity = select(maxSock + 1, &readfds, NULL, NULL, &timeout); if (activity < 0) { printf("select error: %ld\n", WSAGetLastError()); break; } // 检查监听 socket 是否有新连接 if (FD_ISSET(listenSocket, &readfds)) { // accept 新连接... } // 检查各客户端 socket 是否有数据可读 for (int i = 0; i < clientCount; i++) { if (clientSockets[i] != INVALID_SOCKET && FD_ISSET(clientSockets[i], &readfds)) { char buffer[1024]; int bytesRecv = recv(clientSockets[i], buffer, sizeof(buffer)-1, 0); if (bytesRecv > 0) { buffer[bytesRecv] = '\0'; // 关键：按 '\n' 分割完整消息，处理粘包 handleClientMessage(clientSockets[i], buffer, bytesRecv); } else if (bytesRecv == 0) { printf("[Server] Client %d disconnected\n", i); closesocket(clientSockets[i]); clientSockets[i] = INVALID_SOCKET; } else { printf("[Server] recv error %ld from client %d\n", WSAGetLastError(), i); closesocket(clientSockets[i]); clientSockets[i] = INVALID_SOCKET; } } } }select()的第一个参数maxSock + 1是 Windows 下的兼容写法（Unix 下是最大 fd+1），maxSock是所有 socket 中的最大值；handleClientMessage()函数负责解析\n分隔的消息。例如客户端发送Hi\nHow are you?\n，recv()可能一次收到Hi\nHow are you?\n（两帧），也可能分两次收到Hi\nHow和are you?\n（粘包）。项目用简单状态机缓存未完成帧，确保每条printf输出都是完整语句；recv()返回 0 表示对方调用shutdown()或closesocket()正常关闭连接；返回SOCKET_ERROR且WSAGetLastError() == WSAECONNRESET表示对方异常断连（如进程崩溃）。
4. 避坑指南：五个血泪经验总结，解决 90% 的 Winsock 编译/运行失败
4.1 现象：编译通过，但运行时报错WSAStartup failed: 10093
原因：WSAStartup第一个参数版本号写错，如MAKEWORD(1,1)请求 Winsock 1.1，但现代 Windows 已不支持该版本，返回WSASYSNOTREADY（10093）。
解决：严格使用MAKEWORD(2,2)或MAKEWORD(2,0)。Winsock 2.0 是 Windows XP+ 的最低要求，2.2 更稳妥。
4.2 现象：服务端启动后，客户端connect()一直阻塞，21 秒后报10060
原因：服务端绑定的 IP 地址错误。代码中inet_addr("127.0.0.1")只监听本地回环，若客户端用client.exe 192.168.1.100 8080连接，必然超时。
解决：将服务端bind()的地址改为INADDR_ANY（即0x00000000），允许所有网卡接入：
service.sin_addr.s_addr = INADDR_ANY; // 替换 inet_addr("127.0.0.1")4.3 现象：客户端发送消息后，服务端recv()收到乱码或空字符串
原因：recv()缓冲区未初始化，且未在末尾补\0。recv()不保证写入\0，若前次recv()收到 5 字节Hello，缓冲区buffer[5]后的内容是随机内存，printf("%s", buffer)会一直打印到遇到\0为止。
解决：每次recv()后手动置\0：
int bytesRecv = recv(clientSocket, buffer, sizeof(buffer)-1, 0); if (bytesRecv > 0) { buffer[bytesRecv] = '\0'; // 关键！ printf("Received: %s", buffer); }4.4 现象：服务端select()后，FD_ISSET()对客户端 socket 始终返回 false，无法收到消息
原因：select()修改了fd_set结构体，每次调用前必须重新FD_ZERO()并FD_SET()所有需要监控的 socket。若只在循环外FD_SET()一次，第二次select()时readfds已被清空。
解决：确保FD_ZERO()和所有FD_SET()都在select()调用前执行，如 3.4 节代码所示。这是 Winsock 初学者最高频的翻车点。
4.5 现象：程序退出后，端口仍被占用，再次启动服务端报bind failed: 10048
原因：closesocket()后，TCP 连接进入TIME_WAIT状态（默认 4 分钟），期间端口不可重用。若服务端快速重启，bind()会失败（WSAEADDRINUSE）。
解决：在bind()前设置SO_REUSEADDR选项：
int optval = 1; setsockopt(listenSocket, SOL_SOCKET, SO_REUSEADDR, (const char*)&optval, sizeof(optval));此选项允许bind()重用处于TIME_WAIT的端口，是服务端开发的必备配置。
5. 二次开发实战：从单聊到群聊，添加用户昵称与广播功能
5.1 需求分析：为什么原版只支持「消息透传」而不记录用户身份？
原项目中，服务端用数组clientSockets[]存储 socket 句柄，但没有任何用户元数据（如昵称、登录时间）。当客户端 A 发送消息，服务端只是原样send()给其他客户端，无法区分「谁发的」。这导致两个问题：
- 用户体验差：接收方不知道消息来源；
- 功能扩展难：无法实现「私聊」、「踢人」、「在线列表」等基础功能。
改造目标很明确：为每个连接分配唯一 ID，并在首次通信时协商昵称。我们不引入数据库或配置文件，全部内存管理，保持轻量。
5.2 数据结构升级：用结构体替代裸数组，封装用户状态
在server.cpp顶部定义新结构：
#define MAX_CLIENTS 64 #define MAX_NICKNAME 32 struct ClientInfo { SOCKET sock; char nickname[MAX_NICKNAME]; time_t lastActive; // 用于心跳检测 bool isValid; // 标记是否有效连接 }; ClientInfo clients[MAX_CLIENTS]; int clientCount = 0;初始化时清空：
for (int i = 0; i < MAX_CLIENTS; i++) { clients[i].sock = INVALID_SOCKET; clients[i].nickname[0] = '\0'; clients[i].isValid = false; }accept()成功后，不再直接存入clientSockets[]，而是查找空闲槽位：
SOCKET clientSocket = accept(listenSocket, NULL, NULL); if (clientSocket != INVALID_SOCKET) { int idx = -1; for (int i = 0; i < MAX_CLIENTS; i++) { if (!clients[i].isValid) { idx = i; break; } } if (idx != -1) { clients[idx].sock = clientSocket; clients[idx].isValid = true; strcpy(clients[idx].nickname, "Anonymous"); // 默认昵称 clients[idx].lastActive = time(NULL); clientCount++; printf("[Server] New client %d connected, assigned slot %d\n", clientSocket, idx); } else { printf("[Server] Max clients reached, rejecting connection\n"); closesocket(clientSocket); } }5.3 协商昵称协议：用特殊前缀标识注册请求
客户端首次发送的消息，若以/nick开头，则视为修改昵称请求。服务端解析并更新：
void handleClientMessage(SOCKET clientSocket, char* buffer, int len) { // 查找该 socket 对应的 clients[] 索引 int idx = findClientIndex(clientSocket); if (idx == -1) return; // 去除末尾 \n 和空格 buffer[len-1] = '\0'; // 假设 recv 以 \n 结尾 char* msg = trim(buffer); // 处理 /nick 命令 if (strncmp(msg, "/nick ", 6) == 0) { const char* newNick = msg + 6; if (strlen(newNick) > 0 && strlen(newNick) < MAX_NICKNAME) { strncpy(clients[idx].nickname, newNick, MAX_NICKNAME-1); clients[idx].nickname[MAX_NICKNAME-1] = '\0'; send(clientSocket, "Nickname updated.\n", 18, 0); printf("[Server] Client %d changed nickname to '%s'\n", idx, newNick); } else { send(clientSocket, "Invalid nickname length.\n", 25, 0); } return; } // 普通消息：广播给所有其他客户端，格式为 "[昵称] 消息" char broadcastMsg[1024]; snprintf(broadcastMsg, sizeof(broadcastMsg), "[%s] %s\n", clients[idx].nickname, msg); for (int i = 0; i < MAX_CLIENTS; i++) { if (i != idx && clients[i].isValid && clients[i].sock != INVALID_SOCKET) { send(clients[i].sock, broadcastMsg, strlen(broadcastMsg), 0); } } }findClientIndex()和trim()是辅助函数，代码略。关键点：
/nick是纯文本协议，无需 JSON 或二进制，降低客户端实现难度；snprintf()确保字符串安全拼接，避免缓冲区溢出；- 广播时跳过发送者自身（
i != idx），防止回声。
5.4 客户端适配：启动时自动发送/nick，并解析带昵称的消息
修改client.cpp的输入循环：
printf("Enter nickname: "); fgets(buffer, sizeof(buffer), stdin); buffer[strcspn(buffer, "\n")] = 0; // 去掉换行符 if (strlen(buffer) > 0) { char nickCmd[64]; snprintf(nickCmd, sizeof(nickCmd), "/nick %s\n", buffer); send(connectSocket, nickCmd, strlen(nickCmd), 0); } // 主循环中，recv 后解析带 [] 的消息 char recvBuf[1024]; while (true) { int bytesRecv = recv(connectSocket, recvBuf, sizeof(recvBuf)-1, 0); if (bytesRecv > 0) { recvBuf[bytesRecv] = '\0'; printf("%s", recvBuf); // 直接打印，服务端已加好格式 } else if (bytesRecv == 0) { printf("[Server] Disconnected.\n"); break; } }现在，用户启动客户端后先输昵称，后续所有消息都带[昵称]前缀，群聊体验立竿见影。
从那以后我每次做网络 demo，都强制走一遍「连接→注册→广播」三步闭环，哪怕只是临时测试。因为真正的稳定性不在select()调用有多炫，而在每个 socket 的生命周期里，closesocket是否和WSACleanup一样被认真对待，而每个recv()后的\0是否像呼吸一样自然。希望帮到你。
本文还有配套的精品资源，点击获取
