前言

Vibe Coding（氛围编程）是由 Andrej Karpathy 定义的全新开发范式。它主张以自然语言为驱动力，将繁琐的编码交给 AI，开发者则回归“创造”。其核心逻辑是：先有成品，再论细节。这种方式极大提高了开发效率，让开发者从"码喽”中脱离出来。不再受困于日常开发的繁琐，而是专注于需求对齐和系统架构，做更有价值的事情。

以下是我总结的目前常见的vibecoding开发原则：

原则	一句话记忆
胶水编程	能抄不写，能连不造
规划驱动	先规划后执行，文档即上下文
上下文优先	垃圾进，垃圾出
模块化	先结构后代码，接口先行
单一事实来源	白板即真相，代码即衍生物
数据与函数	程序 = 数据 + 函数
可证伪	测试驱动，预期vs实际
人下AI上	人从瓶颈变调度者
迭代收敛	正反合三段进化
实体-链接-功能	系统思考三要素

原则一：胶水编程原则（Glue Coding）

能抄不写，能连不造，能复用不原创

• 不再让 AI 从零生成代码（幻觉的根源）
• 只复用成熟的、经过生产验证的开源项目
• AI 的唯一职责：理解意图，将模块连接起来
• 你的唯一职责：描述清楚「输入是什么，输出要什么」

核心理念：从「生成」到「连接」的根本性转变

---

原则二：规划驱动原则

规划先行，文档即上下文，不是事后补

• 执行之前：10分开发，7分找资料，先找全部需要的资料和AI充分讨论对齐
• 先让 AI 出方案，确认后再写代码
• 每完成一个重大功能或里程碑后，必须更新架构文档
• 实施计划必须包含：分步指令 + 验证测试
  

---

原则三：上下文优先原则

上下文是 Vibe Coding 的第一性要素，垃圾进，垃圾出

• 明确任务中的：目的、对象、约束
• 提供完整错误信息，说明运行环境
• 用具体例子说明需求，给输入输出示例
• 定期开新对话，保持上下文干净
  

---

原则四：模块化与接口先行原则

先结构后代码，接口先行，实现后补

• 按职责拆模块，保持高内聚、低耦合
• 明确写清：能改什么，不能改什么
• API 是契约，实现是细节
• 不破坏契约，就是负责
  

---

原则五：单一事实来源原则

Canvas白板 / 架构文档 = 唯一真相源，代码只是它的序列化形式

• 传统：代码 → 文档（过期） → 架构图（更过期）
• Vibe Coding：白板/文档 ⇄ 代码 ⇄ AI ⇄ 人类
• AI直接读白板JSON，秒懂架构
• 指着白板讲，新人5分钟看懂
  

---

原则六：数据与函数本质原则

程序 = 数据 + 函数；状态决定世界形态，变换刻画过程

• 数据是事实，函数是意图
• 输入 → 处理 → 输出
• 状态越少，程序越稳
• 程序不是操作，而是连续的变化
  

---

原则七：可证伪与测试驱动原则

把"看起来对"变成"暂时无法证伪"

• 每个关键断言都要配一个能让它失败的测试
• Debug 只给：预期 vs 实际 + 最小复现
• 测试可交给 AI，断言人审
• 可推理性优于性能
  

---

原则八：人下AI上原则

人从执行者变为调度者，一切问题问 AI

• 人不再是瓶颈，AI 自主协作
• 目的主导：开发过程中的一切动作围绕"目的"展开
• 系统性思考，从「实体、链接、功能/目的」开始
• 重复，多尝试几次
  

---

原则九：迭代与收敛原则

正反合三段迭代：快速可用 → 反例打脸 → 收敛为工程版本

• 正：只做 main path，让它跑通
• 反：列失败模式，用测试与基准逼出反例
• 合：重构接口/收敛依赖/补文档，形成下一轮稳定起点
• 根据新证据动态调整信念（贝叶斯更新）
  

---

原则十：实体-链接-功能原则

系统性思考，从实体、链接、功能/目的开始

• 实体 (Entity)：成熟的开源项目、官方 SDK、久经考验的库
• 链接 (Link)：AI 生成的胶水代码，负责数据流转和接口适配
• 功能 (Function)：你描述的业务目标

架构哲学：

业务需求 → AI胶水层 → 成熟模块A + 成熟模块B + 成熟模块C