不期而至🎁 惊喜礼盒
🎁 Surprise · 不定期 · 随缘更新


🎁 Surprise · 不定期 · 随缘更新
🎁 SURPRISE
谢谢你停在这里。愿你被温柔以待,也愿你带着一点勇气继续往前——这是我留给访客的小小礼物 🎀✨。
— threetwoa
(=;ェ;=) 客来不妨坐下,落叶声里续一壶茶;猫会自己找你。
走进数字花园
很多人以为 vibe coding = 跟 AI 聊天就能出 App。其实更像一门描述目标、判断结果、持续迭代的手艺:你不必先会手写每一行代码,但得说得清、看得懂、敢砍范围。
下面按「离溪雪」系列信息图 01–10 原样拆开。每章一张图,能带走的是动作,不是口号。

定义(图上原话大意): 用自然语言描述软件意图,让 AI 帮你生成、修改、调试代码。不必先会写代码,但要能描述目标、判断结果、持续迭代。
| 场景 | 工具 | 图上说法 |
|---|---|---|
| 快速出原型 | Bolt | 网页和小工具快速搭 |
| Lovable | 对话式生成产品界面 | |
| Replit | 在线写、跑、部署 | |
| 先做界面 | v0 | 先出前端页面和组件 |
| 长期 / 更可控 | Cursor、Windsurf | 边看代码边改 |
| Claude Code、Codex | 更偏工程接管项目 |
适合: 个人小工具、表单/管理系统、网页/落地页、内容整理工具、MVP 原型验证。
不适合一开始就上: 大型综合 App、高安全系统(金融/医疗)、高并发生产后端、问题本身都说不清的项目。
第一句可以这样说:
我想做一个待办管理工具,支持新增任务、分类标签、状态管理和简单统计。先帮我拆成功能清单,并做一个最小可用版本。
术语: 自然语言 · 意图 · 迭代 · MVP · 原型

AI 最怕的不是任务难,而是你说得太模糊。
最小需求模板同一套字段:用户 / 问题 / 核心流程 / 输入 / 输出 / 成功标准 / 本版不做。
| 模糊 | 可执行 |
|---|---|
| 「做一个记账 App。」 | 「面向个人用户,做一个极简记账网页。用户可以新增一笔支出,选择分类,填写金额和日期,保存后能看到今日支出和本月总支出。本版不做登录、预算、多人协作。」 |
术语: Spec · User Story · Scope · Acceptance Criteria · Non-goals
常见错误: 只说「帮我做个 App」;一上来塞太多功能;不说明用户;不定义完成标准;不写本版不做。

Vibe coding 最容易失败的地方,是一上来做太大。先完成最小可行版本,再逐步变复杂。
| 档 | 典型内容 |
|---|---|
| 必须有(Must) | 核心功能、基础页面、数据保存、最小反馈 |
| 应该有(Should) | 分类、搜索、筛选、简单统计 |
| 以后再说 | 多人协作、登录权限、复杂分析、支付系统 |
例子:任务管理工具
术语: MVP · 核心循环 · 原型 · 迭代 · Must-have / Should-have
常见错误: 还没跑通就想做完整产品;首页+登录+支付+分析一次全要;没有最小可行版本;每轮加功能却不管体验。

| 路线 | 工具 | 适合 | 目标 |
|---|---|---|---|
| ① 新手快速 | Bolt、Lovable、Replit | 网页、小工具、MVP | 尽快跑起来 |
| ② 前端优先 | v0、Figma → code | 先看界面、落地页、组件多的页 | 先把视觉/UI 说清 |
| ③ 工程化 | Cursor、Windsurf、Claude Code、Codex | 长期项目、复杂逻辑、多文件改 | 可维护结构 |
懂不懂代码?要不要长期维护?要不要数据库?要不要登录权限(Auth)?
术语: Tech Stack · Frontend · Backend · Database · Auth · Scaffold
常见错误: 新手一上来选复杂架构;临时 demo 和长期项目不分;放任 AI 随便定栈;不考虑维护成本。

第一轮目标不是做完,而是搭出一个能继续生长的项目骨架。
页面结构 · 路由设计 · 核心组件 · 数据模型 · 文件夹结构 · 基础样式 · 运行方式
src/ 结构(图上示意)1src/2 app/3 components/4 hooks/5 lib/6 services/7 styles/8 types/9 tests/| 字段 | 类型 |
|---|---|
| id | string |
| title | string |
| status | enum |
| priority | number |
| dueDate | date |
| createdAt | date |
每个文件夹做什么 · 核心数据怎么流动 · 哪些文件以后会扩展 · 哪些地方暂时留空
术语: Scaffold · Routes · Components · Schema · File Structure · Data Model
常见错误: 第一轮就堆满功能;页面/数据/逻辑搅在一起;没有清晰文件结构;后面一改就全乱。

真实软件页面至少要把状态说清楚。
| 状态 | 要点 |
|---|---|
| 正常 | 数据正常加载并展示 |
| 空 | 无数据时的友好提示 + 引导动作 |
| 加载 | 占位或提示,别让人以为卡死 |
| 错误 | 说明原因 + 可操作建议 |
| 成功 | 操作成功后的明确反馈 |
| 移动端 | 小屏信息层级与交互 |
给 AI 的指令模板:
请为这个页面同时设计正常、空、加载、错误、提交成功、移动端 6 种状态,并说明每种状态触发条件。
任务列表页例子: 空=「还没有任务」+ 新建;加载=「正在读取任务」骨架屏;错误=读取失败 + 重试;成功=新增成功 + 查看;移动端=列表改单列。
术语: UI State · Empty State · Loading State · Error State · Responsive Layout · Toast / Feedback
常见错误: 只做正常态;没错误提示;表单提交无反馈;不看移动端;空数据直接白屏/崩。

报错不是失败。报错是让 AI 进入修复循环的入口。
运行 → 错误日志 → 让 AI 解释原因 → 最小修复 → 重跑 → 验证是否修好
完整错误信息 · 终端日志 · 相关文件 · 操作步骤 · 预期结果 · 实际结果
推荐指令:
请先解释这个错误的原因,不要直接大改代码。然后给出最小修复方案,并说明修复后我应该如何验证。
术语: Error Log · Stack Trace · Patch · Debug Loop · Re-run · Verify
常见错误: 只说「报错了」;只贴截图不贴日志;一次让 AI 大改很多文件;修完不重跑;不检查是否引入新问题。

真正危险的不是 AI 改错,而是你完全不知道它改了什么。
改动摘要 · 受影响文件 · 为什么这么改 · 潜在风险 · 如何验证
涉及这些时尤其别一键全收:大面积重构 · 删除旧文件 · 修改依赖版本 · 改动鉴权逻辑 · 改动数据库结构
术语: Diff · Code Review · Regression · Breaking Change · Side Effect · Hardcoded Value
常见错误: 不看 diff;不知道改了哪些文件;小修变大修;修一个 bug 引入三个新 bug;不让 AI 说明风险。

手动点一遍 → 写测试用例 → 边界情况 → 端到端(E2E)→ 移动端测试
让 AI 生成验收 checklist:
请根据这个功能,生成一份验收 checklist,包括正常流程、异常输入、空状态、移动端和数据保存测试。
例子:记账工具验收 —— 能新增支出;金额为空有错误提示;分类可选;刷新后记录还在;本月合计正确更新;移动端按钮不被挡住。
术语: Acceptance Criteria · Test Case · Edge Case · E2E Test · Regression Check
常见错误: 自己点一遍就当完;不测空数据;不测错误输入;不测移动端;不测刷新与持久化。

软件真正进入「真实世界」,是上线之后。
部署平台 · 环境变量 · 数据库 · 登录权限 · API Key · 域名 · 构建命令 · 日志查看方式
| 平台 | 图上说法 |
|---|---|
| Vercel | 前端部署体验好 |
| Netlify | 持续部署简单 |
| Render | 全栈灵活可靠 |
| Replit | 内置环境一键部署 |
| Cloudflare Pages | 全球加速,免费好用 |
让 AI 生成部署清单:
请根据当前项目结构生成一份部署 checklist,包括环境变量、数据库、构建命令、权限配置、日志查看和回滚方案。
收集反馈 · 修 bug · 补功能 · 改 UI · 优化性能 · 做版本记录
术语: Deploy · Environment Variables · API Key · Logs · Rollback · Iteration
常见错误: 本地能跑就当完;API Key 写死在代码里;不上生产看日志;没有回滚方案;不做版本记录。
| 笔记 | 关系 |
|---|---|
| VibeCoding 别把流程交给聊天框(待发布) | 入门十步之后,别把流程只活在聊天框 |
| Vibecoding 双轨机制(待发布) | 工程化路线里的「一边干一边盯」 |
| Claude Code 四类 Loop | 走到 Cursor/Claude Code 后,Loop 怎么交出去 |
| Prompt → Context → Harness → Loop(待发布) | 为什么瓶颈会从 Prompt 挪到 Harness/Loop |
| Vibe 编程 10 工具选型地图 | 工具怎么选;本篇是怎么用 |
十步走完,你会发现:难的从来不是「让 AI 写」,而是需求写清、范围砍准、Diff 看得懂、验收过得去、上线还能迭代。
复制链接或生成海报,发给感兴趣的人。

Vibe「20 项目实战」索引:开发流程、个人工具到全栈/小程序、部署上线专节与灵感库,链回鱼皮原文。
2026-08-11部分内容可能已过时
分享你的想法,与大家交流讨论
像发消息一样写就好:点工具栏插入表情 / 图片,表情会直接显示。插图 ≤5MB。

🎁 Surprise · 不定期 · 随缘更新
🎁 SURPRISE
谢谢你停在这里。愿你被温柔以待,也愿你带着一点勇气继续往前——这是我留给访客的小小礼物 🎀✨。
— threetwoa
有什么想了解的?
我基于博客内容回答