2、QTcpSocket基础：QTcpSocket类的介绍、QTcpSocket的常用方法、QTcpSocket的信号与槽
好，咱们直接进入正题。QTcpSocket 这个东西，说白了就是 Qt 帮我们封装好的 TCP 客户端套接字。你想想看，如果让你直接用操作系统底层的 socket API 去写网络通信，光是处理各种错误码、阻塞与非阻塞、字节序转换这些破事，就能让你写到手抽筋。Qt 把这些脏活累活全包了，我们只需要关心业务逻辑就行。
我个人习惯把 QTcpSocket 理解成「一根虚拟的网线」。你创建它，连接服务器，然后往里面写数据，再从里面读数据。就这么简单。但简单归简单，坑也不少。我在项目中遇到过好几次因为没搞清楚它的状态机，导致程序莫名其妙断开连接的情况。嗯，咱们今天就把这些坑一个个填平。
2.1 QTcpSocket 类介绍
QTcpSocket 继承自 QAbstractSocket，而 QAbstractSocket 又继承自 QIODevice。这意味着什么？意味着它天生就具备读写能力，跟 QFile、QProcess 这些类是同一家族的。你可以用 read()、write() 这些熟悉的接口来操作它。
它的核心作用就两个：
- 作为客户端主动连接服务器（比如你的 App 去连后台）
- 收发数据（TCP 流式数据，没有边界概念）
重要概念：QTcpSocket 是异步非阻塞的。所有操作（连接、读写、断开）都不会阻塞主线程。这是 Qt 网络编程的基石，也是新手最容易翻车的地方。
你可能会问：「为什么不用同步阻塞？写起来多简单啊。」我刚开始学的时候也这么想。但后来在做一个即时通讯软件时，发现一旦网络卡顿，整个 UI 界面就冻住了，用户点哪儿都没反应。那体验，啧啧，别提多糟糕了。所以记住：Qt 网络编程，永远用异步。
2.2 QTcpSocket 的常用方法
我把常用方法分成三类：连接相关、数据读写、状态控制。咱们一个一个来看。
2.2.1 连接相关
| 方法 | 说明 | 我的经验 |
|---|---|---|
connectToHost(host, port) |
连接到指定服务器 | 这是最常用的，记得先连接信号再调用 |
disconnectFromHost() |
主动断开连接 | 调用后不会立即断开，要等信号 |
state() |
返回当前连接状态 | 调试时打印这个，能快速定位问题 |
waitForConnected() |
阻塞等待连接完成 | 慎用！会卡 UI 线程 |
这里有个细节：connectToHost() 调用后，连接并没有立即建立。它只是发起了连接请求，真正的连接成功或失败，要通过信号来获知。我曾经犯过一个错误——在调用 connectToHost() 之后立刻调用 write()，结果数据根本没发出去。因为那时候 socket 还处于 ConnectingState，根本没连上。
2.2.2 数据读写
| 方法 | 说明 | 我的经验 |
|---|---|---|
write(data) |
发送数据（返回发送的字节数） | 返回的不等于实际发送的，别被坑了 |
readAll() |
读取所有可用数据 | 最常用，但要注意粘包问题 |
read(size) |
读取指定字节数 | 如果数据不够，会阻塞？不，异步下不会 |
bytesAvailable() |
返回可读字节数 | 配合 readyRead 信号使用 |
waitForBytesWritten() |
阻塞等待数据写完 | 同样慎用，会卡 UI |
小技巧：我个人习惯在 readyRead 信号里先调用 bytesAvailable() 判断数据量，再决定怎么读。比如协议头固定 4 字节，那就先读 4 字节解析长度，再读剩下的。这样可以有效避免粘包。
2.2.3 状态控制
| 方法 | 说明 |
|---|---|
abort() |
立即关闭连接，不等待 |
close() |
关闭 socket，释放资源 |
setSocketOption() |
设置 socket 选项（如超时时间） |
abort() 和 disconnectFromHost() 的区别是什么？abort() 是暴力断开，不管有没有数据没发完，直接咔嚓。而 disconnectFromHost() 会等缓冲区里的数据发完再断开。我建议一般情况下用 disconnectFromHost()，除非你确定要立即释放资源。
2.3 QTcpSocket 的信号与槽
这才是 QTcpSocket 的精髓。信号与槽机制让异步编程变得优雅。你不需要轮询，不需要写复杂的回调函数，只需要把信号和槽连起来，Qt 会在合适的时机自动调用你。
下面这张图展示了 QTcpSocket 的核心信号流转过程：
咱们来逐个分析这些信号：
2.3.1 connected()
当 socket 成功连接到服务器时触发。这是你开始发送数据的信号。我建议在这个信号里做两件事：一是更新 UI 状态（比如按钮变灰、显示「已连接」），二是发送初始握手数据（如果有的话）。
2.3.2 readyRead()
这是最常用的信号。当有数据到达时触发。注意：它不保证一次触发就是一整条消息。TCP 是流式协议，数据可能分多次到达。所以你需要自己处理粘包和拆包。
避坑指南：我曾经在 readyRead 里直接调用 readAll() 然后解析，结果服务器发了一条 10KB 的消息，但只收到了 2KB。解析当然失败了。后来我改成先读固定长度的协议头，再根据协议头里的长度字段读完整数据，才解决问题。
2.3.3 disconnected()
连接断开时触发。不管是服务器主动断开、网络异常、还是你调用了 disconnectFromHost()，都会触发这个信号。我建议在这里做清理工作：关闭文件、释放资源、更新 UI 状态。
2.3.4 errorOccurred()
发生错误时触发。比如连接超时、DNS 解析失败、服务器拒绝连接等。这个信号会携带一个 QAbstractSocket::SocketError 枚举值，告诉你具体是什么错误。
嗯，这里要注意：在 Qt 5.15 之前，错误信号叫 error()，之后改成了 errorOccurred()。如果你在维护老项目，记得检查一下版本。
2.3.5 bytesWritten()
当数据真正被写入底层 socket 时触发。注意：write() 返回的是写入缓冲区的字节数，不是实际发送的字节数。这个信号告诉你「数据已经发出去了」。如果你需要做流量控制或者进度条，这个信号很有用。
2.3.6 stateChanged()
当 socket 状态变化时触发。比如从 UnconnectedState 变成 ConnectingState，再变成 ConnectedState。调试时打印这个信号的值，能帮你理清 socket 的生命周期。
最后，给一个最简单的使用模板：
// 创建 socket
QTcpSocket *socket = new QTcpSocket(this);
// 连接信号
connect(socket, &QTcpSocket::connected, this, [=]() {
qDebug() << "连接成功！";
socket->write("Hello Server");
});
connect(socket, &QTcpSocket::readyRead, this, [=]() {
QByteArray data = socket->readAll();
qDebug() << "收到数据:" << data;
});
connect(socket, &QTcpSocket::disconnected, this, [=]() {
qDebug() << "连接断开";
});
// 发起连接
socket->connectToHost("127.0.0.1", 8080);这个模板虽然简单，但已经覆盖了 80% 的场景。剩下的 20%，比如重连机制、心跳包、数据分包，咱们后面会慢慢展开。
可可精品资料库