非AI生成，觉得有用，就请您帮忙点赞转发收藏吧，您的鼓励是我创作的动力，多谢看官。

在日常Qt编程中，难免会碰到各种奇怪的问题，很大概率是我们没有遵守Qt的一些规矩，想用好Qt就必须严格遵守这些规矩，不然坑点优点多啊。

一、内存与对象树管理

父子关系误用：new的对象设了 parent又手动 delete，导致重复释放崩溃；或没设 parent又忘了 delete造成内存泄漏。
栈对象挂父链：把函数内局部栈对象（QObject子类）设给需要长期存在的父对象，函数返回后父对象析构访问野指针崩溃。
QNetworkReply 泄漏：QNetworkAccessManager发出的 finished信号返回的 QNetworkReply*不会自动释放，必须手动 deleteLater()。
智能指针混用：QPointer（弱引用）观测已销毁对象未判空；QSharedPointer与裸指针混用导致重复释放或泄漏。
隐式共享（COW）多线程坑：QString/QList等隐式共享容器在多线程同时“写”时，可能触发意外深拷贝甚至数据竞争。

二、信号槽机制

旧宏语法静默失败：SIGNAL()/SLOT()宏在运行时才检查，拼错名字或参数不匹配不报错但槽不执行；Qt5 新函数指针语法能在编译期检查更安全。
参数类型不匹配：跨线程时自定义类型未用 qRegisterMetaType()注册，连接失败或运行时警告。
Lambda 捕获悬空指针：Lambda 中用 [this]或 [=]捕获，若对象已析构仍可能回调访问野指针，应配合 QPointer或在 disconnect时清理。
连接类型选错：跨线程默认 AutoConnection有时被误以为是直连，实则队列连接，导致执行时序不符合预期；BlockingQueuedConnection用在同线程会死锁。
一个信号连多个槽顺序：执行顺序与 connect顺序一致，但重构后容易忽略依赖关系引发逻辑问题。

三、多线程与事件循环

子线程操作 UI：在非主线程直接操作 QWidget、QPixmap等 GUI 类，随机崩溃报 QPixmap: It is not safe...。
QThread 使用误区：继承 QThread重写 run()却在 run()里创建/操作 UI；或没调用 exec()启动事件循环导致队列信号槽不生效。
线程亲和性乱改：moveToThread()后在不恰当时机调用，或在对象已有事件处理时频繁切换线程。
sleep 阻塞事件循环：在含事件循环的线程里用 QThread::sleep()会卡住定时器、信号槽分发。
processEvents 重入坑：手动调用 QApplication::processEvents()可能导致嵌套事件处理（如重入槽函数）引发状态不一致甚至栈溢出。
共享资源未同步：多线程访问同一 QObject或非线程安全库，只用简单锁但检查与操作非原子性。
数据库连接不能跨线程：每个线程需独立 QSqlDatabase连接，跨线程共享会崩溃。

四、事件系统

重写事件不调基类：重写 resizeEvent、paintEvent等忘了 QWidget::xxxEvent(event)，导致布局或默认行为丢失。
mouseMoveEvent 不触发：没设 setMouseTracking(true)，默认只有鼠标按下才发移动事件。
键盘事件无焦点：Widget 没设 setFocusPolicy(Qt::StrongFocus)且没 setFocus()，键盘事件被其他控件吃掉。
事件过滤器不判对象：eventFilter()里没先判断 watched和 event->type()，逻辑误作用于无关控件。
sendEvent/postEvent 混淆：sendEvent同步且在栈上分配事件，postEvent异步在堆上且自动删除，跨线程只能用后者。

五、UI、样式与跨平台

主线程耗时卡 UI：在按钮槽函数里跑大循环/密集计算，事件循环被堵，界面假死。
样式表覆盖代码设置：Qt 样式表优先级高于代码中 setFont/setPalette等，导致代码样式“失效”。
复杂样式表性能差：大量控件嵌套复杂 QSS，界面初次显示或 resize 时卡顿。
布局嵌套过深：重绘和尺寸计算开销大，容易卡顿。
DPI 缩放不全：只开了 AA_EnableHighDpiScaling，但自定义控件没重写 sizeHint/minimumSizeHint在高分屏显示异常。
字体渲染跨平台差异：Windows/Linux/macOS 字体字号渲染不同，界面错位或模糊。
中文乱码：源码编码、编译器执行字符集、QString::fromLocal8Bit使用不当导致乱码，建议统一 UTF-8 并设编译器 /utf-8或对应选项。
QPixmap/QImage 混用坑：QPixmap针对屏幕优化不可跨线程，QImage才是纯数据处理用，搞反容易崩或显示异常。
资源文件 qrc 修改需重编：qrc 编译进可执行文件，改了资源图片不重新编译看起来“没生效”。

六、环境、构建与发布

中文路径问题：Qt 安装目录、项目源码路径含中文，可能导致 moc、uic、编译或运行时诡异错误，开发阶段建议全英文路径。
Q_OBJECT 宏忘加：自定义 QObject子类用了信号槽/属性但未在头文件加 Q_OBJECT，moc 不生成元对象代码，connect 失败或运行时崩溃。
.pro 文件漏写模块：Qt5+ 需手动 QT += widgets/core/network/sql等，漏写对应头文件找不到。
windeployqt 漏拷依赖：Windows 发布少拷 DLL、VC++ 运行时、OpenSSL 等，客户机报缺 dll；Linux/macOS 同样有 ldd依赖和 macdeployqt签名问题。
版本与编译器不兼容：插件与主程序 Qt 版本、编译器（MSVC/GCC/MinGW）不一致，插件加载失败；升级 Qt 版本行为微调未测出坑。
第三方库 ABI 不匹配：Debug/Release、32/64 位、CRT 类型不一致，链接或运行崩溃。