Qt Quick UI设计需以ApplicationWindow为骨架、anchors布局为筋骨、Controls组件为血肉；必须遵守结构契约、锚点约束链和控件版本统一，否则易导致错位、重叠与跨平台异常。
Qt Quick UI 界面设计不是“先画再写”，而是以 ApplicationWindow 为骨架、anchors 布局为筋骨、Controls 组件为血肉的声明式构建过程。直接上手拖拽或手写 QML 都可行，但关键在于理解结构层级和锚点约束逻辑——否则界面一改尺寸就错位，一加组件就重叠。
用 ApplicationWindow 而不是 Window 搭建主窗口
桌面应用别用裸 Window，它没菜单栏、工具栏、状态栏的语义插槽，全靠手动堆 Rectangle + anchors，后期维护成本高且跨平台行为不一致。
ApplicationWindow 提供了预置结构插槽：menuBar、header（即工具栏）、contentItem（默认客户区）、footer。这些不是装饰，是 Qt Quick Controls 的布局契约：
-
menuBar只接受MenuBar类型，系统会自动适配 macOS 的全局菜单栏 -
header接收ToolBar，其内部子项默认水平流式排列，不用手动写RowLayout -
contentItem是你放业务 UI 的地方，它本身是Item，不是Rectangle，所以要背景色得显式加Rectangle并anchors.fill: parent
锚点布局 anchors 比坐标定位更可靠
别在 QML 里写 x: 100; y: 50，这是 Qt Widgets 思维。QML 的 anchors 是响应式基础：
-
anchors.left: parent.left和anchors.leftMargin: 12才是标准左距写法，不是x: 12 - 同级组件对齐用
anchors.top: button1.bottom，不是算两个y差值 -
anchors.fill: parent是最常用也最容易误用的——如果父项没设宽高（比如未被ApplicationWindow或Item显式约束），子项会塌缩为 0×0 - 避免混合使用：同一组件别既写
anchors.left又写x，引擎会静默忽略x
控件选 QtQuick.Controls 2.x 而非原始 Item
自己用 Rectangle + Text + MouseArea 手搓按钮？可以，但失去主题适配、键盘焦点、无障碍支持、平台原生样式（如 macOS 的圆角按钮、Windows 的 Fluent 阴影）。
用 Button、TextField、ComboBox 这些来自 QtQuick.Controls 2.5 或更高版本的控件：
- 它们自带
enabled、pressed、hovered状态，配合states和transitions就能做交互动画 - 样式通过
background、contentItem覆盖，不破坏控件逻辑 - 注意导入语句必须匹配：用
import QtQuick.Controls 2.15就别混用QtQuick.Controls 1.x的Button，后者不兼容新锚点规则
设计器拖拽后必须检查生成的 QML 结构
Qt Creator 的 Qt Quick Designer 拖拽很爽，但生成的代码常埋雷：
- 拖进一个
Button，它可能被包在一层无名Item里，导致anchors失效——删掉多余包裹层 - 设计器默认给组件加
width/height固定值，响应式场景下应删掉，改用anchors或implicitWidth - 自定义组件（如
CustomButton.qml）拖入后，设计器可能不识别其属性，需手动在.qmlproject中注册QML_IMPORT_PATH - 拖拽的
ListView默认没设model和delegate，运行时报TypeError: Cannot read property 'count' of null
真正卡住人的从来不是语法，而是 ApplicationWindow 的结构契约没守牢、anchors 约束链中途断裂、或者控件版本混用导致的隐式行为差异。每次加新组件，先看它挂在哪一层、父项是否具备有效尺寸、锚点是否形成闭环——这三步比写十行逻辑更重要。
