1. TCP通信基础与Qt网络模块
TCP协议作为互联网通信的基石，其可靠性体现在三个方面：数据包确认机制确保每个数据包都能到达目的地，顺序控制保证数据按发送顺序重组，流量控制防止网络拥堵。在Qt中实现TCP通信，首先要理解两个核心类：QTcpServer负责监听连接请求，QTcpSocket处理实际数据传输。
我刚开始用Qt做网络编程时，发现很多人容易混淆这两个类的分工。简单来说，服务器端需要同时使用两者：QTcpServer像门卫，专门接待新连接；而QTcpSocket像服务员，负责具体的"上菜"工作。客户端则只需要QTcpSocket，相当于直接找服务员点单。
配置开发环境时，记得在.pro文件中添加：
QT += network这个模块包含了所有网络通信需要的类。第一次使用时我忘了加这行，编译报错找了半天原因，希望大家别犯同样的错误。
2. 服务器端开发实战
2.1 基础服务器搭建
创建TCP服务器就像开一家餐厅：先选好地址（IP）和门牌号（端口）。下面是最简实现：
// 创建监听对象 QTcpServer *server = new QTcpServer(this); if (!server->listen(QHostAddress::Any, 8888)) { qDebug() << "启动失败：" << server->errorString(); }QHostAddress::Any表示监听所有网卡，实测中我发现用QHostAddress::LocalHost只监听本地回环更安全。当客户端连接时，通过信号槽处理：
connect(server, &QTcpServer::newConnection, this, [=](){ QTcpSocket *clientSocket = server->nextPendingConnection(); QString clientInfo = QString("[%1:%2]").arg(clientSocket->peerAddress().toString()) .arg(clientSocket->peerPort()); qDebug() << "新连接：" << clientInfo; });2.2 数据接收与处理
数据到达时会触发readyRead信号，但这里有个坑要注意：TCP是流协议，数据可能被拆分成多个包。我推荐两种处理方式：
方法一：固定长度包头
// 发送方先发4字节表示数据长度 QByteArray block; QDataStream out(&block, QIODevice::WriteOnly); out << (quint32)0; // 预留长度位 out << "Hello World"; out.device()->seek(0); out << (quint32)(block.size() - sizeof(quint32)); // 接收方解析 QDataStream in(socket); if (bytesAvailable < sizeof(quint32)) return; in >> blockSize; while(socket->bytesAvailable() < blockSize) { if (!socket->waitForReadyRead(1000)) { qDebug() << "接收超时"; return; } }方法二：分隔符标识适合文本协议，比如用换行符分割消息。记得要处理缓冲区拼接：
QString buffer; connect(socket, &QTcpSocket::readyRead, [&](){ buffer += socket->readAll(); while(buffer.contains("\n")) { QString message = buffer.left(buffer.indexOf("\n")); buffer = buffer.mid(buffer.indexOf("\n")+1); processMessage(message); } });3. 客户端开发技巧
3.1 连接管理
客户端连接建议增加超时机制：
QTcpSocket *socket = new QTcpSocket(this); socket->connectToHost("127.0.0.1", 8888); if (!socket->waitForConnected(3000)) { qDebug() << "连接超时：" << socket->errorString(); socket->deleteLater(); return; }连接状态变化通过信号处理：
connect(socket, &QTcpSocket::connected, [](){ qDebug() << "连接成功"; }); connect(socket, &QTcpSocket::disconnected, [](){ qDebug() << "连接断开"; });3.2 数据发送优化
直接调用write()可能遇到数据未立即发送的情况。我习惯的三种发送策略：
- 即时发送：适合小数据包
socket->write("PING"); socket->flush(); // 强制立即发送- 批量发送：减少IO操作
QByteArray data; data.append("Header"); data.append(payload); socket->write(data);- 分块发送：大文件必备
QFile file("bigfile.dat"); file.open(QIODevice::ReadOnly); while(!file.atEnd()) { QByteArray chunk = file.read(1024*1024); // 1MB分块 socket->write(chunk); socket->waitForBytesWritten(); }4. 文件传输实战方案
4.1 协议设计
可靠的文件传输需要自定义协议头，我常用的格式：
文件头格式：fileName|fileSize|chunkSize 数据块格式：chunkIndex|chunkData具体实现示例：
// 发送文件头 QFileInfo fileInfo(filePath); QString header = QString("%1|%2|%3\n") .arg(fileInfo.fileName()) .arg(fileInfo.size()) .arg(chunkSize); socket->write(header.toUtf8()); // 接收方解析 if (isHeader) { QStringList parts = QString(buffer).split("|"); fileName = parts[0]; totalSize = parts[1].toLongLong(); chunkSize = parts[2].toInt(); isHeader = false; }4.2 断点续传实现
网络不稳定时断点续传是刚需，关键步骤：
- 记录传输进度：
qint64 receivedBytes = 0; QFile file("temp.dat"); if (file.exists()) { receivedBytes = file.size(); socket->write(QString("RESUME|%1\n").arg(receivedBytes).toUtf8()); }- 服务端定位文件指针：
if (header.startsWith("RESUME")) { qint64 pos = header.split("|")[1].toLongLong(); file.seek(pos); }- 进度显示：
connect(socket, &QTcpSocket::bytesWritten, [&](qint64 bytes){ sentBytes += bytes; progressBar->setValue(sentBytes * 100 / totalSize); });5. 性能优化与错误处理
5.1 常见问题排查
- 连接拒绝：检查防火墙设置，我曾在Windows Defender上浪费两小时
- 数据不完整：一定要检查write返回值，确认实际发送字节数
- 内存泄漏：记得对QTcpSocket设置父对象或手动delete
5.2 高级技巧
多线程处理：每个连接创建独立线程
void Server::incomingConnection(qintptr handle) { ClientThread *thread = new ClientThread(handle, this); connect(thread, &ClientThread::finished, thread, &QObject::deleteLater); thread->start(); }心跳检测：防止连接假死
// 定时发送心跳包 QTimer *timer = new QTimer(this); connect(timer, &QTimer::timeout, [=](){ if (socket->state() == QAbstractSocket::ConnectedState) { socket->write("HEARTBEAT\n"); } }); timer->start(5000);在实际项目中，我发现合理设置缓冲区大小能显著提升性能：
socket->setReadBufferSize(1024*1024); // 1MB缓冲区网络编程就像搭积木，从基础连接开始，逐步添加文件传输、断点续传等功能模块。记得多测试边界情况，比如网络中断、大文件传输等场景，这些才是真正考验代码健壮性的地方。
