qt 6.5+ 自带 qwebsocket，需在 cmake 或 qmake 中显式链接 websockets 模块，头文件仅需 #include ；必须等待 connected 信号后再发消息，并正确管理 ssl 配置与对象生命周期。
Qt 6.5+ 自带 QWebSocket，无需额外安装 —— 但必须正确链接模块、处理信号连接时机、避免在未就绪时发消息。
Qt 项目里怎么启用 QWebSocket 模块
不是加头文件就能用。CMake 或 qmake 必须显式声明依赖，否则编译通过但运行时报 QWebSocket: No such file or directory 或链接失败。
- CMake：在
CMakeLists.txt中写find_package(Qt6 REQUIRED COMPONENTS WebSockets)，再target_link_libraries(your_target PRIVATE Qt6::WebSockets) - qmake：在
.pro文件中加QT += websockets（注意是websockets，不是websocket或QtWebSockets） - 头文件只需
#include <qwebsocket></qwebsocket>，无需#include <qtwebsockets></qtwebsockets>（后者是 Qt 5 的旧路径，Qt 6 已统一）
connect() 之后不能立刻 sendTextMessage()
常见错误：m_webSocket.open(url) 后马上调用 sendTextMessage()，结果消息静默丢失。因为连接是异步建立的，socket 还没真正 ready。
- 必须等
QWebSocket::connected信号触发后，才可安全发送 - 务必在
connected槽函数里连接textMessageReceived信号，而不是在构造函数里提前连 —— 否则可能收到重复或错乱消息 - 如果服务器响应慢，
open()后立即检查m_webSocket.state()会是QAbstractSocket::ConnectingState，不是ConnectedState
wss:// 连接失败的三个关键点
用 wss:// 时崩溃或连接被拒绝，大概率不是证书问题，而是 SSL 配置缺失或误用。
- Qt 默认不信任自签名证书 —— 若服务端用自签证书，需调用
m_webSocket.ignoreSslErrors()（仅开发环境） - 必须用
QSslConfiguration设置协议版本，例如config.setProtocol(QSsl::TlsV1_2)；Qt 6.5+ 默认禁用 TLS 1.0/1.1 -
QWebSocket不自动读取系统证书库，若用系统级 CA（如 Ubuntu 的/etc/ssl/certs），需手动调用config.setCaCertificates(...)
QWebSocket 对象生命周期管理容易出错
对象析构时若 socket 仍在连接中，可能触发崩溃或资源泄漏 —— 尤其在槽函数里直接 deleteLater() 或 delete this。
- 务必在析构前调用
m_webSocket.close()，并等待disconnected信号后再销毁对象 - 不要在
disconnected槽里直接 delete this，应改用QObject::deleteLater()并确保没有其他 pending 信号 - 若使用智能指针（如
QScopedPointer<qwebsocket></qwebsocket>），需重载reset()前手动 close，否则析构时 socket 可能仍处于ConnectedState
最常被忽略的是：QWebSocket 内部使用 Qt 的事件循环驱动 I/O，如果主线程没运行 event loop（比如在 console app 中未调用 QCoreApplication::exec()），所有信号都不会触发，连接永远卡在 connecting 状态。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
