4、第一个网络程序：创建简单的TCP客户端与服务器，实现字符串消息的发送与接收，理解事件循环与信号槽机制

本章是QT网络编程的起点。我们将从零构建一个基于TCP协议的客户端与服务器程序，实现字符串消息的发送与接收。在这个过程中，你不仅会掌握QT网络模块的核心类（QTcpServer、QTcpSocket），更会深入理解QT事件循环（Event Loop）与信号槽（Signals & Slots）机制在网络通信中的关键作用。网络通信是异步的，而QT的信号槽机制正是处理这种异步事件的最佳范式。通过本章的学习，你将建立起“事件驱动”的编程思维，为后续处理复杂协议、高并发连接打下坚实基础。

上图展示了本章将要实现的TCP客户端与服务器的核心架构。左侧为服务器端，右侧为客户端，中间通过TCP连接进行数据交换。请注意，无论是客户端还是服务器，都运行在各自的事件循环中，所有网络事件（如新连接、数据到达、断开连接）都会通过信号槽机制通知应用程序。这是理解QT网络编程的关键。

4.1 核心原理：事件循环与信号槽机制

QT网络编程与传统的阻塞式Socket编程有本质区别。传统方式中，程序会阻塞在accept()或recv()调用上，等待网络事件发生。而QT采用事件驱动模型，程序启动后进入事件循环（QEventLoop），不断检查事件队列中是否有新事件。当网络事件发生时，QT底层会将事件封装为对应的信号（Signal），并投递到事件队列中。事件循环取出事件后，会调用与之关联的槽函数（Slot）。

在TCP编程中，我们主要关注以下信号：

• QTcpServer::newConnection()：当有客户端发起连接时，服务器发射此信号。
• QTcpSocket::connected()：客户端成功连接到服务器后发射。
• QTcpSocket::readyRead()：当有数据到达时发射，表示可以读取数据。
• QTcpSocket::disconnected()：连接断开时发射。
• QTcpSocket::errorOccurred()：发生网络错误时发射。

理解事件循环与信号槽的关系，是编写稳定网络程序的前提。事件循环保证了信号能够被及时处理，而信号槽机制则提供了灵活的事件分发方式。

4.2 操作流程：搭建TCP服务器与客户端

我们将分步骤实现一个简单的字符串回显程序：客户端发送一条消息，服务器接收后原样返回。这个流程涵盖了TCP通信的核心环节。

4.2.1 创建TCP服务器

服务器端的实现分为三个步骤：创建监听套接字、处理新连接、收发数据。

// ServerWidget.h
class ServerWidget : public QWidget {
    Q_OBJECT
public:
    explicit ServerWidget(QWidget *parent = nullptr);
private slots:
    void onNewConnection();
    void onReadyRead();
    void onDisconnected();
private:
    QTcpServer *m_server;
    QList<QTcpSocket*> m_clients;
    QTextEdit *m_logEdit;
};

// ServerWidget.cpp
ServerWidget::ServerWidget(QWidget *parent) : QWidget(parent) {
    m_server = new QTcpServer(this);
    // 监听所有网卡的8888端口
    if (!m_server->listen(QHostAddress::Any, 8888)) {
        qDebug() << "监听失败:" << m_server->errorString();
        return;
    }
    // 连接新连接信号
    connect(m_server, &QTcpServer::newConnection, this, &ServerWidget::onNewConnection);
    qDebug() << "服务器启动，监听端口: 8888";
}

void ServerWidget::onNewConnection() {
    while (m_server->hasPendingConnections()) {
        QTcpSocket *socket = m_server->nextPendingConnection();
        m_clients.append(socket);
        // 连接数据到达信号
        connect(socket, &QTcpSocket::readyRead, this, &ServerWidget::onReadyRead);
        connect(socket, &QTcpSocket::disconnected, this, &ServerWidget::onDisconnected);
        qDebug() << "新客户端连接:" << socket->peerAddress().toString();
    }
}

void ServerWidget::onReadyRead() {
    QTcpSocket *socket = qobject_cast<QTcpSocket*>(sender());
    if (!socket) return;
    QByteArray data = socket->readAll();
    qDebug() << "收到数据:" << data;
    // 原样返回
    socket->write(data);
}

void ServerWidget::onDisconnected() {
    QTcpSocket *socket = qobject_cast<QTcpSocket*>(sender());
    if (!socket) return;
    m_clients.removeAll(socket);
    socket->deleteLater();
    qDebug() << "客户端断开连接";
}

在上述代码中，listen()函数启动监听，newConnection信号在每次有客户端连接时触发。onNewConnection()槽函数中，我们通过nextPendingConnection()获取新的套接字，并为其连接readyRead信号。注意，每个客户端连接都需要独立的QTcpSocket实例。

4.2.2 创建TCP客户端

客户端的实现相对简单：连接服务器、发送数据、接收回显。

// ClientWidget.cpp
ClientWidget::ClientWidget(QWidget *parent) : QWidget(parent) {
    m_socket = new QTcpSocket(this);
    // 连接服务器
    m_socket->connectToHost("127.0.0.1", 8888);
    // 连接信号
    connect(m_socket, &QTcpSocket::connected, this, &ClientWidget::onConnected);
    connect(m_socket, &QTcpSocket::readyRead, this, &ClientWidget::onReadyRead);
    connect(m_socket, &QTcpSocket::errorOccurred, this, &ClientWidget::onError);
}

void ClientWidget::onConnected() {
    qDebug() << "连接成功，发送消息...";
    m_socket->write("Hello, Server!");
}

void ClientWidget::onReadyRead() {
    QByteArray data = m_socket->readAll();
    qDebug() << "收到回显:" << data;
}

void ClientWidget::onError(QAbstractSocket::SocketError error) {
    qDebug() << "网络错误:" << m_socket->errorString();
}

客户端通过connectToHost()发起连接，连接成功后发射connected信号。在onConnected()槽中发送数据，在onReadyRead()槽中接收数据。这种异步模式确保了UI线程不会被网络操作阻塞。

4.3 案例拆解：字符串回显程序的完整实现

下面我们通过一个完整的案例，展示如何将上述代码整合到一个可运行的QT Widgets应用程序中。这个案例将包含UI界面，方便观察通信过程。

组件	类型	作用
QTextEdit	日志显示区	显示服务器/客户端的收发日志
QPushButton	启动服务器	点击后启动TCP服务器
QPushButton	连接服务器	点击后客户端连接服务器
QLineEdit	消息输入框	输入要发送的字符串
QPushButton	发送消息	将输入框内容发送给服务器

在服务器端，我们维护一个客户端列表m_clients，用于管理多个连接。当收到数据时，遍历所有客户端并转发消息，实现简单的广播功能。在客户端，我们使用QTimer定时发送消息，模拟持续通信的场景。

运行程序后，先点击“启动服务器”，再点击“连接服务器”，然后在输入框中输入消息并点击“发送”。观察日志区，可以看到消息的收发过程。这个案例虽然简单，但涵盖了TCP通信的所有关键环节。

4.4 常见误区与总结复盘

初学者在编写第一个网络程序时，经常会遇到以下问题：

• 误区一：忘记调用readAll()。如果不在readyRead槽中读取数据，该信号会持续触发，导致CPU占用率飙升。
• 误区二：使用局部变量接收套接字。在onNewConnection()中，如果使用局部QTcpSocket变量，函数结束后套接字会被销毁，连接立即断开。必须使用指针并妥善管理生命周期。
• 误区三：混淆waitForConnected()与异步连接。waitForConnected()会阻塞事件循环，在GUI程序中会导致界面卡死。应始终使用异步方式。
• 误区四：忽略错误处理。网络通信受环境影响较大，必须连接errorOccurred信号，并在槽函数中记录错误信息。