前端架构与高审美 UI 实战
为什么 AI 默认生成的网页一眼看上去像“玩具 Demo”?因为你没有给它设定设计系统(Design Tokens)、留白节奏与异常状态覆盖要求。
1. 告别“AI 廉价模板感”的四条视觉铁律
- 60-30-10 配色法则:60% 留给干净的白底或极浅灰蓝底(
#F6F9FF),30% 留给纯白卡片与柔和边框(#DBEAFE),只有 10% 的主按钮、激活态和数字亮点使用高饱和科技蓝(#2563EB)。 - 控制每屏信息层级:一张卡片里不要堆 8 个五颜六色的徽章。坚持“1 个大标题 + 1 句核心摘要 + 最多 2 个轻量元数据标签”。
- 8px 空间网格系统:要求 AI 所有间距严格使用
4px / 8px / 12px / 16px / 24px / 32px的倍数,卡片之间对齐立刻就会显得高级。 - 克制且流畅的微动效:悬停卡片轻抬
translateY(-3px)、按钮平滑过渡0.2s、列表随滚动渐入;不要做满屏乱飞的炫光动画。
2. 必须强迫 AI 补齐的 5 种界面状态
很多人在验收前端时只看“正常有数据”那一刻,结果一上线遇到空库或断网直接白屏。任何列表/表单页都必须检查这 5 态:
| 状态 | 常见缺失问题 | 标准实现要求 |
|---|---|---|
| Loading(加载中) | 白屏闪烁或按钮无反应,用户连点 5 次重复提交 | 骨架屏占位;提交按钮显示转圈并设为 disabled |
| Empty(空数据) | 页面一片空白,新手不知道接下来干啥 | 显示温和引导文案 + 一个明显的“+ 立即创建第一条”按钮 |
| Error(接口失败) | 静默失败或页面崩溃,只 Console 报错 | 友好提示具体可理解的原因 + 提供“点击重试”按钮 |
| Validation(校验) | 没填完点提交直接发出请求然后报 500 | 前端即时高亮错误字段,如“请输入合法的 https:// 网址” |
| Mobile(窄屏适配) | 手机端表格撑破屏幕出现横向滚动条 | 表格包一层 overflow-x: auto,侧边栏自动收进抽屉菜单 |
3. 统一前端请求封装模板(src/lib/api.ts)
不要让 AI 在每个组件里到处手写 fetch('/api/...'),强制抽成一个统一请求函数:
export class ApiError extends Error {
constructor(public status: number, message: string) {
super(message);
}
}
export async function apiFetch<T>(path: string, init?: RequestInit): Promise<T> {
const res = await fetch(path, {
credentials: 'include',
headers: { 'Content-Type': 'application/json', ...(init?.headers || {}) },
...init,
});
const json = await res.json().catch(() => ({}));
if (!res.ok || (typeof json.code === 'number' && json.code !== 0)) {
throw new ApiError(res.status, json.message || `请求失败 (${res.status})`);
}
return (json.data !== undefined ? json.data : json) as T;
}
4. 组件拆分的红线:什么时候必须拆?
- 只要一个
Page.tsx超过 250 行,立刻让 AI 把弹窗、筛选栏、列表卡片拆到components/子目录。 - 纯展示组件(Props 进、JSX 出)与包含
fetch状态管理的容器组件分开,以后改样式才不会把数据逻辑弄坏。