C++ Qt网络编程入门（从零开始构建TCP客户端与服务器）

准备工作

确保你已安装：

• Qt 开发环境（推荐 Qt Creator + MinGW 或 MSVC）
• 基本的 C++ 编程知识

在项目文件（.pro）中添加网络模块支持：

QT += core networkCONFIG += c++11

第一步：创建 TCP 服务器

我们先来编写一个简单的 TCP 服务器，它能接收客户端连接并回显消息。

1. 头文件（server.h）

#ifndef SERVER_H#define SERVER_H#include <QTcpServer>#include <QTcpSocket>#include <QObject>class Server : public QObject{    Q_OBJECTpublic:    explicit Server(QObject *parent = nullptr);    bool startServer(quint16 port = 8888);private slots:    void onNewConnection();    void onReadyRead();private:    QTcpServer *m_server;};#endif // SERVER_H

2. 实现文件（server.cpp）

#include "server.h"#include <QDebug>Server::Server(QObject *parent)    : QObject(parent), m_server(new QTcpServer(this)){    connect(m_server, &QTcpServer::newConnection, this, &Server::onNewConnection);}bool Server::startServer(quint16 port){    if (!m_server->listen(QHostAddress::Any, port)) {        qDebug() << "服务器启动失败:" << m_server->errorString();        return false;    }    qDebug() << "服务器已在端口" << port << "监听...";    return true;}void Server::onNewConnection(){    QTcpSocket *clientSocket = m_server->nextPendingConnection();    qDebug() << "新客户端连接:" << clientSocket->peerAddress().toString();    connect(clientSocket, &QTcpSocket::readyRead, this, [clientSocket]() {        QByteArray data = clientSocket->readAll();        qDebug() << "收到数据:" << data;        // 回显数据        clientSocket->write(data);    });    connect(clientSocket, &QTcpSocket::disconnected, clientSocket, &QTcpSocket::deleteLater);}

第二步：创建 TCP 客户端

接下来，我们编写一个客户端，用于连接服务器并发送/接收消息。

1. 头文件（client.h）

#ifndef CLIENT_H#define CLIENT_H#include <QTcpSocket>#include <QObject>class Client : public QObject{    Q_OBJECTpublic:    explicit Client(QObject *parent = nullptr);    void connectToServer(const QString &host = "127.0.0.1", quint16 port = 8888);    void sendMessage(const QString &message);private slots:    void onConnected();    void onReadyRead();private:    QTcpSocket *m_socket;};#endif // CLIENT_H

2. 实现文件（client.cpp）

#include "client.h"#include <QDebug>Client::Client(QObject *parent)    : QObject(parent), m_socket(new QTcpSocket(this)){    connect(m_socket, &QTcpSocket::connected, this, &Client::onConnected);    connect(m_socket, &QTcpSocket::readyRead, this, &Client::onReadyRead);}void Client::connectToServer(const QString &host, quint16 port){    m_socket->connectToHost(host, port);}void Client::sendMessage(const QString &message){    if (m_socket->state() == QAbstractSocket::ConnectedState) {        m_socket->write(message.toUtf8());    }}void Client::onConnected(){    qDebug() << "已连接到服务器";}void Client::onReadyRead(){    QByteArray data = m_socket->readAll();    qDebug() << "服务器回显:" << data;}

第三步：主函数测试

在 main.cpp 中分别测试服务器和客户端：

// 测试服务器#include "server.h"#include <QCoreApplication>int main(int argc, char *argv[]){    QCoreApplication a(argc, argv);    Server server;    server.startServer(8888);    return a.exec();}

// 测试客户端（可另建一个项目）#include "client.h"#include <QCoreApplication>#include <QTimer>int main(int argc, char *argv[]){    QCoreApplication a(argc, argv);    Client client;    client.connectToServer();    QTimer::singleShot(1000, [&client]() {        client.sendMessage("Hello from Qt Client!");    });    return a.exec();}

总结

通过本教程，你已经掌握了使用 Qt客户端服务器开发 的基本流程。我们实现了：

• 一个能接收多客户端连接的 TCP 服务器
• 一个能发送和接收消息的 TCP 客户端
• 信号与槽机制处理异步网络事件

这是 Qt网络应用教程 的基础，后续你可以在此基础上添加 GUI 界面、协议解析、加密通信等功能，构建更复杂的应用。

提示：实际项目中建议使用线程或异步方式处理多个客户端，避免阻塞主线程。