UI 视觉设计 / 系统课时

定位 Figma 与浏览器的样式偏差

定位 Figma 与浏览器的样式偏差

同一个按钮在 Figma 标为 160×48,浏览器却显示 162×50,原因可能是盒模型,也可能是字体、单位、布局或主题变量。这里用固定复现条件、逐层测量和证据记录的方法,把“看起来不一样”变成能定位、能验证的具体问题。

学习目标

  • 统一设计稿和浏览器的视口、主题、文案与字体加载状态。
  • 用 Figma Dev Mode 和 Chrome DevTools 找到尺寸、排版与颜色的实际偏差来源。
  • 区分亚像素渲染差异与 Token 引用错误,留下可复现的修复证据。

先固定可比较的环境

  1. 在 Figma 选中目标 Frame,记录宽高,例如 375×800;Chrome DevTools 用 Ctrl+Shift+M 打开设备工具栏,设为 375×800 CSS 像素,浏览器页面缩放保持 100%。另外记录 devicePixelRatio,不要把设备物理像素当成 CSS 像素。
  2. 对齐组件的文案、语言、变体、交互状态和主题 Mode,例如 Button / Medium / Default / Light。先关闭可能改变几何尺寸的动画,固定滚动位置。
  3. 浏览器字体加载完成后再截图。若 Figma 用的是 Inter,而浏览器发生 Arial 回退,文字宽度、换行和 Auto Layout 的 Hug 尺寸都会变,不能直接把宽度差判成间距错误。

先看父容器是否同宽,再看子组件。若设计 Frame 为 375px,而网页正文因滚动条或页面内边距只有 359px,后续比较组件的 Fill 宽度没有意义。

按字体、单位和布局逐层排查

  1. 字体:Figma Dev Mode 选中文字层,在右侧 Inspect 的 Typography 查看字体、字重、字号、行高和字距;Chrome 在 Elements → Computed → Rendered Fonts 检查真正使用的字库。比如设计为 Inter、16px / 24px / 600,浏览器虽然声明 Inter,却实际使用其他字体,先修复字体资源。
  2. 单位:对照 html 的计算后 font-size。设计间距 16px,代码写 1rem,只有根字号为 16px 才相等;如果根字号为 18px,实际间距就是 18px。em 还要看所在元素的字体大小。
  3. 布局:检查父级 display、gap、padding、子项的 flex、min-width,并和 Figma Auto Layout 的 Hug、Fill、间距逐项核对。例如设计间隔 8px,浏览器父级计算为 gap: 10px,应修改布局来源,而不是给单个子项加负边距。
  4. 盒模型:假设按钮没有内边距,声明 width: 160px; height: 48px,四边有 1px 边框,box-sizing: content-box 会让外框变为 162×50。改为 border-box 后,声明宽高才包含边框,外框恢复 160×48。

Figma 与浏览器样式偏差的五层诊断关卡

在 DevTools 读取计算值和实际外框

在 Chrome 的 Elements 中选中偏差元素,再切到 Console 执行以下完整示例;$0 是 DevTools 当前选中的 DOM 元素,不适用于普通网页脚本。把 --color-action-primary 换成项目实际的 CSS 变量名。

js
(async (el) => {
  if (!(el instanceof Element)) throw new Error("请先在 Elements 中选中元素");
  await document.fonts.ready; // 避免在 Web 字体仍加载时记录临时布局

  const css = getComputedStyle(el);
  const rect = el.getBoundingClientRect();
  const parent = el.parentElement ? getComputedStyle(el.parentElement) : null;
  const root = getComputedStyle(document.documentElement);

  console.table({
    widthPx: Number(rect.width.toFixed(2)),
    heightPx: Number(rect.height.toFixed(2)),
    fontFamily: css.fontFamily,
    fontSize: css.fontSize,
    fontWeight: css.fontWeight,
    lineHeight: css.lineHeight,
    boxSizing: css.boxSizing,
    padding: css.padding,
    parentGap: parent?.gap ?? "(无父元素)",
    rootFontSize: root.fontSize,
    background: css.backgroundColor,
    actionToken: css.getPropertyValue("--color-action-primary").trim() || "(未定义)",
    transform: css.transform,
    dpr: window.devicePixelRatio
  });
})($0);

预期结果:Console 出现一张以属性名为行的表。下面仅示意部分字段,尖括号表示当前页面的实测值,不是固定输出。

text
(index)        Values
widthPx        <实际外框宽度>
heightPx       <实际外框高度>
boxSizing      <content-box 或 border-box>
rootFontSize   <实际根字号>
actionToken    <解析后的颜色值或(未定义)>

getBoundingClientRect() 读取的是包括内边距和边框的外框,并保留小数;如果存在 transform: scale(...),它还会反映缩放后的尺寸。排查父容器间距时,改选父节点重复执行,不要拿子项的 gap 判断父级布局。

分清亚像素与 Token 错配

当 479px 宽容器等分三列、没有列间距时,每列是约 159.67 CSS px。浏览器可能在设备像素栅格上分配和抗锯齿处理边缘;devicePixelRatio=2 意味着 1 CSS px 对应约 2 个物理像素。若计算值和设计约束一致,只是截图边缘出现局部 1px 色差,应先统一系统、缩放和 DPR,不要随意将尺寸取整。相反,若 rect.width 持续偏离设计值,应回查布局或 transform。

颜色先核对模式和引用链:Figma Dev Mode 的变量详情应能查到 Light → semantic.action.primary → palette.blue600 → #2563EB 这类路径;Chrome Elements → Styles 中检查 var(...) 的来源、层叠覆盖及最终 background-color。浏览器 rgb(37, 99, 235) 与 #2563EB 相同,不能仅因展示格式不同就报错;若实际解析成 #60A5FA,再查错误 Mode、别名或覆盖规则。变量名和映射路径以项目实际定义为准。

用复现记录关闭偏差

证据项 示例记录
设计定位 Button / Medium / Default / Light,Frame 375×800
浏览器条件 Chrome,375×800 CSS px,缩放100%,DPR=2
设计值 外框160×48;Inter 16/24;背景#2563EB
实测值 外框162×50;字体吻合;背景rgb(37, 99, 235)
根因 content-box 下四边各有1px边框,外框多2px
修复与验证 设置 box-sizing: border-box;复测外框160×48

把 Figma 层节点、网页路由、代码提交版本、截图及 Console 结果与记录放在一起。修复后在同一条件重新测量:本例的尺寸应恢复为 160×48,颜色归一化后应相同;对于仅发生在文字边缘的抗锯齿差异,单独记录设备与截图环境,不要修改已正确映射的 Token。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位 Figma 与浏览器的样式偏差

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通