在Visual Studio中新建QtQuick应用找不到qml.ui文件怎么办？

问题产生的核心原因 #

• 两类Qt项目的设计文件生态完全独立。你之前在Widgets项目中接触的.ui文件是Qt Widgets专属的XML格式窗体描述文件，构建阶段会被uic工具转换为C++类代码，全程和QWidget生态深度绑定，不会被纳入QML项目的文件体系。
• QML技术栈本身不存在原生的qml.ui格式。从Widgets项目迁移的开发者通常会形成惯性认知，认为QML也存在和Widgets一一对应的同名设计文件，但实际上QML是声明式脚本语言，所有界面布局、样式、交互逻辑都直接写在纯文本的.qml文件中，不需要依赖.ui这类编译中间产物来承载界面描述。很多人记忆中的可拖拽编辑的QML设计文件，实际是后缀为.ui.qml的约束型QML文件，不少人把后缀记混成qml.ui，自然在文件列表里找不到匹配项。
• VS下的Qt Quick项目模板默认配置偏向精简。新建Qt Quick应用时，默认生成的模板仅包含基础的运行入口.qml文件，不会主动初始化可被Qt Quick Designer可视化编辑的.ui.qml设计文件，和Widgets项目默认生成主窗体.ui文件的逻辑不一样，因此新建完成后自然找不到和之前体验匹配的设计文件。

对应的解决方法 #

• 先明确可编辑QML设计文件的真实形式。不要搜索不存在的qml.ui，QML生态中适配可视化拖拽编辑能力的文件后缀为.ui.qml，这类文件是QML的约束子集，仅允许放置控件布局、基础属性设置，不支持编写复杂自定义逻辑，专门用于降低可视化设计的解析开销，作用和Widgets项目里的.ui文件类似。
• 手动创建可编辑的设计文件。在VS的解决方案资源管理器中，右键点击项目内需要存放UI文件的目录，依次选择「添加-新建项」，在Qt VS Tools提供的模板分类中选择Qt Quick UI File，输入文件名后确认，生成的文件会自动采用.ui.qml后缀，双击即可在Qt Quick Designer中打开拖拽编辑，操作流程和之前编辑Widgets的.ui文件一致。
• 调整项目初始化模板减少手动操作。如果希望新建项目就自带主界面的设计文件，可以在新建Qt Quick项目时，选择带完整可视化设计支持的模板变体，跳过最精简的纯代码项目选项，项目初始化完成后就会自动生成可直接编辑的主界面.ui.qml文件，不需要手动创建。

内容的提问来源于stack exchange，提问作者Opsi daisyy