上个月我在做一个数据看板项目，里面有一堆统计卡片，每张卡片都是自定义 QWidget，内部用 QPainter 画背景、画图标区、画标题和副标题。做联调的时候，产品对着截图说了一句让我血压升高的话：“这个卡片左边的图标和标题，间距为什么和右边卡片不一样？”我去翻了代码，发现三处文字绘制分别硬编码了left + 10、left + 12、x + 15，三个顺手写的数字，结果就是对不齐。当时我就意识到，这种散落的边距常量必须收口到一个统一的数据结构里，而 Qt 早就给了答案——QMargins。
这篇东西不是 API 手册式罗列，而是围绕QMargins在实际工程里的用法写的。我会从那次事故讲起，把构造、运算、与QRect/QPainter/QStyle/ 布局系统的配合、高 DPI 下的精度陷阱、以及样式表里margin与padding的混淆点，全部拆开讲清楚。适合正在做 Qt 桌面端、刚接触自定义控件、或者被边距整到头疼的人看。
1. 一次"边距灾难"之后：QMargins 在我的工程里是这么用的
1.1 事故复盘：一张卡片的三处边距为什么对不齐
先还原一下当时的现场。卡片结构很简单：左侧一个图标，右边竖排两行文字。绘制时代码大概是这样的：
// 片段 A：图标 painter->drawPixmap(QRect(rect.left() + 10, rect.top() + 10, 32, 32), icon); // 片段 B：标题 painter->drawText(QPoint(rect.left() + 12, rect.top() + 32), title); // 片段 C：副标题 QFontMetrics fm(font); painter->drawText(QPoint(rect.left() + 15, rect.top() + 58), subtitle);一眼看过去好像都差不多，但人眼对 1~3 像素的偏差非常敏感，尤其当多张卡片并排时，标题的文本基线左侧起点不一致，整体就呈现出一条歪歪扭扭的“锯齿感”。我排查的时候，先怀疑是字体不同导致的FontMetrics差异，查了一圈发现不是；后来把三处数字统一打印出来，才发现是三个散落的魔法值在搞鬼。
修复方式很朴素：定义一张卡片统一的边距常量，然后所有绘制都基于这个常量计算。
static const QMargins kCardMargin(12, 12, 12, 12); QRect iconRect = rect.marginsRemoved(kCardMargin); QRect titleRect = iconRect.adjusted(36, 0, 0, 0); // 跳过图标区域这样图标和文字就有了同一个出处。哪怕产品说“左边再往内收 4 像素”，我也只需要改一个QMargins构造参数，而不是用编辑器搜索所有left + 数字的写法。这个教训我记到现在：凡是“四边留白”语义的东西，都应该先想到 QMargins，而不是 int。
1.2 QMargins 的本质：四个整数背后的边界语义
QMargins本质上是一个极其轻量的值类型，内部就是四个int：left、top、right、bottom。它解决的问题非常具体：描述一个矩形内部四边分别向里让出多少空间。
你可能会问：直接写QRect adjusted(4, 4, 4, 4)不也行吗？行，但语义是扭曲的。QRect::adjusted的前两个参数是左上角偏移，后两个参数是右下角偏移，把adjusted(-4, -4, 4, 4)用来表达“四边向内收 4 像素”可读性很差，而且上下左右对称时还好，一旦出现left=8, right=4这类不对称场景，靠手写矩形偏移很容易写反。
QMargins的价值就在于把“四边各自留白”这个独立概念从矩形里分离出来。配合QRect::marginsRemoved，写法变成一句语义明确的调用：
QRect contentRect = widgetRect.marginsRemoved(QMargins(8, 4, 12, 8));不再需要去思考right到底是正数还是负数，marginsRemoved内部已经处理好了方向。工程里我通常把按钮、卡片、输入框、列表项的边距统一放到一组常量里，形成一个“间距规范”。比如：
namespace UiSpacing { const QMargins CardMargin(12, 12, 12, 12); const QMargins ButtonMargin(8, 6, 8, 6); const QMargins InputPadding(6, 6, 6, 6); }这样设计的好处是，后续换肤、紧凑模式、高 DPI 适配，只需要改这一处。QMargins的职责边界也清晰：它只描述边距数据，不负责布局，真正的空间计算发生在QLayout、QRect、QPainter这些消费方手里。
2. 构造、取值、运算：把 QMargins API 用出花来
2.1 默认构造与 isNull：判断"没设置边距"的正确姿势
QMargins的默认构造函数会生成所有边距都为 0 的对象，等价于“没有边距”。这一点和QRect不太一样，QRect默认构造是一个isNull为真的无效矩形，而QMargins默认构造是一个四边均为 0 的合法对象。
QMargins m; // m.left() == 0, m.top() == 0 ... bool empty = m.isNull(); // true在写通用绘制函数时，isNull()特别有用。比如一个函数接收QMargins参数，如果调用方传了一个默认构造对象，你就可以直接跳过内缩处理，走原来的整体绘制逻辑，避免产生不必要的QRect变化：
void paintPanel(QPainter *painter, const QRect &rect, const QMargins &m) { QRect content = m.isNull() ? rect : rect.marginsRemoved(m); // ... }如果你要判断的是“某个方向是否完全不设边距”，可以直接比较m.left() == 0 && m.right() == 0，但很少有这样的需求。日常开发中，isNull()已经是“是否需要处理边距”的最简表达。
取值方面，四个访问器没有太多可说，重点是setLeft/setTop/setRight/setBottom是单独可改的。这意味着你可以在运行时动态调整某一个方向的边距，实现类似“拖拽边缘之后左边距变大”的效果。但注意：QMargins是值类型，setLeft()直接修改当前对象，函数签名不是 const。
2.2 加法减法与缩放：警惕 += 在链式修改里的副作用
QMargins重载了不少运算符：+、-、*、/，并且标量乘法同时作用于四个方向。最常用的场景是整体缩放边距。以前我做平板适配时，把桌面端的一套边距乘以一个系数，一行代码就把所有边距放大了：
QMargins scaled = baseMargins * 1.25; // 不支持，QMargins 乘的是整数注意这里有个陷阱：QMargins的乘法运算要求标量是int，不能直接乘qreal。从 Qt 5.14 开始，QMargins提供了operator*(qreal)的重载，但返回值还是经过舍入的QMargins。如果你在写需要精确浮点中间态的高 DPI 代码，最好用QMarginsF，不要用QMargins去做小数乘法。
加减运算也很有意思。两个QMargins相加是逐边相加：
QMargins a(4, 8, 4, 8); QMargins b(2, 2, 4, 4); QMargins c = a + b; // left=6, top=10, right=8, bottom=12我常把它用于“基础边距 + 额外强调边距”的组合。比如一个控件，普通状态用CardMargin，选中状态需要在右侧额外留 4 像素给选中指示条，那么：
QMargins effectiveMargin = UiSpacing::CardMargin + QMargins(0, 0, 4, 0);比重新构造一个新的QMargins更不容易出错。同理，-=可以用于实现“收缩边距”的动画过渡。
不过要提醒一句：+=和-=是就地修改。如果你在共享常量的地方调用margin += something，很可能误改了别的模块引用的同一个对象。所以在多线程或跨组件共享边距配置时，优先写newMargin = baseMargin + deltaMargin，不要贪图+=的方便。
2.3 转置、浮点转换与序列化：不常用但关键的时刻
QMargins还有一个容易被忽略的方法transposed()，它交换水平和垂直方向的边距值：left和top互换，right和bottom互换。说实话日常用得不多，但遇到横竖屏切换类 UI 时非常顺手。比如一个横向排布的工具栏，边距是(4, 12, 4, 12)，切到纵向后，你希望占用的空间跟着旋转，直接：
QMargins verticalMargin = margin.transposed();比手写四个参数直观得多。
如果要在浮点精度下工作，就用QMarginsF，它内部存的是qreal，构造方式几乎一样，自带toMargins()可以把浮点边距舍入成整数。不过要小心，toMargins()用的是四舍五入，不是向上取整。后面高 DPI 部分我再展开说这个坑。
最后，如果项目里需要把边距配置写入 QSettings 或通过网络传输，QMargins支持通过QDataStream进行序列化：
QDataStream out(&byteArray, QIODevice::WriteOnly); out << margin;operator<<和operator>>都是现成的。把一组 UI 间距方案存成字节，到其他端恢复后就能直接复用，在多端联调时很方便。但如果你希望配置文件是人类可读的 JSON，那还是自己把四个 int 展开存储更省事。
3. 和 QRect、QPainter、QStyle 协同：边距真正落到界面上的三个战场
3.1 用 marginsRemoved 圈定"安全绘制区"
QRect::marginsRemoved是我在自绘控件里用得最多的一个函数。它的作用简单说就是：把矩形四边向内收缩，返回一个新的矩形区域。例如，你要在一张 400x200 的卡片内，距四边各留 12 像素，画出标题区，就可以这么写：
QRect contentArea = rect.marginsRemoved(QMargins(12, 12, 12, 12));然后基于contentArea继续切分内部布局区域。这个函数还会自动处理负边距和过大的边距：如果边距大于矩形自身尺寸，结果矩形可能变成负宽高，但不会崩溃。在写绘制代码前，我习惯加一个保护：
QRect content = rect.marginsRemoved(margin); if (content.width() <= 0 || content.height() <= 0) return;绘制越界区域没有意义，提前返回也能避免后续QPainter::drawText在无效区域做出奇怪的裁剪。
另一个值得掌握的是marginsAdded，它是marginsRemoved的逆操作，向四边扩张。这个一般少用，但当你需要为一个已有内容的矩形额外留一圈“呼吸区”，比如给文字背景增加内边距时，会很有用。
QRect textRect = painter->boundingRect(QRect(0, 0, 100, 100), Qt::TextWordWrap, text); QRect boxRect = textRect.marginsAdded(QMargins(8, 4, 8, 4)); // 文字周围包一圈背景这里painter->boundingRect()只负责测量文本占据的最小矩形，真正绘制圆角背景需要向外扩张，就靠marginsAdded。
3.2 QStyle 与 styleOption 场景：让自绘控件和系统风格对齐
在一个真正好看的 Qt 应用里，控件绘制通常不是自己从零画，而是委托给QStyle。QStyle 在计算内容区域时，经常用到QStyleOption中的rect和QStyle::subElementRect。比如你要自绘一个复选按钮，希望内容绘制在系统的“内部矩形”内，而不是整个widget->rect()内。
3.3 布局管理里的 setContentsMargins：panel 与子控件的呼吸空间
布局管理器里的margin概念和QMargins的“四边留白”语义直接对齐。QLayout::setContentsMargins有若干重载，接受四个 int 或一个QMargins。下图这种界面：外层 QVBoxLayout 作为卡片容器，内部放标题 QLabel 和正文 QTextEdit，如果不设置contentsMargins，子控件会直接贴边，非常难看。
上面 3.2 的内容还没写完，并且我要补全 3.2 和 3.3。继续写。由于这是输出成文，尽量让内容完整。我现在接着继续书写。 我在3.2中写了开头，下一步补一个示例：`QStyle::subElementRect(SE_CheckBoxContents, &opt, widget)` 返回内容矩形，我们在此基础上减少自定义图标需要的边距，或者组合 QMargins。然后讲 QStyleOption 中的 rect 已经被设置为 widget->rect，但要注意样式计算出的 subElementRect 是全局坐标；使用时结合 local 转换。最好真实、不复杂。然后讲一个例子：用 QStyle 画出边框，再用 style 矩形减去 margin 绘制内容。 3.3 布局管理器部分讲 setContentsMargins 与 setSpacing 的关系、margins 周围空白、控件之间 spacing；以及 `getContentsMargins` 取回；以及需要注意：设置在 QGroupBox 上时，margins 不是“外边框到子控件距离”，其实，QGroupBox 内部的 QVBoxLayout 的 contentsMargins 决定标题和内容的位置。还有在对 QWidget 本身 setLayout 时，layout 的 setContentsMargins 负责 child widgets 与 parent widget 之间的距离。 现在把全文接起来。 注意 3.2 和 3.3 之间连贯。格式化。 继续。 然后第4章、第5章、第6章都要写完整。 我开始写。 最终我会输出完整博文，符合所有要求。确保没有无用元信息。现在我把自己生成的草稿完善，最终输出。</think>## 3. 和 QRect、QPainter、QStyle 协同：边距真正落到界面上的三个战场 ### 3.1 用 marginsRemoved 圈定"安全绘制区" `QRect::marginsRemoved` 是我在自绘控件里用得最多的一个函数。它的作用简单说就是：把矩形四边向内收缩，返回一个新的矩形区域。例如，你要在一张 400x200 的卡片内，距四边各留 12 像素，画出标题区，就可以这么写： ```cpp QRect contentArea = rect.marginsRemoved(QMargins(12, 12, 12, 12));然后基于contentArea继续切分内部布局区域。这个函数还会自动处理负边距和过大的边距：如果边距大于矩形自身尺寸，结果矩形可能变成负宽高，但不会崩溃。在写绘制代码前，我习惯加一个保护：
QRect content = rect.marginsRemoved(margin); if (content.width() <= 0 || content.height() <= 0) return;绘制越界区域没有意义，提前返回也能避免后续QPainter::drawText在无效区域做出奇怪的裁剪。
另一个值得掌握的是marginsAdded，它是marginsRemoved的逆操作，向四边扩张。这个一般少用，但当你需要为一个已有内容的矩形额外留一圈“呼吸区”，比如给文字背景增加内边距时，会很有用。
QRect textRect = painter->boundingRect(QRect(0, 0, 100, 100), Qt::TextWordWrap, text); QRect boxRect = textRect.marginsAdded(QMargins(8, 4, 8, 4)); // 文字周围包一圈背景这里painter->boundingRect()只负责测量文本占据的最小矩形，真正绘制圆角背景需要向外扩张，就靠marginsAdded。
3.2 QStyle 与 styleOption 场景：让自绘控件和系统风格对齐
在一个真正好看的 Qt 应用里，控件绘制通常不是自己从零画，而是委托给QStyle。QStyle 在计算内容区域时，经常用到QStyleOption中的rect和QStyle::subElementRect。比如你要自绘一个复选按钮，希望内容绘制在系统的“内部矩形”内，而不是整个widget->rect()内。
我自己的经验是：先用系统的subElementRect拿到内容矩形，再用QMargins对“内部再留白”做二次调整。举个例子，自绘一个带图标的按钮时：
QStyleOptionButton opt; initStyleOption(&opt); QRect iconRect = style()->subElementRect(SE_CheckBoxContents, &opt, this); // 系统算好的内容矩形，全局坐标 QRect safeRect = iconRect.marginsRemoved(QMargins(2, 2, 2, 2)); painter->drawPixmap(safeRect.topLeft() + QPoint((safeRect.width() - icon.width()) / 2, (safeRect.height() - icon.height()) / 2), icon);这里如果不先用subElementRect，而是直接使用widget->rect()，那么在不同系统主题、不同 DPI 下，图标和文字位置都会有偏差，因为系统样式本身可能给按钮内置了边框宽度和 padding。QMargins在这里不是替代 QStyle，而是作为 QStyle 输出结果与最终绘制之间的“微调层”。
还有一点要记住：subElementRect返回的是全局坐标。在paintEvent里，painter默认已经平移到了控件自身坐标，所以如果你直接拿返回的矩形去绘制，会发现位置偏了。一般做法是先用rect()得到控件本地矩形，再转成QStyleOption的rect，计算完子区域之后再减掉widget->pos()，或者干脆在初始化QStyleOption时就把它放到(0, 0)的本地坐标。这块细节很多人会踩，但不属于 QMargins 本身的问题，这里提一句防止你被样式计算的结果搞晕。
3.3 布局管理里的 setContentsMargins：panel 与子控件的呼吸空间
布局管理器里的 “margin” 概念和 QMargins 的“四边留白”语义直接对齐。QLayout::setContentsMargins有若干重载，接受四个 int 或一个QMargins。一个常见场景：外层QVBoxLayout作为卡片容器，内部放标题QLabel和正文QTextEdit，如果不设置contentsMargins，子控件会直接贴边，非常难看。
QVBoxLayout *layout = new QVBoxLayout(cardWidget); layout->setContentsMargins(UiSpacing::CardMargin); layout->setSpacing(8); layout->addWidget(titleLabel); layout->addWidget(contentEdit);这里setContentsMargins控制的是“父容器内壁”到“最外侧子控件”之间的距离，而setSpacing控制的是两个子控件之间的距离。很多人刚开始会把这两个概念混在一起，以为设置一个就够了。实际调试时，如果两个控件之间空隙不对劲，先看spacing；如果控件距离容器边框太近，先看contentsMargins。
有一个小技巧：在用QGroupBox时，它的标题本身会占一块地方，如果你希望在标题和内容之间留出额外空间，光设置内部 layout 的contentsMargins可能不够。这时可以在setContentsMargins的基础上再手动给顶部更大的top，或者直接放置一个高度固定的空白控件。我的习惯是给QGroupBox内部 layout 设置为：
groupLayout->setContentsMargins(12, 16, 12, 12);顶部多出来的16是为了让标题行和第一行内容之间保持距离，12是四周的基本呼吸区。这个数字组合不是乱定的，我会用后面说的边距可视化方法一点点调。
4. 高 DPI 与缩放场景：整数边距的精度陷阱和 QMarginsF 救场
4.1 设备无关像素与物理像素之间的数学
Qt 从 5.6 开始引入高 DPI 支持，到 Qt 6 已经默认开启缩放。逻辑坐标下的 1 个单位在 2x 屏幕上代表 2 个物理像素，这个比例就是devicePixelRatio。在这个前提下，QMargins内部存int的缺陷就暴露了：当你需要在1.25x或1.5x屏幕上处理边距时，整数运算会出现不可忽略的偏差。
举个例子，你定义了一个逻辑边距QMargins(9, 9, 9, 9)，在1.5x屏幕上实际需要的是13.5物理像素，但整数QMargins只能表示13或14。一次两次不明显，但几层控件叠加后，左右边缘可能出现 0.5 到 1.5 像素的错位，文字和边框之间的留白看起来就会一边宽一边窄。
4.2 缩放时边距该舍还是该入
解决方式是用QMarginsF保存浮点中间值，到了真正绘制阶段再决定舍入策略。比如在 paintEvent 里：
QMarginsF logicalMargin = baseMarginF * dpr; QMargins roundMargin(logicalMargin.left(), logicalMargin.top(), logicalMargin.right(), logicalMargin.bottom());这里如果直接toMargins()，Qt 内部用的是四舍五入。对于视觉设计稿来说，我更倾向于对外侧边距使用向上取整，内侧内容边距使用向下取整，这样内容不会被“吃”掉。具体写法：
QMargins outerMargin = QMargins(qCeil(logicalMargin.left()), qCeil(logicalMargin.top()), qCeil(logicalMargin.right()), qCeil(logicalMargin.bottom()));在真正写代码前，最好先确认产品对像素精度的要求，通常 UI 设计稿的边距精确到逻辑像素就够了，但如果你做的是一像素边框、分隔线、进度条这种边缘敏感控件，就一定要把QMarginsF和手工舍入考虑进去。
4.3 我的高 DPI 适配清单
总结一下我在项目里沉淀下来的高 DPI 边距适配规则：
- 配置文件、资源文件里尽量存逻辑边距，不存物理像素边距；
- 凡是运行时需要和
devicePixelRatio相乘的边距，一律先用QMarginsF承载； - 绘制用到矩形边界的，优先四舍五入到最近像素；绘制文本基线、图标这类对偏差敏感的，优先向上/向下取整保持一致；
- 不要在 paintEvent 里多次做
QMarginsF -> QMargins转换，提前算好并缓存，避免每帧重复计算； - 如果控件支持
devicePixelRatio变化（比如窗口从 1x 屏拖到 2x 屏），监听screenChanged事件并重新缓存边距。
这条清单是我踩过几次坑之后总结的。最典型的例子是一个绘图程序里，缩放比例一变，四周边距在1.5x屏幕上出现锯齿，排查了整整半天才发现是QMargins的整数乘法先于屏幕缩放执行导致的累计误差。
5. QSS 里 margin 与 padding 的语义区分：一次样式排查的记录
5.1 Qt 样式表的盒模型与 margin 支持范围
Qt 样式表（QSS）的盒模型和 CSS 一样：margin是控件外部间距，padding是内容到边框的距离。但很多人会遇到一个诡异的现象：给QPushButton设置margin: 10px;，发现按钮的位置和大小并没有如预期变化。
这背后的原因不复杂。QSS 在解析时会把 margin 写入样式表体系，但实际绘制原生外观的控件（QPushButton、QComboBox等）时，QStyle 才是真正的绘制方，而 QStyle 会优先遵循系统原生规则。也就是说，样式表里的margin对布局的影响非常有限，它更多作用于自定义绘制控件，或者在样式表改变了控件边框和背景后才生效。
与之相对，padding在 Qt 样式表中的表现通常更可靠，它会直接影响内部内容矩形的位置。所以我在做样式配置时，会把 QSS 的padding当作“内边距”，把布局系统的contentsMargins当作“外边距”，尽量不依赖 QSS 的margin去控制组件间距。
5.2 排查流程：从 QSS 到实际布局的对照
有一次，我帮同事排查一个QLabel在窗口里位置偏下 3 像素的问题。检查了半天，发现是该QLabel的样式表里写了：
QLabel#title { margin-top: 3px; background-color: #f0f0f0; }因为 QLabel 是QWidget子类，当设置了背景色之后，Qt 样式表开始接管它的绘制，margin-top会影响内部内容矩形，所以文本就整体向下偏了 3 像素。解决方案很简单，把margin-top改成padding-top，再配合布局的contentsMargins统一控制间距。
排查 QSS 边距问题的通用流程，我是这样做的：
- 先给目标控件设置一个高对比度的边框，例如
border: 1px solid red;，这样可以肉眼看到控件的实际盒子范围； - 再临时去掉
margin，观察控件位置是否发生变化；如果没变化，说明 margin 根本没参与布局； - 把间距控制转移到父容器的
QMargins或子控件的padding，逐步逼近最终效果； - 全部调完后再删掉临时边框，恢复正常样式。
5.3 自定义控件使用 QSS margin 的正确姿势
如果你确实希望QSS中的margin对自定义控件生效，最稳的方式是让控件自身读取样式表数据，然后把它作为绘制边距的一部分。一个简单做法是通过styleSheet()或动态属性传递，但更常见的是仅把 QSS 用于视觉层，把间距逻辑仍然留在代码里。
我实际项目里有一个CardWidget，它的 QSS 只定义了边框、背景、圆角，四个方向的留白完全由paintEvent里的QMargins常量控制：
void CardWidget::paintEvent(QPaintEvent *event) { Q_UNUSED(event); QPainter painter(this); painter.setRenderHint(QPainter::Antialiasing); painter.setPen(Qt::NoPen); painter.setBrush(backgroundColor()); painter.drawRoundedRect(rect().marginsRemoved(m_margin), m_radius, m_radius); }这样 QSS 负责“好不好看”，QMargins负责“距离对不对”，两者各管一摊，不容易打架。
6. 我在实际工程里沉淀的边距排查经验和工具箱
6.1 边距错误高发的四个"重灾区"
做完几个项目后，我发现QMargins相关的 bug 高度集中在四个地方。
第一个是margin和spacing混淆。layout->setContentsMargins调整的是布局四边与子控件边缘的距离，layout->setSpacing调整的是子控件互相之间的间隔。如果你发现两个控件贴在一起，第一反应应该是查spacing，而不是给单个控件加 margin。
第二个是对同一个layout多次调用setContentsMargins。代码复用多了以后，初始化布局时设置一次，后续某个函数为了“临时调整”又覆盖一次，结果把之前的配置冲掉了。我现在的习惯是，凡是需要动态改边距的地方，都基于初始值再叠加，而不是重新传一套硬编码。
第三个是自定义控件里硬编码四个方向的边距，且不随 DPI 和字体变化。字体变大时，文字会溢出 padding 区域。遇到这类问题，我统一改用“测量内容 + marginsRemoved/marginsAdded”的模式，先量内容矩形，再计算留白。
第四个是把 QSS 的 margin 当成万能间距工具。前面已经说过了，Qt 样式表的 margin 并不能在所有控件上稳定生效，在跨平台项目中尤其不要依赖它做关键间距。
6.2 调试技巧：边距可视化与临时标记
定位边距问题时，我强烈建议先把“边距本身”可视化。最直接的办法是在paintEvent里绘制临时调试矩形：
void DebugWidget::paintEvent(QPaintEvent *event) { QWidget::paintEvent(event); QPainter painter(this); painter.setPen(QPen(Qt::red, 1)); painter.setBrush(Qt::NoBrush); painter.drawRect(rect().marginsRemoved(m_margin)); }这个红色矩形会标出“去掉边距后的内容区域”。如果内容绘制超界，一眼就能看出来。另一个常用技巧是往日志里打印矩形信息：
qDebug() << "widget rect:" << rect() << "content rect:" << rect().marginsRemoved(m_margin);在复杂布局里，我还会给每个关键控件打印layout->contentsMargins()和layout->spacing()，把布局系统的数据和视觉表现对应起来。靠肉眼猜，不如靠数据判。
6.3 把边距当作数据结构来管理
我现在写新的 Qt 控件时，已经不会随手写left + 10这种散装代码了。所有边距都收敛到QMargins，并且尽量以const常量方式放在统一定义里。为了在多个工程里复用，我甚至会把这些常量打包成一个小模块，类似“间距令牌”，客户端拿到令牌就能还原出一致的排版。
这套思路带来的最大收益不是少写几个数字，而是让“间距”成为一个可以被搜索、被比较、被测试的数据结构。你可以在单元测试里断言边距是否符合设计规范：
QCOMPARE(UiSpacing::CardMargin.left(), 12); QCOMPARE(UiSpacing::CardMargin.top(), 12);甚至在界面验收时写脚本读配置，和设计稿逐项比对。真正把QMargins用好的项目，视觉一致性会明显好过随手写像素值的项目，而且改起来风险小很多。
最后再分享一个我在实际使用中的体会：边距不是越统一越好，也不是越自由越好。建议把常用边距收敛成几档，比如紧凑档4px、标准档8px、宽松档16px，然后在这些档位基础上用QMargins组合，避免出现几十个不同的魔法数字。这样即使以后要整体调整疏密程度，也只需要改那几档的基准值，所有界面跟着变。
