setWindowTitle()仅对顶层窗口有效，需在构造函数中调用；中文乱码应使用QStringLiteral；UI文件中的标题仅作设计预览，代码设置会覆盖它。

直接调用 setWindowTitle() 就能改，但中文乱码、子控件误设、构造时机不对，这三处最容易出问题。

setWindowTitle() 必须在顶层窗口上调用

只有继承自 QMainWindow、QWidget（且无父对象）、或 QDialog 的顶层窗口才响应这个设置。子控件比如 QPushButton 或嵌套在 QVBoxLayout 里的 QLabel 调用 setWindowTitle() 完全没效果，也不报错——容易误以为代码写错了。

• ✅ 正确：在 MainWindow 或 Widget 构造函数里写 this->setWindowTitle("主界面")
• ❌ 错误：在某个按钮的 click slot 里写 button->setWindowTitle("点我改标题")
• ⚠️ 注意：如果 QWidget 创建时传了非空 parent（比如 new QWidget(this)），它就不是顶层窗口，setWindowTitle() 无效

中文标题乱码？优先用 QStringLiteral

Qt 默认字符串字面量编码依赖编译器和源文件保存格式，Windows 上常见 GBK 源码配 UTF-8 编译器导致标题显示为方块或问号。不用改项目编码或系统 locale，一行就能解决：

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

• ✅ 推荐：this->setWindowTitle(QStringLiteral("串口调试助手"))
• ✅ 备选：this->setWindowTitle(QObject::tr("串口调试助手"))（需配合 .ts 翻译流程）
• ❌ 避免：this->setWindowTitle("串口调试助手")（裸字符串，风险高）

UI 文件里改标题？只影响设计时预览

Qt Designer（.ui 文件）里双击标题栏修改的 windowTitle 属性，只是设计器的元数据。生成的 ui_*.h 会把该值硬编码进 setupUi()，但它会在你手动调用 setWindowTitle() 后被覆盖。所以：

• 如果你没在构造函数里再调一次 setWindowTitle()，运行时看到的就是 .ui 里写的标题
• 但一旦你在代码里写了，.ui 里的值就失效了——不是 bug，是 Qt 的执行顺序决定的
• 想留作默认 fallback？可以只在 if (this->windowTitle().isEmpty()) 时设置，但通常没必要

真正容易被忽略的是：图标和标题是两个独立属性，setWindowIcon() 不会自动同步到任务栏或 Alt+Tab 列表的显示样式，尤其在 Windows 上，需要 .rc 文件或资源系统才能让任务栏缩略图和跳转列表图标完全一致——标题改对了，图标可能还卡在旧版本里。