VibeCraft Vibe Coding 实战指南
UI 设计规范 组件解耦 全状态交互

前端架构与高审美 UI 实战

为什么 AI 默认生成的网页一眼看上去像“玩具 Demo”?因为你没有给它设定设计系统(Design Tokens)、留白节奏与异常状态覆盖要求。

1. 告别“AI 廉价模板感”的四条视觉铁律

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. 组件拆分的红线:什么时候必须拆?