Vibe Coding 入门指南

在你写下第一行AI生成的代码之前,你需要了解的一切。

这份指南写给想用AI工具构建真实产品的非技术人员——以及想在工作和生活中借助AI智能体做更多事情的所有人。

这份指南适合你,如果:
  • 你听说过"Vibe Coding",想试试,但不知道从哪里下手
  • 你有一个App、网站或工具的想法——但从来没有写过代码
  • 你是产品经理、设计师、市场人员或创业者,想更快地把想法变成现实
  • 你想更有效地使用AI工具处理日常工作——而不仅仅是写代码

这不是一门编程课。 你不会在这里学习如何写代码。你将学到的,是在你开始让AI为你写代码之前,必须掌握的那些东西。

就像学地图判读,然后再用导航一样。

读完之后,你能做到什么

第一部分:理解你即将进入的世界

第1章:Vibe Coding 到底是什么

2025年初,OpenAI联合创始人之一Andrej Karpathy发了这样一条推文:

"有一种新的编程方式,我称之为'Vibe Coding'。你完全放开,顺应指数级加速的浪潮,甚至忘记代码的存在。"

这条推文迅速走红。核心概念是:你用自然语言描述你想要什么,AI来写代码。你不用读代码,不用调试代码,只需要……跟着感觉走。

这是神话。以下是现实。

Vibe Coding是真实的,也是强大的。但"你什么都不需要懂"这句话是错的。这就好比说"开餐厅不需要懂食物"。没错,大厨负责烹饪。但如果你连菜单都描述不清楚、不了解食材、也品不出味道不对——你的餐厅早晚倒闭。

更好的理解方式

你是导演,AI是你的剧组。他们能以超人的速度搭建布景、写剧本、拍摄素材、剪辑成片。但他们需要明确的指导。如果你说"拍好看点",你会得到一个随机的结果。如果你说"一个30秒的场景,背景是温馨的咖啡馆,暖光,两个朋友对着拿铁欢笑,低角度拍摄"——你得到的就会接近你的想象。

Vibe Coding只是开始

Vibe Coding只是其中一个用例。真正的变革在于:AI智能体现在能替你做事了。 不只是回答问题——而是真正采取行动:写文件、运行程序、搜索网络、分析数据、生成报告。

无论你是想做一个App、自动化部分工作流程、分析数据、更快地写文档,还是深度研究某个课题——你都需要同一套基础知识。这正是这份指南要给你的。

快速通道:给产品经理
你已经会写PRD。Vibe Coding就像写一份PRD,只不过工程师的执行速度无限快,但极其字面化。他们会严格按照你写的来实现——一字不差,好的坏的都算。你的PRD能力就是你在这里最大的优势。
快速通道:给设计师
你已经做过设计交付物(Design Handoff)。Vibe Coding就像一次交付,只不过开发者不会问任何澄清性问题,而是严格按照你描述的来实现。没提到的边界情况?一律不处理。你对细节的关注就是你的护城河。
快速通道:给市场人员
想想你的用户转化漏斗。落地页 → 注册表单 → 欢迎邮件 → 用户后台。你已经用系统化的方式在思考了。现在,你可以亲手把这些系统搭建出来。

第2章:AI智能体如何工作(2分钟速成版)

你不需要懂汽车引擎的工作原理才能开车。但你确实需要知道:车需要加油,方向盘控制转向,刹车踩下去车会停。

这里也是同样的道理。你只需要了解AI编程工具的工作方式,到足够会用它们的程度就够了。

工作循环(The Loop)

每一个AI编程工具——Claude Code、Cursor、GitHub Copilot、通义灵码——都遵循相同的工作方式:

你说了什么
     ↓
AI思考一下
     ↓
AI采取行动(写文件、运行命令、读取内容)
     ↓
AI查看结果
     ↓
AI判断:完成了吗?还是需要继续?
     ↓
没完成 → 回到第2步
完成了 → 向你汇报

就这些。其他的都是细节。

为什么这对你重要: 当AI看起来"卡住了"或在原地打转,它就是卡在了这个循环里。理解这个循环,能帮你把它"解套"。(通常方法是:给出更明确的指令,或者开启一个新的对话。)

AI能看到什么

AI看不到什么

上下文窗口——办公桌比喻

想象AI有一张办公桌。你发的每条消息、它读取的每个文件、它执行的每个动作——所有这些都堆在桌上。桌子的空间有限。装满了之后,早期的内容会从桌边掉落。

这就是上下文窗口(Context Window)。这也是为什么对话太长之后有时会跑偏——AI字面意义上"看不到"你50条消息之前讨论过的内容了。

施工队比喻

把AI想象成一个刚到你工地的优秀施工队长。他从未见过你的项目。每次你开启新对话,他都是全新走进来——没有任何昨天的记忆。

你的任务是快速给他定向:"这是项目背景,这是已经完成的部分,这是我需要你接下来做的事。"

第3章:系统思维(核心能力)

这是整份指南中最重要的一章。如果你只学一件事,就学这个。

万物皆系统。

餐厅是一个系统。输入:饥饿的顾客、生鲜食材。流程:接单、烹饪、上菜。输出:吃饱的顾客、营业收入。

你的早晨例行程序也是一个系统。输入:闹钟、咖啡豆。流程:起床、煮咖啡、洗漱。输出:精神抖擞的你,准备开始新的一天。

一家网店也是一个系统。输入:商品、访客。流程:浏览、加购、结账、支付。输出:已发货的订单、到账的货款。

为什么这对Vibe Coding很重要: 当你能把自己的想法描述成一个系统时,你就能把它描述给AI。当你做不到这一点,你只会得到模糊的结果。

每个软件系统都有的四件事

  1. 数据(Data)——它存储什么信息?(任务、用户、预订、商品)
  2. 界面(Interface)——人们如何使用它?(按钮、表单、页面、屏幕)
  3. 逻辑(Logic)——规则是什么?(密码错误就报错;座位满了就禁止预订)
  4. 连接(Connections)——它需要和哪些外部服务打通?(支付、短信通知、登录)

练习:设计你的第一个系统

选一个你每天都在用的App,然后回答:

  • 它存储了什么数据
  • 它向你展示什么界面
  • 它遵循哪些逻辑规则?
  • 它和哪些外部服务有连接

恭喜,你刚刚完成了一次系统思考。不需要写任何代码。

餐巾纸草图

在打开任何AI工具之前,先拿一张纸,画出:

这5分钟的准备,能为你省去数小时和AI来回拉锯的时间。

┌─────────────┐ ┌──────────────┐ ┌──────────────┐ │ 课程表 │────>│ 预订表单 │────>│ 确认页面 │ │ │ │ │ │ │ │ 展示所有 │ │ 姓名、手机 │ │ "预订成功!"│ │ 即将开课 │ │ 选择课程 │ │ 短信已发送 │ │ 的课程 │ │ 支付按钮 │ │ │ └─────────────┘ └──────────────┘ └──────────────┘ │ ▼ ┌─────────────┐ │ 教练后台 │ │ │ │ 查看每节 │ │ 课的学员 │ │ 预订情况 │ └─────────────┘ 数据:学员、课程、教练、预订记录、支付信息 外部连接:微信支付/支付宝(支付)、短信服务商(通知)

如果你把这张图交给AI,它构建出来的东西会比你只说"帮我做一个瑜伽预订App"靠谱得多。

这个能力适用于所有事情

系统思维不只用于构建App。它同样适用于:写一份报告(输入 → 流程 → 输出)、策划一场活动、自动化处理邮件,或者你交给AI智能体的任何任务。

第二部分:软件到底是怎么运行的

这不是词汇表。这是对你即将进入的世界的真实解释。读完这部分,你就能真正理解AI在为你构建某样东西的时候,它在做什么。

第4章:前端、后端和中间的互联网

每次你打开一个网站,都会发生一段小小的戏剧:

  1. 你在浏览器里输入一个网址
  2. 你的浏览器通过互联网发出一条消息:"嘿,把那个页面给我"
  3. 某处的一台电脑收到消息,开始准备页面
  4. 那台电脑把页面发回给你的浏览器
  5. 你的浏览器把它显示出来

就这样。每个网站都是这么运行的。微博、淘宝、抖音——全都是同一个基本模式。

前端:前厅

前端(Frontend)是一切发生在你浏览器里的东西。是你看到的、摸得到的部分。

类比: 餐厅的前厅——菜单、桌椅、灯光。这是顾客的体验区。

前端的主要语言:HTML(结构)、CSS(样式)、JavaScript(交互行为)。你不需要写这些。但当AI创建以 .html.css.js 结尾的文件时——那就是前端。

后端:后厨

后端(Backend)是一切发生在服务器上的东西。用户永远看不到它。

类比: 厨房。顾客进不去,但所有真正的工作都在那里发生。

数据库:档案室

数据库(Database)是App永久存储信息的地方。你注册时,你的手机号存进了数据库。你关掉浏览器,明天再回来,一切还在——因为它在数据库里。

类比: 后台的档案室。客户资料、订单记录、收据存根。

API:服务员

API是前端和后端沟通的桥梁。你的浏览器不能直接伸手进数据库。前端通过API发起请求:"给我这个用户的个人资料。"API把答案带回来。

类比: 服务员。你告诉服务员你要点什么,服务员去厨房,把菜端回来。你自己不用进厨房。

整个流程是怎么连起来的

让我们来追踪一下,当你点击某个网站上的"注册"按钮,发生了什么:

你的浏览器(前端) 服务器(后端) ───────────────── ────────────── 1. 你填写姓名、 手机号、密码, 点击"注册" ──────► 2. 浏览器通过API 3. 服务器检查: 发送你的信息 这个手机号 已经注册了吗? 4. 没有,则存入 ◄────── 数据库,返回 5. 浏览器显示 "注册成功" "欢迎!"或"报错"

这就是全貌。前端、后端、API、数据库——协同工作。

快速通道:给设计师
你已经在用"UI ↔ 业务逻辑"来思考这一切了。前端 = 你的视觉稿。后端 = 你在标注里写的那些东西,比如"点击后存入数据库"。现在你有了这些事情的名字。

第5章:服务器、域名和端口

这三个概念会频繁出现。让我们确保你真正理解它们。

服务器:一直开着的电脑

服务器(Server)就是一台电脑。就这么简单。没有任何神奇之处。它是一台7×24小时运行的、连接着互联网的电脑,运行着你的App,让别人能访问它。

关键一点:你的笔记本电脑现在就是一台服务器——当你在上面运行App的时候。区别在于只有你自己能看到它。当你的App跑在本地笔记本上时,它可以在一个特殊地址访问到:localhost。这个词的字面意思就是"这台电脑"。

当你部署(deploy)时,你把App从笔记本复制到一台所有人都能访问的服务器上。这是"本地运行"和"上线到互联网"之间唯一的区别。

端口:门牌号

你的电脑可以同时运行很多个App。它怎么区分它们?

端口(Port)。 把你的电脑想象成一栋公寓楼。

所以当你看到 localhost:3000,意思是:

localhost:8000 是同一栋楼里的另一套公寓。

端口通常用于
80普通网站(HTTP)
443加密网站(HTTPS)
3000React 和 Node.js 应用
5173Vite 开发服务器
8000Python 后端(FastAPI、Django)
5432PostgreSQL 数据库
"Port already in use"(端口已被占用)意味着两个App不能住在同一套公寓里。如果已经有东西在3000端口跑着,你又启动另一个App也要用3000端口,就会报错。解决方法:停掉第一个App,或者让第二个App改用其他端口。

实际场景: AI说"Server running on port 8000"(服务器在8000端口运行)。那就意味着:打开浏览器,输入 localhost:8000,你就能看到你的App了。

域名:人类友好的地址

互联网上每台电脑都有一个叫IP地址的数字编码。看起来像这样:110.242.68.3。那实际上是百度。

没有人愿意记数字。所以我们发明了域名——指向这些数字的人类可读标签。

类比: "天安门广场"比"北京市东城区东长安街"更好记。同一个地方,更友好的名字。

DNS:互联网的电话簿

当你输入 baidu.com

  1. 你的浏览器问DNS:"baidu.com对应什么数字?"
  2. DNS查询后回答:"那是 110.242.68.3"
  3. 你的浏览器连接到那个数字
  4. 百度把页面发送给你

如何获得一个域名

  1. 去域名注册商(万网/阿里云域名、腾讯云域名、Namecheap)
  2. 搜索你想要的域名
  3. 购买(通常每年几十到一两百元)
  4. 将它指向你服务器的IP地址
  5. 完成——用户输入你的域名就能看到你的App了

子域名: blog.my-yoga-studio.comapi.my-yoga-studio.com 都是子域名。把它们想象成一家公司下面的不同部门。

ICP备案:在中国上线的必要手续

如果你的网站面向中国大陆用户,或者服务器在中国大陆,你需要完成ICP备案(互联网内容提供商备案)。这是中国法规的要求,不是可选项。

实际操作顺序:先买好服务器和域名 → 提交备案 → 等待审批 → 备案通过后正式上线。提前规划好时间。

HTTPS:那把小锁

浏览器地址栏里的小锁图标意味着HTTPS已启用。你的浏览器和服务器之间传输的数据是加密的。就像把信放在密封信封里寄出去,而不是写在明信片上。

好消息:大多数部署平台会自动帮你配置好这一点。

云服务商:租一台服务器

你不需要买一台物理服务器。你可以租用。

服务商难度适合场景
阿里云(ECS + 函数计算)中等面向国内用户的全功能应用
腾讯云(CVM + CloudBase)中等面向国内用户,微信生态友好
Vercel简单前端应用,海外用户,无需备案
Railway简单带后端+数据库的完整应用,海外用户
AWS(境外区)一切(需要自己配置所有内容)

心智模型

本地(你的笔记本)

localhost:3000
只有你自己能看到
免费
你的私人工作室
上线(互联网)

your-app.com
任何人都能访问
通常每月0-200元
你的公开店面

第6章:数据——App如何记住东西

你关掉微博再打开,你的帖子还在那里。你用一台新设备登录爱奇艺,你的追剧记录也在等你。这是因为数据不存在App里——而是存在服务器上的数据库里。

理解数据,是Vibe Coding中你能学到的最有价值的事情之一。当你把数据描述清楚,AI一开始就能构建出正确的东西。

电子表格比喻

如果你用过Excel或WPS表格,你已经理解数据库了。

数据库术语对应表格概念
数据库(Database)整个工作簿(那个.xlsx文件)
表(Table)工作簿里的某一个Sheet(标签页)
行(Row)一行数据(一个人,一笔订单)
列(Column)一列的标题(姓名、邮箱、金额)
字段(Field)一个单元格(张三的手机号这一格)

数据库本质上就是一组组织得很好的电子表格。

真实案例:瑜伽工作室预订App

表:学员(Students)

姓名手机号微信会员类型
陈晓燕138-0010-0101xiaoyan_chen月卡
李明139-0010-0102liming_yoga单次
王芳136-0010-0103wangfang88年卡

表:课程(Classes)

课程名教练星期时间最大人数
晨间流瑜伽Anna周一7:0020
力量瑜伽Ben周二18:0015
温和拉伸Anna周三10:0025

表:预订记录(Bookings)

学员课程日期状态
陈晓燕晨间流瑜伽2026-03-05已确认
李明力量瑜伽2026-03-06已确认
陈晓燕温和拉伸2026-03-07已取消

看到预订记录如何把学员和课程关联起来了吗?这种关联叫做关系(Relationship)

什么是数据模型?

数据模型(Data Model)是你的信息如何组织的设计方案。它是你在数据库被创建之前设计好的——就像盖房子前先画平面图。

练习:设计你的数据

对于任何App想法,回答这三个问题:

  1. 我的App里有哪些主要的事物?(用户、商品、订单……)
  2. 关于每个事物,我需要知道哪些信息?(名字、价格、日期……)
  3. 这些事物之间如何关联?(一个用户有多个订单,一个订单包含多个商品……)

每个"事物"变成一张。每个细节变成一个。每个关联变成一个关系

JSON:App之间传递数据的格式

你会在各处看到这种格式:

{
  "姓名": "陈晓燕",
  "手机号": "138-0010-0101",
  "会员类型": "月卡",
  "是否有效": true
}

这是JSON。它只是一种格式化信息的方式,让计算机能读懂。把它想象成一张标准化的表单。你不需要写它,但你会在AI的输出里到处看到它。

为什么这对Vibe Coding很重要

模糊的提示词

"帮我做一个预订系统"
清晰的提示词(附数据模型)

"帮我做一个预订系统,包含:学员(姓名、手机号、微信、会员类型),课程(名称、教练、上课星期、时间、最大人数),以及预订记录(学员+课程+日期+状态)。需要防止超额预订。"

清晰的提示词给了AI一个数据模型。它第一次就能构建出正确的东西。

第三部分:准备工作

第7章:文件、文件夹和代码如何组织

很多人第一次听到这件事会感到惊讶:你整个App就是一堆放在文件夹里的文件。 就这样。没有任何魔法。

你会看到的文件类型

扩展名是什么类比
.html页面结构房间的设计蓝图
.css视觉样式墙漆和家具
.js交互行为电路走线
.pyPython代码厨房里的菜谱
.json数据/配置一张设置清单
.env密钥和秘密一个上了锁的抽屉
.md说明文档一张README便条

终端:给电脑发短信

终端(Terminal)是一种用文字和电脑交互的方式。不用双击文件夹,你输入 cd my-project。不用点击"运行"按钮,你输入 python app.py

还是同一台电脑,同样的文件——只是换了一种交互界面。就像发短信和面对面说话的区别。

你最常用的三条命令:

cd 文件夹名称     ← 进入某个文件夹
ls                ← 列出当前目录的内容(Windows用 dir)
python app.py     ← 运行你的App(或者:npm start)

这就是90%的情况。

文件路径:文件的地址

文件路径就像文件的街道地址:

/Users/你的名字/projects/my-app/index.html

从左到右读:你的用户目录 → projects文件夹 → my-app文件夹 → 具体文件。

依赖包:借来用的代码

依赖(Dependencies),或称包(Packages),是别人写的、你的项目要用到的代码。需要支付功能?有现成的包。需要发短信通知?有现成的包。

类比: 从面包店买面包,而不是自己种小麦。

当你看到 npm installpip install,AI是在下载预制好的"食材"。

Git:项目的时光机

Git让你保存项目的快照。如果某个东西坏掉了,你可以回退到任意一个之前的快照。

你需要掌握的那一套操作:

git add .
git commit -m "添加支付功能之前的可用版本"

如果东西坏掉了,要撤销改动:

git checkout .

两条命令。会帮你省去很多痛苦。

环境变量:秘密便利贴

环境变量(Environment Variables)把秘密信息(API密钥、密码)存在你的电脑上——而不是存在代码里。如果你把秘密放在代码里然后分享出去,所有人都能看到。

你会看到一个叫 .env 的文件:

API_KEY=sk-abc123xyz456
DATABASE_URL=postgresql://localhost:5432/mydb
WECHAT_APP_SECRET=your_wechat_secret_here

最前面那个点意味着它是隐藏文件。永远不要分享它。永远不要上传它。

第8章:读懂错误信息

这是把沮丧的Vibe Coder和高效的Vibe Coder区分开的那项技能。

出了问题,电脑会显示一条错误信息。大多数人看到红色文字就慌了。但错误信息不是在发火——它们是在试图帮你。

换个角度看: 错误信息是导航在说"正在重新规划路线",而不是老师在说"你答错了"。

一条错误信息的解剖

  1. 类型(Type)——什么类型的问题?
    ModuleNotFoundErrorSyntaxError404 Not Found
  2. 位置(Location)——在哪里出的问题?
    File "app.py", line 42
  3. 描述(Description)——具体是什么问题?
    No module named 'flask'

你最常遇到的5种错误

错误什么意思怎么告诉AI
"Module not found"某个包没有安装"帮我安装 [名称]"
"Permission denied"没有访问权限"我在……时遇到了权限拒绝"
"Port already in use"该端口已被另一个App占用"X端口被占用了,换一个端口"
"File not found"路径错误或文件不存在"找不到 [文件名],它在……"
"Connection refused"服务器没有运行"连接被拒绝——服务器是不是没启动?"

复制粘贴策略

最好的部分来了:你根本不需要读懂错误信息。 只需要:

  1. 复制完整的错误信息
  2. 粘贴给AI
  3. 说:"我遇到了这个错误,什么问题,怎么修复?"

AI解释原因,然后修复它。这是你作为Vibe Coder最强大的超能力。

当错误信息很长的时候: 通常最后几行才是最重要的。那里才是真正的错误所在。上面那些是错误是从哪里一路传下来的轨迹。

第9章:环境搭建

你需要四样东西。就这四样。

1. 终端(你电脑上已经有了)

Mac: 按 Command + 空格,输入"终端",按回车。完成。

Windows: 在开始菜单搜索"Windows Terminal"(Windows终端)。完成。

2. 代码编辑器(用来查看和编辑文件)

下载 VS Code(Visual Studio Code)。免费。去 code.visualstudio.com,下载,安装。

小建议:安装"Material Icon Theme"扩展——让文件树的图标更直观,更好辨认。

3. 运行时(执行代码的引擎)

Node.js(用于JavaScript):

Python:

两个都装上。体积小,都免费。

4. AI编程工具

零配置(浏览器直接用)——从这里开始

工具最适合
Bolt(bolt.new)第一次Vibe Coding的人
Replit(replit.com)学习和实验
Lovable(lovable.dev)用描述文字构建Web应用
v0(v0.dev)UI组件和界面设计

本地工具(更强大)——进阶后使用

工具最适合
Cursor喜欢在看到代码的同时使用AI的人
Claude Code习惯用终端的进阶用户
通义灵码国内用户,VS Code插件,中文支持好
GitHub Copilot在VS Code里获得AI代码补全建议

建议: 先从浏览器工具开始(Bolt或Replit)。立刻看到结果。准备好了之后,再迁移到Cursor或Claude Code。

国内用户额外提示:通义灵码(由阿里云提供)可作为VS Code插件使用,对中文理解较好,访问速度稳定,是不错的国内替代选项。

检查清单:一切都正常了吗?

node --version        ← 应该显示 v18+ 或 v20+
python3 --version     ← 应该显示 Python 3.10+
git --version         ← 应该显示 git 2.x

如果某个命令提示"command not found"(找不到命令):说明没有安装,或者安装完之后需要重启终端再试。

第四部分:与AI沟通

第10章:提示词的艺术

AI构建出来的东西质量好不好,直接取决于你给出的指令质量高不高。

黄金法则

把你想要"什么"说清楚,不用担心"怎么"实现。那是AI的工作。

差 → 好 → 极好

差劲的提示词

"帮我做一个应用"

AI完全不知道你要什么类型的应用,也不知道是给谁用的。
不错的提示词

"帮我做一个待办事项应用,用户可以添加任务、打勾完成、删除任务"

功能明确,AI知道该做什么。

极好的提示词:"帮我做一个待办事项网页应用,页面顶部有文本输入框,下方是任务列表。用户输入任务后按回车添加。每条任务有复选框和删除按钮。任务保存在浏览器本地存储中。设计风格简洁,白色背景,柔和阴影,无需后端。"

简报模板

在向AI工具输入任何内容之前,先回答以下五个问题:

  1. 它做什么?(一句话描述)
  2. 谁来用?(你的目标用户)
  3. 有哪些页面或界面?
  4. 用户能执行哪些操作?
  5. 需要存储哪些数据?

把你的答案整合成提示词,就这样。

这对非编程任务同样有效

数据分析:"我有一份2025年的销售表格,请按季度计算收入,找出销量前10的产品,找出同比下降超过20%的月份,生成一份带图表的PDF报告。"

调研:"调研市面上前5名的在线瑜伽预约平台,比较价格、功能和用户投诉,以对比表和一页摘要呈现。"

所有情况都一样:你越具体,结果越好。

参考对标法

直接引用已有的产品:

"做一个类似Stripe官网风格的落地页——简洁,留白充足,顶部有标题和CTA按钮的Hero区域,渐变背景,下方三张功能卡片。"

AI知道Stripe长什么样。这比你逐一描述每个细节效率高得多。

快速通道:写给产品经理
你的用户故事可以直接派上用场。"作为[学员],我希望能[预约课程],以便[锁定我的名额]。"直接喂给AI,它完全能理解这种格式。

第11章:反馈循环

Vibe Coding不是一次性的。它是一场对话:AI构建出东西,你看一看,告诉它要改什么,然后重复这个过程。

如何查看AI构建的结果

AI会告诉你该用哪条命令。

如何给出好的反馈

差劲的反馈

"不行,不对"
好的反馈

"当我点击提交按钮后,页面刷新了,但任务没有出现在列表中。我期望它出现在列表底部。"

小技巧:

什么时候该重新开始

高手技巧:开启新对话时这样说:"我有一个项目在[文件夹]。这是一个[描述]。目前已实现[已完成的功能]。我需要新增[新功能]。"

Git安全网

在做大改动之前:

git add .
git commit -m "一切正常,准备添加支付功能"

如果改坏了:

git checkout .

恢复到上一个快照,让你安心。

第12章:常见失败模式

每个Vibe Coder都会遇到同样的坑。以下是全部坑点,以及如何绕开它们。

1. 模糊的提示词

现象:你说"帮我做个应用",AI做出来一个不知所云的东西。

解决:使用第10章的简报模板。

2. 需求蔓延螺旋

现象:"再加这个……还有这个……还有那个……"直到什么都不能正常运行。

解决:分层构建。先做最简版本,再每次只加一个功能。

3. 上下文过载

现象:超过80条消息后,AI开始忘记之前的指令。

解决:新功能开新对话。

4. 幻觉陷阱

现象:AI推荐了一个根本不存在的库。

解决:动手前快速搜一下,核实是否真实存在。

5. "回不去了"的问题

现象:之前能跑的代码,现在改坏了,也找不回原来的样子。

解决:用Git。能运行的时候就存快照。

6. 和AI杠上了

现象:同一个指令你已经换了5种说法,AI还是搞不定。

解决:试试AI给的方案——有时候它的更好。或者极度明确地告诉AI你"不要"什么。

7. 跳过AI的说明

现象:AI发出了警告,你跳过去没看,后来被坑了。

解决:不只是看代码能不能跑,要读AI写的每一段话。

起飞前检查清单

第五部分:从电脑到全世界

第13章:什么是部署

你的应用在笔记本上能跑,但只有你自己能看到。部署的意思是把它搬到服务器上,让任何人都能访问。

电梯比喻

三种项目类型

类型是什么部署到哪费用
静态网站只有HTML/CSS/JS,无后端Netlify、Vercel、GitHub Pages、码云Pages免费
全栈应用前端 + 后端 + 数据库Railway、Render、阿里云、腾讯云0~20美元/月
AI驱动应用全栈 + AI API调用Railway、Render、阿里云、腾讯云5~20美元/月 + API费用

快速判断:你的应用需要保存数据或运行服务器逻辑吗?不需要 → 静态网站。需要 → 全栈应用。

在中国大陆上线的注意事项:若你的网站面向中国大陆用户,需要考虑使用国内云服务商(阿里云、腾讯云、华为云),并了解ICP备案要求(见第14章)。

第14章:部署实战

方案一:静态网站 → Netlify(5分钟)

  1. 访问 netlify.com,注册免费账号
  2. 点击"Add new site" → "Deploy manually"
  3. 把项目文件夹拖进浏览器页面
  4. 完成。你会得到类似 your-project-abc123.netlify.app 的网址

方案二:全栈应用 → Railway(10分钟)

  1. 将代码推送到GitHub(可以让AI帮你操作)
  2. 访问 railway.app,注册账号
  3. "New Project" → "Deploy from GitHub repo"
  4. 在Railway控制台填写环境变量
  5. 应用上线

方案三:React/Next.js → Vercel(10分钟)

  1. 将代码推送到GitHub
  2. 访问 vercel.com,注册账号
  3. "Import" → 选择你的仓库 → "Deploy"
  4. 完成。网址:your-project.vercel.app

中国大陆替代方案

平台类型特点
阿里云OSS + CDN静态网站国内访问速度快,价格实惠
腾讯云COS + CDN静态网站与微信生态深度整合
阿里云ECS全栈应用完整云服务器,灵活配置
腾讯云轻量应用服务器全栈应用入门首选,价格亲民
Vercel / Netlify静态网站境外访问,无需备案

重要:ICP备案

如果你的网站面向中国大陆用户,并使用中国大陆服务器,必须完成ICP备案。 这是中国法律要求,不是可选项。

让AI帮你了解详情:"我要在中国大陆部署一个网站,需要哪些步骤,包括ICP备案?"

省力捷径:直接问AI

最佳做法:"我想把这个项目部署上线,让所有人都能访问。最简单的方法是什么?"

AI会判断你的项目类型,给你一份逐步操作指南。

生产环境的环境变量

你的 .env 密钥不能随代码一起上传到服务器。每个部署平台都有"环境变量"配置区,在那里粘贴你的API密钥。AI会提醒你。

部署失败怎么办

  1. 复制部署平台显示的报错信息
  2. 粘贴给AI
  3. "我尝试部署到[平台],出现了这个错误,是什么问题?"
  4. 修复后重新部署
第六部分:不止是写代码

第15章:AI在工作生活中的应用

你学到的一切——系统思维、清晰表达、迭代反馈——远不止用来做应用程序。

调研与分析

"读这份40页的报告,给我一页摘要、三个最重要的数据点,以及我应该向作者提的问题。"

职场场景:"分析这份竞品调研,整理成飞书多维表格格式,方便团队共同编辑。"

写作与编辑

"修改语法,把语气改得更对话化,从1500字缩减到1000字,加一个更有力的开头,建议三个标题选项。"

中文场景:"帮我写一篇微信公众号文章,主题是[主题],面向[受众],字数约[字数],风格轻松易读,结尾有互动引导。"

数据处理

"清理这份CSV:删除重复项,修正格式不一致的问题,计算每位客户的平均订单金额,找出6个月以上没有下单的客户。"

职场场景:"把这份钉钉审批记录导出的Excel整理一下,按部门汇总,标记超期未处理的条目。"

自动化

"每周一,拉取上周销售数据,计算周环比变化,起草汇报邮件,标出下滑超过10%的产品。"

中文场景:"帮我写一个脚本,每天自动从飞书多维表格读取数据,生成日报发到钉钉群机器人。"

学习

"像给12岁孩子讲解一样,解释SEO是什么。给我5个最重要的概念,制定一个每天30分钟、持续两周的学习计划,然后来测试我。"

万能公式

每个例子都用的是同一套技能:

  1. 描述系统 — 输入什么,输出什么
  2. 保持具体 — 越详细,结果越好
  3. 持续迭代 — 查看结果,给反馈,精炼
  4. 结构化思考 — 数据、界面、逻辑、连接

这些能力是永久的。工具会变,但清晰思考和精准表达的能力始终有价值——无论是在微信群协作、飞书文档写作,还是跨部门汇报中。

第16章:下一步学什么

路径一:保持非技术,但更高效

路径二:成为技术相关岗位

路径三:学会编程

什么时候该找真正的开发者

最佳方式:用Vibe Coding做出可运行的原型,然后找开发者来做代码审查和性能扩展。


未来一片光明。 AI编程工具正在飞速进化。这本指南里的技能——系统思维、精准表达、迭代开发——只会越来越有价值。

你不只是在学一个工具,你在学一种思维方式,让你在任何工具面前都能游刃有余,无论今天还是明天。

现在去做点什么吧。

附录

附录A:术语速查卡

核心概念

术语是什么类比
前端(Frontend)用户在浏览器中看到的部分餐厅大堂
后端(Backend)服务器端的逻辑处理餐厅厨房
数据库(Database)永久存储数据的地方档案柜
API前端与后端之间的通信接口服务员
服务器(Server)全天运行你应用的计算机永不下班的员工
端口(Port)同一台计算机上的不同应用入口房间号
域名(Domain)人类友好的网站地址楼栋名称
DNS将域名翻译成IP地址互联网电话簿
HTTPS加密连接密封信封
Git版本控制工具游戏存档点
终端(Terminal)与计算机交互的文本界面给电脑发短信
依赖(Dependencies)你使用的别人写的代码超市买的食材
环境变量(Env variables)存在代码之外的密钥只有你能看的便利贴
部署(Deploy)把应用放到互联网上从一楼坐电梯到顶楼
上下文窗口(Context window)AI一次能看到多少内容有限空间的桌面
JSON标准数据格式标准化表格
ICP备案在中国大陆运营网站的许可证开店营业执照
本地存储(localStorage)浏览器中的本地数据存储浏览器里的小本本
npmNode.js的包管理工具JavaScript的应用商店
pipPython的包管理工具Python的应用商店

简报模板

  1. 做什么
  2. 来用?
  3. 有哪些页面/界面
  4. 用户能执行哪些操作
  5. 需要存储哪些数据

起飞前检查清单

附录B:工具对比

工具类型难度价格适合谁
Bolt浏览器非常简单免费版可用第一次Vibe Coding的新手
Replit浏览器非常简单免费版可用学习和实验
Lovable浏览器简单免费版可用用描述生成Web应用
v0浏览器简单免费版可用UI组件和设计
Cursor桌面软件中等约20美元/月视觉型用户,喜欢边看代码边用AI
Claude Code终端中等按用量付费习惯命令行的高级用户
GitHub CopilotVS Code插件中等约10美元/月在编辑器里边写边获得AI建议
通义灵码VS Code插件中等免费国内用户,阿里云生态
文心快码VS Code插件中等免费版可用国内用户,百度生态

从没做过这些? 从Bolt或Lovable开始。
熟悉代码编辑器? 试试Cursor。
熟悉命令行终端? 试试Claude Code。
在国内开发,网络受限? 试试通义灵码或文心快码。

附录C:实用提示词模板

构建应用

1. 落地页

"为[产品名]创建一个落地页。包含:带标题、副标题和CTA按钮的Hero区域;
三张带图标的功能卡片;用户评价区块;带链接的页脚。
配色方案[颜色],现代简洁设计。"

2. 待办事项应用

"创建一个待办事项应用:可添加带标题和截止日期的任务,标记完成,
删除,按全部/进行中/已完成筛选。数据保存到浏览器localStorage。
简洁极简设计。"

3. 数据看板

"创建一个数据看板:4张统计卡(用户数、收入、订单、转化率),
12个月收入折线图,近期订单表格,侧边栏导航。使用模拟数据。"

4. 表单 + 数据库

"联系表单:姓名、邮箱、留言。提交后保存到SQLite。
管理页面(需密码)以表格展示所有提交记录。
Python + Flask后端。"

5. 预约系统

"预约系统:学员(姓名、手机、会员类型),课程(名称、教练、
上课时间、最大名额),预约记录(学员 + 课程 + 日期 + 状态)。
防止超额预约。Python + FastAPI + SQLite。"

非编程任务

6. 数据分析

"附件是[数据描述]的CSV文件。清理格式问题,计算[指标],
找出表现最好和最差的项目,生成包含关键洞察的摘要,
并基于数据提出3条行动建议。"

7. 微信公众号写作

"写一篇微信公众号文章,主题:[主题]。受众:[描述受众]。
风格:[轻松/专业/幽默]。字数约[X]字。
包含:[内容要求]。结尾设计一个互动引导,鼓励读者留言。"

8. 调研报告

"调研[主题]。现状概述,前[N]个主流选项,各自优缺点,
针对[我的情况]的推荐。以对比表 + 一页摘要呈现。"

9. 自动化脚本

"我每[频率]需要完成[任务]。步骤如下:[列出步骤]。
请编写一个自动化脚本,错误处理方式:[方式]。"

10. 学习计划

"我想在[时间]内学会[技能]。当前水平:[水平]。
每天可用时间:[X小时]。请制定学习计划,包含每周目标、
免费资源推荐、实操练习和阶段性测试。
优先推荐中文资源。"