Qt中QUdpSocket類的簡單使用詳解

更新時(shí)間：2026年01月04日 10:02:20 作者：追烽少年x

文章介紹了QUdpSocket類的基本使用方法,包括發(fā)送端和接收端的代碼實(shí)現(xiàn),QUdpSocket是Qt中用于UDP通信的類,它支持無連接通信、廣播和數(shù)據(jù)包的發(fā)送與接收,文章還提到了數(shù)據(jù)編碼和對比TCP的簡化點(diǎn),感興趣的朋友跟隨小編一起看看吧

QUdpSocket類的簡單使用

下面我們用一個(gè)做一個(gè)簡單的例子。

一、發(fā)送端

發(fā)送端界面：

發(fā)送端代碼：

#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QMainWindow>
#include <QUdpSocket>
QT_BEGIN_NAMESPACE
namespace Ui {
class MainWindow;
}
QT_END_NAMESPACE
class MainWindow : public QMainWindow
{
    Q_OBJECT
public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
private slots:
    void on_btnUnicast_clicked();
    void on_btnBoardcast_clicked();
private:
    Ui::MainWindow *ui;
    QUdpSocket* m_pSender = nullptr;
};
#endif // MAINWINDOW_H

.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QHostAddress>
#include <QDebug>
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    m_pSender = new QUdpSocket(this);
}
MainWindow::~MainWindow()
{
    delete ui;
    delete m_pSender;
}
void MainWindow::on_btnUnicast_clicked()
{
    QString strText = ui->lineEdit->text();
    if(strText.isEmpty())
        return;
    QHostAddress host("127.0.0.1");
    quint16 nPort = 8888;
    qint64 nSend = m_pSender->writeDatagram(strText.toUtf8(),host,nPort);
    if(nSend == -1)
    {
        qDebug() << "單播發(fā)送失敗" << m_pSender->errorString();
    }
    else
    {
        qDebug() << "單播發(fā)送成功，字節(jié)數(shù)" << nSend;
    }
}
void MainWindow::on_btnBoardcast_clicked()
{
    QString strText = ui->lineEdit->text();
    if(strText.isEmpty())
        return;
    quint16 nPort = 8888;
    qint64 nSend = m_pSender->writeDatagram(strText.toUtf8(),QHostAddress::Broadcast,nPort);
    if(nSend == -1)
    {
        qDebug() << "廣播發(fā)送失敗" << m_pSender->errorString();
    }
    else
    {
        qDebug() << "廣播發(fā)送成功，字節(jié)數(shù)" << nSend;
    }
}

二、接收端

接受端的界面，比較簡單：

接受端代碼如下：

#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QMainWindow>
#include <QUdpSocket>
QT_BEGIN_NAMESPACE
namespace Ui {
class MainWindow;
}
QT_END_NAMESPACE
class MainWindow : public QMainWindow
{
    Q_OBJECT
public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
public slots:
    void ReadDatagram();
private:
    Ui::MainWindow *ui;
    QUdpSocket* m_pReceiver;
};
#endif // MAINWINDOW_H

.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    m_pReceiver = new QUdpSocket(this);
    quint16 listenPort = 8888;
    // 綁定端口：QHostAddress::Any 表示監(jiān)聽所有網(wǎng)卡的該端口（支持本機(jī)/局域網(wǎng)/外網(wǎng)）
    bool bBind = m_pReceiver->bind(QHostAddress::Any,listenPort);
    if(!bBind)
    {
        ui->textEdit->append("綁定端口失敗：" + m_pReceiver->errorString());
    }
    else
    {
        ui->textEdit->append("已綁定端口 " + QString::number(listenPort) + "，等待接收數(shù)據(jù)...");
    }
    // 綁定接收數(shù)據(jù)信號：當(dāng)有數(shù)據(jù)到達(dá)時(shí)觸發(fā)readyRead()
    connect(m_pReceiver,&QUdpSocket::readyRead,this,&MainWindow::ReadDatagram);
}
MainWindow::~MainWindow()
{
    delete ui;
    delete m_pReceiver;
}
void MainWindow::ReadDatagram()
{
    // 循環(huán)讀取所有待處理的數(shù)據(jù)包（可能同時(shí)有多個(gè)）
    while (m_pReceiver->hasPendingDatagrams())
    {
        QByteArray datagram;
        // 預(yù)留足夠的緩沖區(qū)（根據(jù)數(shù)據(jù)包大小調(diào)整，這里設(shè)為1024）
        datagram.resize(m_pReceiver->pendingDatagramSize());
        QHostAddress senderIp; // 發(fā)送方IP
        quint16 senderPort;    // 發(fā)送方端口
        // 讀取數(shù)據(jù)包，同時(shí)獲取發(fā)送方的IP和端口
        qint64 readBytes = m_pReceiver->readDatagram(
            datagram.data(),
            datagram.size(),
            &senderIp,
            &senderPort
            );
        if (readBytes == -1)
        {
            ui->textEdit->append("接收失?。? + m_pReceiver->errorString());
            continue;
        }
        // 解析并顯示數(shù)據(jù)
        QString recvData = QString::fromUtf8(datagram);
        QString log = QString("[%1:%2] 接收數(shù)據(jù)：%3")
                          .arg(senderIp.toString())
                          .arg(senderPort)
                          .arg(recvData);
        ui->textEdit->append(log);
    }
}

代碼說明：

核心類QUdpSocket：
- 發(fā)送：writeDatagram() 直接發(fā)送數(shù)據(jù)包，無需建立連接，這是 UDP “無連接” 的核心體現(xiàn)；
- 接收：綁定端口后，通過readyRead()信號監(jiān)聽數(shù)據(jù)，readDatagram()讀取數(shù)據(jù)并獲取發(fā)送方信息；
- 廣播：QHostAddress::Broadcast 是 UDP 獨(dú)有的能力，TCP 無法實(shí)現(xiàn)。
綁定端口的參數(shù)：
- QHostAddress::Any：監(jiān)聽所有網(wǎng)卡的指定端口，支持接收來自本機(jī)、局域網(wǎng)其他設(shè)備的 UDP 數(shù)據(jù)；
- 若僅監(jiān)聽本機(jī)，可用QHostAddress::LocalHost（127.0.0.1）。
數(shù)據(jù)編碼：
- 用toUtf8()/fromUtf8()轉(zhuǎn)換QString和QByteArray，保證跨平臺編碼一致性，避免中文亂碼。
對比 TCP 的簡化點(diǎn)：
- UDP 無需調(diào)用connectToHost()建立連接，也無需處理connected()/disconnected()信號；
- 無需處理粘包：pendingDatagramSize()可獲取單個(gè)數(shù)據(jù)包的大小，一次讀取即可，而 TCP 需自定義協(xié)議拆包。