Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Vibe Coding 实战指南

用 AI 加速开发,7 天从想法到上线


📖 关于本指南

这是一份基于真实项目(KnowFun 知识付费平台)的 Vibe Coding 实战手册。

🎯 本指南特点

  • 100% 真实:所有数据、案例均来自真实行业洞察,拒绝虚构
  • 实战导向:以 KnowFun 项目为载体,从 0 到 1 完整实现
  • 方法论驱动:每章标注核心方法论,理解“为什么“而非死记硬背
  • 极简主义:只讲做产品需要的 20% 知识,砍掉 90% 不必要的理论
  • 完全免费:使用 Vercel + Supabase,部署成本 $0/月

💡 什么是 Vibe Coding?

Vibe Coding(氛围编程) = 用自然语言(人话)告诉 AI 你想要什么,AI 帮你生成代码。

你不需要:

  • ❌ 背诵所有语法
  • ❌ 手敲每一行代码
  • ❌ 精通底层原理

你需要:

  • ✅ 清楚地描述需求
  • ✅ 审查 AI 生成的代码
  • ✅ 调试和优化功能
  • ✅ 把产品上线

🚀 快速开始

第一步:了解时代背景

👉 时代背景:AI 时代如何加速学习

核心洞察

  • 24.8% 的大学毕业生面临被 AI 替代的风险
  • 埃森哲投入 8.65 亿美元培训员工用 AI
  • 培训范式从“测-评-考-练-学“转向“问/练“

用时:15 分钟 收获:理解为什么要学 Vibe Coding


第二步:明确学习目标

👉 一人开发者需要学什么

核心能力

  • 独当一面:从需求到交付的完整链路
  • 工作流驱动:拆解任务 → AI 赋能 → 测试优化
  • 警惕低维度努力陷阱:做 1 个真实项目 > 10 个 TodoList

用时:20 分钟 收获:明确技能树和学习路径


第三步:配置开发环境

👉 Claude Code 如何使用 👉 Prompt 如何有效快速入门

用时:30 分钟 收获:可运行的 AI 编程环境


📚 完整目录

第一部分:方法论与心态(已完成 ✅)

建立正确的开发心态,理解 Vibe Coding 的底层逻辑。

交付物:正确的心态和学习方法


第二部分:工具入门(编写中 🚧)

掌握 Claude Code、Cursor 等 AI 编程工具的使用方法。

交付物:能用 AI 生成第一行代码


第三部分:网页开发基础知识(规划中 📋)

快速掌握前端、后端、运维的核心概念。

  • 2.1 前端开发基础(Next.js + Tailwind CSS)
  • 2.2 后端开发基础(FastAPI + PostgreSQL)
  • 2.3 运维部署基础(Vercel + 域名配置)

交付物:理解网站如何运作

核心方法论

不求精通,但求能跑
先用 AI 生成,再理解原理
复制粘贴 > 从零编写

第四部分:工具配置(规划中 📋)

学会部署、域名绑定、支付接入等生产环境配置。

  • 3.1 Vercel 部署配置
  • 3.2 域名购买与配置
  • 3.3 支付插件接入(Stripe)

交付物:有域名的线上产品 + 可收费的支付系统

核心方法论

安全 = 使用大厂组件(不要自己造轮子)
部署 = Git Push(自动化 CI/CD)
支付 = 跑通核心链路(购买→成功→增加积分)

第五部分:实战项目(规划中 📋)

完整实现 KnowFun 知识付费平台。

  • 4.1 项目介绍:KnowFun 知识付费平台
  • 4.2 从 0 到 1:完整开发流程
  • 4.3 功能实现与代码讲解

交付物:可上线运营的完整产品

项目功能

  • 用户注册登录(Supabase Auth)
  • 内容上传与展示
  • 积分购买(Stripe 支付)
  • AI 文档解析(Claude API)
  • 内容广场与推荐

第六部分:问题与调试(规划中 📋)

常见问题速查表,遇到问题快速定位解决。

  • 5.1 常见报错与解决方案
  • 5.2 开发环境问题
  • 5.3 部署上线问题

交付物:问题解决能力


第七部分:AI 资讯与扩展(规划中 📋)

持续更新的 AI 工具推荐和行业动态。

  • 6.1 AI 工具推荐
  • 6.2 行业动态与趋势
  • 6.3 学习资源汇总

附录:工具箱(规划中 📋)

提示词模板、代码片段、术语表等速查资源。

  • A1. Prompt 提示词模板库
  • A2. 常用代码片段
  • A3. 工具速查手册
  • A4. 术语表

🎯 学习路径

路径 1:完整学习(推荐 7 天)

适合 0 基础学员,完整掌握 Vibe Coding 开发流程。

Day 1: 第一部分(方法论)
Day 2: 第二部分(工具入门)
Day 3: 第三部分(前端基础)
Day 4: 第三部分(后端基础)
Day 5: 第四部分(工具配置)
Day 6: 第五部分(实战项目)
Day 7: 第六部分(部署上线)

路径 2:快速上手(3-5 天)

适合有编程基础的学员。

Day 1: 第一部分 + 第二部分
Day 2: 第三部分(前后端)
Day 3: 第四部分 + 第五部分
Day 4-5: 优化和扩展

路径 3:模板改造(1-2 天)

适合快速验证想法的学员。

Day 1: 克隆项目模板 + 配置环境
Day 2: 修改为自己的产品 + 部署上线

💡 核心方法论

1. 工作流驱动 > 工具驱动

❌ 错误:学完所有 Prompt 技巧再开始做 ✅ 正确:在做项目的过程中,遇到问题就问 AI

2. 认知到位 = 彪悍执行

❌ 错误:看完教程 = 学会了 ✅ 正确:做出来 = 真正理解了

3. 独当一面 > 精通某个技术

❌ 错误:深入学习 React 的所有特性 ✅ 正确:能用 React + AI 做出能上线的产品

4. 真实项目 > 入门教程

❌ 错误:做 10 个 TodoList ✅ 正确:做 1 个真实的知识付费平台


📊 成本预估

开发成本

  • Claude Code: 免费(有 API 配额)
  • Claude API: 按使用付费(开发阶段成本低)
  • 开发工具: 全部免费开源

部署成本(每月)

服务用途免费额度预估成本
Vercel前端托管100GB 流量$0
Supabase数据库+Auth500MB 数据库+1GB 存储$0
Stripe支付无限次2.9%+$0.3/笔

总计: $0/月(不含支付手续费)


🛠 技术栈

为什么选择这套技术栈?

1. AI 最懂

  • GitHub 上开源代码最多
  • Claude 对这些技术的理解最深
  • 生成的代码质量最高

2. 学习曲线平缓

  • Next.js: React 框架,开箱即用
  • FastAPI: Python 最快的 Web 框架
  • Supabase: Firebase 开源替代,易用

3. 完全免费部署

  • Vercel: 免费托管 Next.js
  • Supabase: 免费数据库+Auth+Storage
  • 总成本: $0/月

技术栈清单

前端: Next.js 14 + Tailwind CSS + shadcn/ui
后端: FastAPI + PostgreSQL + SQLAlchemy
部署: Vercel + Supabase
工具: Claude Code + MCP + Playwright

🎓 前置要求

  • 一台电脑(Windows/Mac/Linux)
  • 会打字和使用浏览器
  • 每天 1-2 小时时间
  • 愿意动手实践的心态

不需要

  • ❌ 编程基础
  • ❌ 计算机专业背景
  • ❌ 英语很好

📖 阅读建议

如何阅读本指南

  1. 不要跳章:每章都有依赖关系,建议按顺序学习
  2. 动手实践:看完一章立即实践,不要只看不做
  3. 记录问题:遇到问题先 Google/问 AI,解决不了再深入研究
  4. 复用代码:附录提供完整代码模板,优先复用

每章结构

章节标题
├── 方法论标注(核心思想)
├── 为什么要这样做?(原理)
├── 怎么做?(步骤)
├── 实战演练(基于 KnowFun)
├── 常见问题(FAQ)
└── 小结(交付物+下一步)

📄 许可证

CC BY-NC-SA 4.0

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。

您可以自由地:

  • 分享 — 在任何媒介以任何形式复制、发行本作品
  • 演绎 — 修改、转换或以本作品为基础进行创作

惟须遵守下列条件:

  • 📝 署名 — 您必须给出适当的署名,提供指向本许可协议的链接,同时标明是否对原作品作了修改
  • 💼 非商业性使用 — 您不得将本作品用于商业目的(包括但不限于:付费课程、商业培训、出版销售等)
  • 🔄 相同方式共享 — 如果您对本作品进行了修改、转换或以其为基础创作,您必须以相同的许可协议分发您的作品

完整许可证

详细的许可证条款请参阅 LICENSE 文件或访问 Creative Commons 官网


🙏 致谢

本指南受以下项目启发:


📌 版本信息

  • 当前版本: v0.2.0
  • 最后更新: 2025-11-21
  • 维护状态: 🟢 活跃维护中
  • 完成进度: 第一部分(方法论)✅ | 第二部分(工具)🚧 | 其他部分 📋

🚀 开始学习

准备好了吗?

👉 第一步:了解时代背景

记住

不追求完美,只追求能跑通 不死记语法,只理解方法论 不重复造轮子,善用 AI 和开源


💬 反馈与建议

如果你在学习过程中遇到问题,或者有任何建议,欢迎:

  • 📧 通过 Issue 反馈问题
  • 💬 在社群中讨论交流
  • ⭐ 给项目点个 Star 支持我们

让我们一起用 AI 加速开发,把想法变成现实!