这篇文章适合所有正在用 AI 写代码但被逼疯过的人。

你将看到：

AI 为什么写出一堆看不懂的屎山
怎么让 AI 按你的节奏写项目
一个可直接使用的“项目起步模板”
用 AI 编程最关键的边界
两个能立刻用的提示词

读完之后，你就能：

让 AI 成为助理，而不是“随机发疯的外包”。

一、为什么 AI 写出来的项目总是乱七八糟？

很多人都有这种体验：

把需求丢给 AI，生成的代码乍一看还行，再看就开始冒漏洞。于是你不断让它改，AI 也确实改，可改完又冒新的 bug。

最气的是：

你看不懂这段代码，只能当苦力给它喂日志。

这并不是你不够强，也不是 AI 不够强，而是你们处在两个不同的维度。

1. 你和 AI 的混乱忍耐度不一样

你需要结构、顺序、层次，才能把项目管理住。
AI 不需要，它一秒钟能读完整个项目，不在乎你的目录乱、逻辑散、样式挤在一起。

对你来说是“混乱”，

对 AI 来说是“没事，我能 handle”。

2. 需求永远存在语义模糊

再清楚的需求，也会在大范围生成时产生偏差。

AI 并不是“理解”你的需求，而是在“猜你的需求”。

猜着猜着就偏了。

当它一旦偏，你不知道怎么救；

当你描述不清，它也不知道你在说什么。

于是双方都在黑箱里乱撞。

二、那要如何用 AI 写一个完整项目？

解决方案只有一个：

把 AI 的自由度砍掉，把粒度分到足够小。

不是“一次一个模块”，

不是“一次一个页面”，

而是：

一个函数
一个对象
一个接口
一个组件片段
一个 UI 区域

你负责架构，AI 负责填空。

你的角色变成了：

拆问题
定输入输出
给结构
控制范围
管理变更

你甚至只用注释语言写即可：

// 功能：上传语音并返回评分
// 输入：file
// 输出：{ score, suggestions }

然后让 AI 生成代码。

你掌控结构，AI 负责执行。

混乱必须被关在 AI 能处理但你不会被炸死的盒子里。

三、项目从哪里开始？——套路必须要有

大部分人上来就让 AI 写功能，这是最大坑。

真正的顺序应该是：

先搭架子，再写业务。

下面是我总结的“前端项目从零到可开发”的 checklist。

我现在所有项目都按这个走。

第一章：项目基础配置

项目需求文档：给自己一个底图
项目结构（src 分层、模块划分）
路径别名设置（@/components …）
Tailwind 配置
Iconfont 使用方法
UI 库配置（如 shandUI）
环境变量命名规则
Git 提交规范
开发环境配置指南

第二章：全局功能

全局状态管理（Zustand）
通知组件
全局 Loading / 进度条
Axios 请求封装
路由配置
路由守卫

做到这里，项目的骨架就稳了。

之后才能让 AI 填业务逻辑，不然永远返工。

每完成一个功能 → 写一份文档 → 提交一次。

这是维持秩序的关键。

四、AI 的边界：它擅长什么、不擅长什么（非常关键）

如果不懂这一节，你和 AI 的合作永远会疯。

AI 擅长：

根据你给定的输入输出生成实现
重写、封装、简化你现有的代码
生成重复性的逻辑（验证、表单、CRUD）
修 bug（只要上下文给清楚）
给风格一致的文档

AI 不擅长：

跨文件、跨上下文的状态一致性（典型 bug 源头）
大型架构的动态规划
推测业务规则
长链条推理（改 A 影响到 BCDE）
你没明确说的事

所以你必须负责：

目录结构
数据流
状态管理
输入输出定义
模块职责

AI 负责：

实现
重构
文档
重复劳动

一句话总结：

架构是你的，代码是 AI 的。

你主导，AI 执行。

五、两个能立即使用的 AI 编程模板

模板 1：写组件时

我需要你根据下面的描述生成一个前端组件。

【功能】
（写你的需求）

【要求】
- 使用 TypeScript
- 不要生成未提到的额外功能
- 逻辑与 UI 分离
- 副作用写到 hooks
- 组件本身保持纯净

模板 2：修 Bug 时

这是报错和相关文件：
（贴代码）

请给我：
1. 问题根因
2. 复现方式
3. 修复步骤（不能修改我未贴出的文件）

这两个模板可以直接提升你 70% 的 AI 协作效率。

结语

过去两个月，我用 AI 和自己一起写了多个实际项目。

我越来越确定：

AI 不是替你写项目，而是替你做重复劳动。

真正的结构、模型、边界，必须是由你来定。

希望这篇文章能让你少踩坑、多产出。

如果你有想法、经验、或者被气疯的故事，也欢迎告诉我。