如何以标准Qt方式创建单个.ui.qml表单文件？

Great question! Let's clarify the official, standard ways to create and use a single .ui.qml file (instead of the split Component.qml + ComponentForm.ui.qml setup you're familiar with) — and confirm that this pattern is fully supported by Qt, not a workaround.

First, a quick note: Qt's split file structure is designed for separating UI and business logic (ideal for complex components), but using a single .ui.qml file as a complete, self-contained component is absolutely a valid, standard practice (as shown in the Contact List example). It's perfect for simple components where UI and logic are tightly coupled or minimal.

Standard Ways to Create a Single .ui.qml File #

Here are the two official, clean methods in Qt Creator:

1. Directly Create a .ui.qml File

   • Right-click your project in the Projects pane → Add New...
   • Select Qt Quick File (not Qt Quick UI File) from the Qt Quick category
   • In the "File name" field, explicitly name your file with the .ui.qml extension (e.g., Contact.ui.qml)
   • Click Finish — this generates a single .ui.qml file that you can edit in both Qt Quick Designer and the code editor. Qt Creator recognizes the .ui.qml extension and treats it as a designable UI file, just like the split form files.

2. Repurpose the Split File Setup (Optional)

   • If you start by creating a Qt Quick UI File (which generates two files: Component.qml and ComponentForm.ui.qml), you don't need to delete the logic file as a "workaround". Instead:
     • Move all your business logic directly into the .ui.qml file
     • Delete the standalone .qml logic file if you don't need it
   • This is still a valid approach — Qt doesn't enforce the split pairing; the .ui.qml file works perfectly on its own.

Key Notes #

• A single .ui.qml file behaves exactly like a regular QML component: you can import it, instantiate it, and add properties/signals/functions directly inside it.
• The .ui.qml extension is just a convention to indicate the file is optimized for Qt Quick Designer editing — there's no technical restriction preventing you from adding logic to it.

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