第二十八章 QT项目实战（三）：网络通信集成、第三方库集成、打包发布

好，到了这一步，咱们的项目已经像个样子了。前面两章我们把界面搭起来，业务逻辑也跑通了。但一个真正的桌面应用，光会自己玩可不行——你得能联网、能用别人的轮子、最后还得能发给别人用。这一章，我就带你把这三大块啃下来。

28.1 网络通信集成：让程序开口说话

现在的软件，十个有九个要联网。QT 在这方面做得挺贴心，它把网络通信封装成了几个核心类，用起来比原生 socket 舒服多了。

28.1.1 QTcpSocket 与 QTcpServer

先说说 TCP。我习惯把 QTcpSocket 看作一根管子，数据从这头流到那头。服务端用 QTcpServer 监听端口，客户端用 QTcpSocket 连接过去。

来个最简单的服务端代码：

// 服务端：监听 8888 端口
QTcpServer *server = new QTcpServer(this);
if (!server->listen(QHostAddress::Any, 8888)) {
    qDebug() << "监听失败：" << server->errorString();
    return;
}
connect(server, &QTcpServer::newConnection, this, [=]() {
    QTcpSocket *socket = server->nextPendingConnection();
    qDebug() << "新客户端连接：" << socket->peerAddress().toString();
});

客户端那边更简单：

QTcpSocket *socket = new QTcpSocket(this);
socket->connectToHost("127.0.0.1", 8888);
connect(socket, &QTcpSocket::readyRead, this, [=]() {
    QByteArray data = socket->readAll();
    qDebug() << "收到数据：" << data;
});

嗯，这里要注意：readyRead 信号可能只触发一次，但数据可能分多次到达。我在项目中遇到过这个问题，后来加了个缓冲区，把没读完的数据攒起来，等完整包到了再处理。

28.1.2 QNetworkAccessManager：HTTP 请求一把梭

如果你只是要调个 REST API、下载个文件，那用 TCP 就太原始了。QT 提供了 QNetworkAccessManager，说白了就是帮你封装了 HTTP 协议。

QNetworkAccessManager *manager = new QNetworkAccessManager(this);
QNetworkRequest request(QUrl("https://api.example.com/data"));
request.setHeader(QNetworkRequest::ContentTypeHeader, "application/json");

// GET 请求
QNetworkReply *reply = manager->get(request);
connect(reply, &QNetworkReply::finished, this, [=]() {
    if (reply->error() == QNetworkReply::NoError) {
        QByteArray response = reply->readAll();
        // 解析 JSON
        QJsonDocument doc = QJsonDocument::fromJson(response);
        // ...
    }
    reply->deleteLater();
});

你想想看，如果自己用 socket 拼 HTTP 请求头，那得多麻烦。QNetworkAccessManager 把 GET、POST、PUT、DELETE 都封装好了，你只管填 URL 和参数就行。

28.2 第三方库集成：站在巨人肩膀上

QT 自带的库虽然够用，但有些场景还是得请外援。比如处理 JSON 用 QJsonDocument 还行，但要是解析 XML、操作 Excel、或者搞个二维码生成，那就得找第三方库了。

28.2.1 用 CMake 集成第三方库

我建议用 CMake 管理项目，这样集成第三方库最方便。假设你要集成一个叫 libqrencode 的二维码库：

# CMakeLists.txt
cmake_minimum_required(VERSION 3.16)
project(MyApp)

find_package(Qt6 REQUIRED COMPONENTS Widgets Network)

# 找第三方库
find_library(QRENCODE_LIB qrencode)
if(NOT QRENCODE_LIB)
    message(FATAL_ERROR "找不到 libqrencode，请先安装")
endif()

add_executable(MyApp main.cpp)
target_link_libraries(MyApp Qt6::Widgets Qt6::Network ${QRENCODE_LIB})
target_include_directories(MyApp PRIVATE /usr/include)

如果你用的是 vcpkg 或者 Conan，那就更省事了。我个人习惯用 vcpkg，一条命令装好所有依赖：

vcpkg install qrencode
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake

28.2.2 静态库 vs 动态库

这里有个选择题：用静态库还是动态库？

类型	优点	缺点
静态库（.a/.lib）	打包后只有一个 exe，部署简单	体积大，更新库要重新编译
动态库（.so/.dll）	体积小，可单独更新	部署时要带一堆 dll，容易缺文件

我的建议是：如果是给客户交付，用静态库；如果是内部工具，动态库更方便。我曾经吃过动态库的亏——客户电脑上缺了 MSVC 运行时，程序直接崩溃。后来改用静态编译，再也没出过这种问题。

28.3 打包发布：让程序跑在别人电脑上

代码写完了，库也集成了，怎么发给别人？直接把 exe 拷过去肯定不行——缺 QT 的 dll、缺插件、缺运行时。这时候就要用到 QT 官方提供的部署工具了。

28.3.1 windeployqt：Windows 下的打包利器

在 Windows 上，打开 QT 的命令行工具，进到你的 exe 目录，执行：

windeployqt MyApp.exe --release --no-translations --no-system-d3d-compiler

它会自动把需要的 dll、插件、qml 文件都拷过来。我一般还会加个 --no-translations，省得带一堆没用的翻译文件。

跑完之后，目录结构大概是这样：

MyApp/
├── MyApp.exe
├── Qt6Core.dll
├── Qt6Widgets.dll
├── Qt6Network.dll
├── platforms/
│   └── qwindows.dll
├── styles/
│   └── qwindowsvistastyle.dll
└── ... 其他 dll

28.3.2 linuxdeployqt：Linux 下的打包

Linux 上类似，用 linuxdeployqt 工具：

linuxdeployqt MyApp -appimage

它会生成一个 AppImage 文件，用户下载后直接 chmod +x 就能运行，不需要安装任何依赖。这个方式在 Ubuntu 上特别流行。

不过要注意，linuxdeployqt 对系统有要求——它需要 FUSE 支持。我在 CentOS 7 上就踩过这个坑，后来改用 ldd 手动收集依赖库，再写个启动脚本才搞定。

28.3.3 打包后的测试清单

打包完别急着发，先跑一遍这个清单：

1. 把打包后的文件夹拷到一台干净的虚拟机（没装 QT 的）
2. 双击 exe，看能不能启动
3. 测试所有网络功能——能不能连上服务器
4. 测试第三方库功能——比如二维码能不能生成
5. 检查有没有缺少 dll 的弹窗

我记得有一次，我打包完发给客户，结果客户说程序打不开。远程一看，原来是缺了 libcrypto-1_1.dll——OpenSSL 的库。从那以后，我每次打包都用 Process Explorer 检查一遍所有加载的 dll。

28.4 本章知识体系

下面这张图，把本章的核心内容串起来了：

这一章的内容，说白了就是让程序从「能跑」变成「能用」。网络通信让它能跟外界交互，第三方库让它功能更强，打包发布让它能真正交付给用户。这三步走完，你的 QT 项目才算真正落地。

嗯，最后提醒一句：打包发布前，一定在干净环境里测一遍。别问我怎么知道的——都是泪的教训。