截图丢给 AI 生成页面:四道校验让它能进代码库

生成出来的页面视觉挺像,却全是硬编码色值、魔数间距和 div 按钮。补上设计令牌、组件边界、可访问性与性能预算四道校验,才从不能用变成改十分钟能合。

设计给了张活动页的截图,问能不能"直接让 AI 生成"。我试了一版,出来的页面视觉上确实挺像:卡片位置对、按钮颜色对、圆角也差不多。但它进不了代码库。

原因不是丑,是没法维护:颜色全是十六进制硬编码,间距是 margin-top: 13px 这种魔数,一个页面写成一个 600 行的单文件,按钮是 <div onclick>,图片直接引了设计稿里的切图路径。

后来我把流程改了一下:不是"让 AI 生成完就交",而是"给它约束、让它按约束生成、再用清单验"。四道校验加进去之后,同样的任务从"不能用"变成了"改十分钟能合"。

一、给它的第一个输入应该是设计令牌,不是截图

第一版我只给了截图,所以它只能从像素里采样颜色。截图有压缩、有半透明叠加,采出来的颜色和设计稿的变量差了 3–5 个色阶,肉眼看不出来,做主题切换时就会露馅。

现在第一步是把项目的令牌喂给它:

{
  "color": {
    "brand": "#2F6BFF",
    "text-primary": "#1F2329",
    "text-secondary": "#646A73",
    "bg-page": "#F5F6F8",
    "border": "#E5E6EB"
  },
  "space": {"xs": "4px", "sm": "8px", "md": "16px", "lg": "24px", "xl": "32px"},
  "radius": {"sm": "4px", "md": "8px", "lg": "12px"},
  "font": {"body": "14px/22px", "title": "20px/28px"}
}

提示词里明确写死:只能用这些变量,不允许出现新的十六进制色值和任意像素值。截图的作用降级为"布局参考",颜色和间距以令牌为准。

这一条改完,硬编码色值从四十多处降到零。遇到令牌里确实没有的颜色(比如那张插画的底色),让它单独提出来,人工确认后再加进令牌,而不是就地写死。

二、约束组件边界:一个文件一个组件,props 显式

第一版是一个 600 行的单文件,模板里嵌了三层 v-for,数据是写死的数组。这种代码能看不能改。

改成结构化的要求之后,产出质量稳定了很多。提示词里我固定写这几条:

生成 Vue 3 + TypeScript 组件,遵守以下约束:
1. 一个文件一个组件,页面组件只负责组合,不写业务逻辑。
2. props 必须显式声明类型和默认值,禁止使用 any。
3. 列表数据通过 props 传入,组件内部不得写死数组。
4. 样式使用 <style scoped>,颜色和间距只能引用设计令牌变量。
5. 不引入新的第三方依赖,图标使用项目内已有的 Icon 组件。
6. 交互只暴露事件(emit),不在组件内部调用接口。

对应的产出大致是这样:

<script setup lang="ts">
interface ActivityCard {
  id: string
  title: string
  desc: string
  cover: string
}

defineProps<{
  items: ActivityCard[]
  loading?: boolean
}>()

const emit = defineEmits<{ (e: 'select', id: string): void }>()
</script>

<template>
  <section class="activity-list">
    <article
      v-for="item in items"
      :key="item.id"
      class="activity-card"
      role="button"
      tabindex="0"
      @click="emit('select', item.id)"
      @keydown.enter="emit('select', item.id)"
    >
      <h3 class="activity-card__title">{{ item.title }}</h3>
      <p class="activity-card__desc">{{ item.desc }}</p>
    </article>
  </section>
</template>

<style scoped>
.activity-card {
  padding: var(--space-md);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
}
.activity-card__title { font: var(--font-title); color: var(--color-text-primary); }
</style>

"不引入新依赖"这条特别重要。不加约束时,它会为了一个日期格式化装一个库,为了一张占位图引一个 CDN 字体。评审时这些都是要拦的,不如一开始就说清楚。

三、语义和可访问性:div 堆出来的按钮不能用

视觉还原度高,不代表能用。第一版里所有可点区域都是 <div @click>,键盘按不到,读屏软件读不出来,做自动化测试也定位不到。

这一条我写成了硬性检查项,而不是"建议":

检查项 通过标准 常见问题
可点击元素 用 button / a,或补 role + tabindex + 键盘事件 div 加 @click,只能用鼠标
图片替代文本 内容图有 alt,装饰图 alt="" alt 写成文件名
表单控件 有 <label> 或 aria-label 只有 placeholder
标题层级 页面只有一个 h1,层级不跳 卡片标题用 h4 跳过 h3
焦点可见 保留 :focus-visible 样式 全局 outline: none
对比度 正文 ≥ 4.5:1,大字 ≥ 3:1 次要文字用浅灰压到 3:1 以下

我们抽查时发现"对比度"最容易被忽略:截图里看着正常,是因为设计稿用了较大的字号,实现时字号缩小了,同样的灰色就不达标了。用工具量一下最快:

# 用 axe 跑一遍可访问性检查(无头浏览器)
npx @axe-core/cli http://127.0.0.1:5173/activity --exit

有严重级别的问题就退回让它改,别自己手动补 —— 手动补的 aria 往往是错的,比如给已经是 button 的元素再加 role="button"。

四、性能预算:图片和字体是首屏最大的两个坑

生成出来的页面经常直接引用设计稿的切图:一张 2000px 宽的 PNG,八百多 KB,还是首屏图。视觉上没问题,性能上不能接受。

现在我会在提示词里直接给预算,让它按预算写:

性能预算:
- 首屏图片宽度不超过容器 2 倍,使用 srcset 提供 1x/2x。
- 图片必须带 width/height 或 aspect-ratio,避免布局抖动。
- 不使用 web font,沿用系统字体栈。
- 首屏区块不得引入体积超过 50 KB 的第三方脚本。
<img
  :src="item.cover"
  :srcset="`${item.cover}?w=400 1x, ${item.cover}?w=800 2x`"
  :alt="item.title"
  width="400"
  height="240"
  loading="lazy"
/>

width / height 这两个属性不是可选项。缺了它们,图片加载完会推一下布局,直接反映在累计布局偏移这个指标上,而这恰恰是体验评分里最容易被扣分的一项。

五、验收:三张截图加一份清单

AI 生成的页面,人工验收的成本主要在"到底哪里不一样"。我的做法是固定三张截图对比:设计稿、实现、移动端实现,再看一份清单。

# 三个视口各截一张,命名固定,方便和设计稿并排看
npx playwright screenshot --viewport-size=1440,900 http://127.0.0.1:5173/activity shots/activity-desktop.png
npx playwright screenshot --viewport-size=768,1024 http://127.0.0.1:5173/activity shots/activity-tablet.png
npx playwright screenshot --viewport-size=390,844 http://127.0.0.1:5173/activity shots/activity-mobile.png

像素级 diff 在活动页上意义不大(插画、渐变都会有细微差别),我只看三件事:区块顺序、间距节奏、断点行为。前两个对不上说明布局理解错了,第三个对不上说明它只按桌面端写了一版。

清单是固定六条,逐条打勾:

  • 色值只用了令牌变量(grep -nE '#[0-9a-fA-F]{3,6}' src/ 应该零命中);
  • 没有新增依赖(对比 package.json 的 diff);
  • 列表数据来自 props,组件内无写死数组;
  • 可点击元素可用键盘操作;
  • 图片有 alt、有尺寸、首屏图不超过预算;
  • 三个断点下无横向滚动、无文字截断。

grep 那条最省事,也最能说明问题:只要还能搜出硬编码色值,就说明提示词里的约束没被执行,通常意味着它开始"自由发挥",其他几条也要重点看。

六、这套流程的边界

用了两个月,我的结论是:它适合"结构清晰的展示型页面",不适合"交互复杂的业务页面"。

活动页、落地页、空状态、列表卡片,这类页面结构固定、样式为主,AI 生成后改十分钟能合。表单联动、多步流程、复杂状态管理,生成出来的东西看着对,逻辑基本要重写,不如自己写。

另外一个经验是:一次只让它生成一个组件。给一整页截图,它会为了"看起来完整"塞进假数据和占位逻辑,这些都要删。给一个卡片、一个区块,约束清楚,产出干净得多。

小结

  • 输入要先给设计令牌,截图只当布局参考;否则颜色和间距全是采样出来的近似值。
  • 约束必须写死在提示词里:单文件单组件、props 显式、样式 scoped、不引入新依赖。
  • 可访问性是硬性检查项,div 加 @click 一律退回;对比度要用工具量,不能靠看。
  • 图片给 srcset 和尺寸属性,首屏图控制体积,字体沿用系统栈,避免布局抖动。
  • 验收用三张断点截图加六条清单,grep 硬编码色值是最快的自检。
  • 它适合展示型页面,不适合复杂交互;一次只生成一个组件,别整页丢进去。
查看「AI 应用」全部文章 →

同分类文章

查看 0 评论 0

评论

正在加载评论…

留言提交后自动审核:正常内容立即显示,含敏感信息的会转人工复核。