截图丢给 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硬编码色值是最快的自检。 - 它适合展示型页面,不适合复杂交互;一次只生成一个组件,别整页丢进去。
正在加载评论…