能跑起来的ApplicationWindow需导入QtQuick和Controls模块，设置visible:true、宽高及标题，运行即见空白窗口；报错则补装对应版本Controls模块。
直接上手写一个能跑起来的 ApplicationWindow，比看任何理论都管用。QML 不是“学完语法再写”，而是“边改边懂”——你改一行属性，界面立刻响应，这种即时反馈就是它最有效的入门路径。
先跑通第一个可交互窗口
别从 Rectangle 开始，直接用 ApplicationWindow，它自带平台原生窗口装饰和事件循环，省掉一堆环境适配问题。
- 确保 Qt Creator 已安装 Qt 6.5+ 并勾选了
Qt Quick和Qt Quick Controls模块 - 新建项目时选 “Qt Quick Application - Empty”（不是 Widgets）
- 删掉模板里所有冗余代码，只留这六行：
import QtQuick6.5
import QtQuick.Controls6.5
<p>ApplicationWindow {
visible: true
width: 640; height: 480
title: qsTr("Hello QML")
}</p>
运行。如果看到一个空白窗口，说明环境通了；如果报错 module "QtQuick.Controls6.5" is not installed，说明模块没装全，回 Qt Maintenance Tool 补装对应版本的 Qt Quick Controls。
加按钮、绑逻辑、别碰 C++ 先
初学阶段最大的干扰是过早对接 C++。先用纯 QML 把 UI 响应闭环走通，再考虑后端。
- 在
ApplicationWindow内加一个Button，用anchors.centerIn: parent居中 - 给按钮加
onClicked处理器，里面只做两件事：console.log("clicked")和修改自身text - 不要写
function或自定义信号，先用onClicked直接写逻辑 - 避免嵌套超过三层对象（比如 Button → Column → Text → Rectangle），深嵌套会让锚点失效且难调试
此时你已经掌握了 QML 最核心的三样东西：模块导入、对象树结构、信号响应。后面所有功能都是在这三根柱子上长出来的。
属性绑定写错的典型表现
QML 里 70% 的“界面不动”“值不更新”问题，都出在绑定表达式写法上。
- 写
width: parent.width * 0.8是对的；写width: parent ? parent.width * 0.8 : 0就多余——QML 自动处理未定义情况 - 想让颜色随布尔值变，别写
color: isActive ? "red" : "gray"，而要确保isActive是个真实属性（比如property bool isActive: false），否则绑定不触发 -
Text { text: model.name }中，如果model是空对象，text会变成"undefined"，不是空字符串——加个默认值更稳：text: model ? model.name : "" - 用
Qt.binding()的场景极少，99% 的绑定需求靠冒号赋值就能解决
什么时候该切到 C++？
当你发现 QML 里开始反复写相同的数据处理逻辑，比如解析 JSON、计算时间差、调用系统 API，或者动画卡顿明显（FPS
- 别一上来就注册
qmlRegisterType，先确认 QML 真的搞不定 - C++ 类暴露属性必须带
Q_PROPERTY+NOTIFY信号，否则 QML 绑定不了变化 - 从 C++ 向 QML 传数据，优先用
QVariantMap或QList，别传裸指针或复杂自定义类型 - QML 调 C++ 函数，参数类型必须严格匹配（
int不能传double），否则静默失败
真正卡住新手的，从来不是 QML 语法多难，而是分不清哪些该在 QML 做、哪些该甩给 C++。一个简单判断标准：只要涉及耗时操作、跨线程、或需要 Qt 核心类（如 QNetworkAccessManager），就该切过去。
