绝大多数情况下，qt creator 打开 .ui 文件闪退或卡死并非代码或 qt 版本 bug，而是因 gradients.xml 缓存文件损坏（linux/macos 在 ~/.designer/，windows 在 %appdata%\qtproject\designer\），删除后重启即可恢复；其次为 .ui 文件关联错误或构建未更新 ui_xxx.h。
Qt Creator 打开 .ui 文件报错，绝大多数情况不是代码问题，而是环境配置或缓存冲突导致的 —— 直接删掉 gradients.xml 或重置 Designer 配置，80% 以上能立刻恢复。
为什么一打开 .ui 就卡死/闪退？
这不是 Qt 版本 bug，也不是你写错了 XML。真正高频原因是 Qt Designer 的本地缓存文件损坏，尤其是 gradients.xml —— 它记录渐变色预设，但旧版本 Designer 写入时容易出错，加载时直接崩溃。
- Linux/macOS 下路径是
~/.designer/gradients.xml - Windows 下路径是
%APPDATA%\QtProject\designer\gradients.xml（注意不是.designer，Qt 5.15+ 后改名了） - 删掉它，重启 Qt Creator，Designer 会自动生成新文件，几乎零成本解决
.ui 文件双击没反应或弹出文本编辑器
说明 Qt Creator 没把 .ui 关联到 Designer，常见于新装 Qt 或跨版本升级后。
Qt Creator 18.0.2
下载
Qt Creator 18.0.2 Windows x86_64 历史版本安装包，适合需要旧版本 IDE、旧项目兼容、Qt/C++ 项目维护、构建套件配置和调试环境回退的用户使用。
- 右键
.ui文件 → “Open with” → “Qt Designer”（如果没这个选项，点“Other…”） - 手动指定路径：找到你当前 Qt 套件的
bin/designer.exe（如C:\Qt\6.7.2\mingw_64\bin\designer.exe） - 勾选“Always open with”，避免每次都要选
- 确认项目
.pro文件里有FORMS += xxx.ui，否则 Qt Creator 不会识别为 UI 资源
修改了 .ui 但运行界面没变化
根本不是 Designer 问题，而是构建系统没更新 ui_xxx.h —— 这个头文件由 uic 工具从 .ui 生成，编译时才被 C++ 代码包含。
- 清理构建目录：
Build→Clean Project，再Rebuild - 更彻底的做法：删掉整个
build-xxx文件夹，重新qmake+ 构建 - 检查
ui_xxx.h是否真的被更新：打开它，搜你新加的控件名（如pushButton_submit），没出现就说明 uic 没跑 - 别手动改
ui_xxx.h，它是自动生成的，改了也会被覆盖
用 VS2022/VS2019 打开 .ui 闪退怎么办？
Qt VS Tools 插件默认在 IDE 内嵌 Designer，但经常因权限或进程隔离失败 —— 最简单解法是强制外置窗口。
- 菜单栏 →
Extensions→Qt VS Tools→Options - 把
Run in detached window设为True - 重启 VS，双击
.ui就会调起独立的designer.exe，不再闪退 - 如果仍失败，检查 VS 里 Qt 版本路径是否指向真实安装目录（尤其注意 mingw/msvc 架构匹配）
真正麻烦的从来不是 .ui 文件本身，而是 Qt Creator 和 Designer 之间那层看不见的缓存、关联、构建链路。删配置、清构建、外置窗口 —— 这三招覆盖了 95% 的报错场景。剩下那些，基本得看 uic 输出的具体错误信息，而不是靠猜。
