为什么会出现“字体不一致”“手动调配色困难”的痛点？

在 QML 项目中，最常见的错误是把本该使用 Label 的地方写成 Text。这样导致这方面，

• 主题字体不随 Controls 主题变化；
• 需要手动设置颜色、大小、粗细，容易出错；
• 无法直接给文字加背景，外层再套一层 Rectangle 代码冗余。

什么时候应该用 Label 而不是 Text？

Label 是“带主题加持的 Text”，适合以下场景：

• 表单与设置页: 与 Switch、Slider、ComboBox 等 Controls 同风格；
• 徽章/标签效果: 需要背景色、边框或圆角；其实，
• 主题驱动的项目: 使用 Material / Fusion / Universal 等主题。让文字自动跟随，

Text 更轻量。适合纯文本展示或动画效果，不需要背景也不关心主题一致性。

Label 基础用法 & 常见属性解析

演示代码

import QtQuick
import QtQuick.Controls
import QtQuick.Layouts
FadeInAnimation {
ColumnLayout {
anchors.fill: parent
spacing: 10
// 标题分隔符省略...
ColumnLayout {
spacing: 8
Label { text: "Label - 自动继承应用字体" }
Label {
text这方面。"自定义字体大小"
font.pixelSize: 18
}
Label {
再看text，"自定义颜色"
说到color，"#E91E63"
}
Label {
至于text，"粗体 + 斜体"
font.bold: true
font.italic: true
}
}
Item { Layout.fillHeight: true }
}
}

关键点 & 使用者痛点方法

• 字体大小：/,切勿同时设置。话说回来，建议统一使用一种单位。
• 颜色：,与主题冲突时直接覆盖即可。
• 粗体/斜体：/.
• User Pain Point:* 新手往往忘记设置字体单位导致文字失真* -> 在项目模板中统一声明默认单位。

适用场景示例

"使用者名"、“音量”之类的说明文字，用Label; 自动继承 Controls 字体，无需额外配置。

内边距控制——让文字与背景保持舒适距离

import QtQuick
import QtQuick.Controls
import QtQuick.Layouts
FadeInAnimation {
ColumnLayout {
anchors.fill: parent
spacing: 10
ColumnLayout {
spacing:8
// 默认内边距
Label {
text的观点是，"默认内边距"
padding:8
background:
Rectangle { color:"#e8f5e9";border.color:"#66bb6a" }
}
// 自定义四边内边距
Label {
从text来看，"自定义内边距"
padding:{ topPadding:4;bottomPadding:4;leftPadding:12;rightPadding:12 }
background:
Rectangle { color:"#fff3e0";border.color:"#ffb74d" }
}
}
Item { Layout.fillHeight:true }
}
}

主要原因 & 使用者痛点说明

• padding：- 一次性设置四周距离。
• topPadding / bottomPadding / leftPadding / rightPadding：- 单独控制某一侧，可覆盖对应方向的通用值。
• 背景尺寸跟随自动撑开：- 不必手动调整尺寸。
• 使用者痛点：* 随意混合使用会导致视觉不统一* -> 建议先设统一 padding，再按需单独覆盖。

"已完成" 状态标签：上下左右留白让视觉更平衡；若左侧留白多于右侧，可通过单独属性实现。

背景支持 – 给文字添加装饰而无需额外容器

import QtQuick
import QtQuick.Controls
import QtQuick.Layouts
FadeInAnimation {
ColumnLayout{
anchors.fill :parent
spacing :10
// 圆角背景
Label{
至于text。"圆角背景"
padding :6
background :Rectangle{
说到color，"#e3f2fd"
border.color:"#1976D2"
border.width :1
radius :4
}
}
// 渐变背景
Label{
从text来看，"渐变背景"
padding :6
background :Rectangle{
gradient :Gradient{
GradientStop{position:.0;color:"#E91E63"}
GradientStop{position:.7;color:"#9C27B0"} } }
radius :4}
说到color，"white" }
// 阴影模拟
Label{
说到text，"阴影效果"
padding :6
background :Rectangle{
至于color。"white"
border.color:"#ddd"
radius :4
Rectangle{
anchors.fill :parent
anchors.margins :-4
color这方面，"transparent"
border.color:"#e0e0e0"
radius :4
z :-1 }} }
}
Item { Layout.fillHeight:true }
}