mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-19 22:08:05 +00:00
docs: add research domains and resource registry
- add local external resources registry - add research domain contract and per-repository research domains - add raw fact snapshot governance and validation scripts Validation: - make test - git diff --check HEAD~1..HEAD Note: - welcome workflow failed because its action input names are stale; core content CI passed.
This commit is contained in:
tradecatlabs
@@ -0,0 +1,475 @@
|
||||
<div align="center">
|
||||
|
||||
# 自然语言编程指南
|
||||
|
||||
中文 | <a href="README_EN.md">English</a>
|
||||
|
||||
</div>
|
||||
|
||||
没有任何代码基础，我在过去三个月借助 ChatGPT 和 Cursor 成功开发了 **6个ios APP** 并上架 App Store，还上线了 **2个完整的网站项目**, 网站代码均已开源：全球旅游攻略平台[Global Travel Guide](https://github.com/wendy7756/globaltravelguide)，精准获客工具[FollowNet](https://github.com/wendy7756/FollowNet)。
|
||||
|
||||
直到现在我仍然不懂编程，但 AI 帮我写了所有代码。借助AI，人人都可以成为独立开发者。正因为亲身体验了 AI 编程的强大力量，我创建了这个开源项目 **Vibe Coding Guide**，希望每个有想法的人都能借助 AI 创造属于自己的产品，让技术不再是创意实现的门槛。
|
||||
|
||||
<div align="center">
|
||||
<img src="my-experience/6apps.jpeg" alt="myapps" width="90%">
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
|
||||
- [什么是Vibe Coding](#什么是vibe-coding)
|
||||
- [核心工作流程](#核心工作流程)
|
||||
- [技术原理与实现](#技术原理与实现)
|
||||
- [主要工具与平台](#主要工具与平台)
|
||||
- [实战教程](#实战教程)
|
||||
- [最佳实践](#最佳实践)
|
||||
- [社区与资源](#社区与资源)
|
||||
- [参考文献](#参考文献)
|
||||
|
||||
## 什么是Vibe Coding
|
||||
|
||||
Vibe Coding 氛围编程由OpenAI联合创始人Andrej Karpathy在2025年提出，将传统的手工码代码转变为与AI的协作对话，强调开发者通过自然语言描述需求，AI生成完整的可运行代码，开发者仅需迭代、反馈、测试即可完成项目开发。
|
||||
|
||||
### 核心定义
|
||||
|
||||
Vibe Coding可以定义为：**开发者通过自然语言（文字或语音）描述需求，AI（大型语言模型）生成完整的可运行代码，开发者通过迭代反馈进入"心流"状态的协作编程方式**。
|
||||
|
||||
### 起源与发展
|
||||
|
||||
Vibe Coding概念由Andrej Karpathy（OpenAI联合创始人、前特斯拉AI负责人）在2025年初提出。他描述这种方法为"完全沉浸在AI的vibe中"，强调：
|
||||
- **自然交互**：用自然语言与AI对话，描述想要的功能
|
||||
- **快速迭代**：AI生成代码，开发者测试和反馈
|
||||
- **心流状态**：开发者专注于创意和逻辑，而非语法细节
|
||||
|
||||
### 技术基础
|
||||
|
||||
Vibe Coding的技术基础包括：
|
||||
- **大型语言模型（LLMs）**：如GPT-4、Claude、Gemini等
|
||||
- **自然语言处理（NLP）**：理解开发者的需求描述
|
||||
- **代码生成技术**：将需求转化为可执行代码
|
||||
- **实时反馈系统**：支持快速迭代和修正
|
||||
|
||||
## 核心工作流程
|
||||
|
||||
Vibe Coding的核心工作流程是一个持续的迭代循环，具体步骤如下：
|
||||
|
||||
### 1. 自然语言描述 (Natural Language Input)
|
||||
|
||||
开发者用自然语言描述需要实现的功能：
|
||||
- **需求描述**：清楚地表达想要的功能和效果
|
||||
- **上下文提供**：给出相关的背景信息和约束条件
|
||||
- **目标明确**：说明期望的输出结果
|
||||
|
||||
**示例**：
|
||||
```
|
||||
"创建一个用户注册页面，包含用户名、邮箱、密码输入框，
|
||||
带有表单验证和提交功能，使用合适的技术栈"
|
||||
```
|
||||
|
||||
### 2. AI代码生成 (AI Code Generation)
|
||||
|
||||
AI分析描述并生成相应的代码：
|
||||
- **需求解析**：理解开发者的意图和要求
|
||||
- **代码生成**：创建完整的可运行代码
|
||||
- **最佳实践**：遵循编程规范和安全标准
|
||||
|
||||
### 3. 执行与观察 (Execute & Observe)
|
||||
|
||||
开发者运行AI生成的代码：
|
||||
- **代码执行**：运行生成的代码查看效果
|
||||
- **功能测试**：验证是否满足预期需求
|
||||
- **问题识别**：发现潜在的bug或改进点
|
||||
|
||||
### 4. 反馈与修正 (Feedback & Refinement)
|
||||
|
||||
根据测试结果提供反馈：
|
||||
- **错误报告**：报告发现的问题和错误
|
||||
- **功能调整**：请求修改或增强功能
|
||||
- **优化建议**：提出性能或用户体验改进
|
||||
|
||||
**示例反馈**：
|
||||
```
|
||||
"按钮颜色应该是蓝色的，密码验证需要包含特殊字符要求"
|
||||
```
|
||||
|
||||
### 5. 迭代循环 (Iteration Loop)
|
||||
|
||||
重复以上过程直到满足需求：
|
||||
- **持续改进**：多轮迭代完善功能
|
||||
- **增量开发**：逐步添加新功能
|
||||
- **质量保证**：确保代码质量和稳定性
|
||||
|
||||
## 技术原理与实现
|
||||
|
||||
### 核心技术架构
|
||||
|
||||
#### 大型语言模型（LLMs）
|
||||
Vibe Coding的核心依赖于先进的大型语言模型：
|
||||
- **GPT-4/GPT-4o**：OpenAI的最新模型，具有强大的代码生成能力
|
||||
- **Claude 4 Sonnet**：Anthropic的高性能模型，擅长复杂推理
|
||||
- **Gemini Pro**：Google的多模态模型，支持文本和图像理解
|
||||
|
||||
#### 自然语言处理流程
|
||||
1. **意图识别**：理解开发者的真实需求
|
||||
2. **上下文分析**：考虑项目背景和约束条件
|
||||
3. **技术选型**：选择合适的技术栈和框架
|
||||
4. **代码生成**：产生结构化的、可运行的代码
|
||||
5. **质量检查**：自动检测潜在问题和改进点
|
||||
|
||||
#### 实时反馈机制
|
||||
- **错误检测**：实时识别语法和逻辑错误
|
||||
- **性能分析**：评估代码效率和优化建议
|
||||
- **安全扫描**：检测潜在的安全漏洞
|
||||
- **最佳实践**：确保代码符合行业标准
|
||||
|
||||
### 实现方式
|
||||
|
||||
#### 基于IDE的集成
|
||||
- **实时补全**：在编辑器中提供智能代码建议
|
||||
- **上下文感知**：理解整个项目的代码结构
|
||||
- **多文件协调**：处理跨文件的代码依赖关系
|
||||
|
||||
#### 对话式开发
|
||||
- **聊天界面**：通过自然语言对话进行开发
|
||||
- **多轮交互**：支持持续的需求澄清和代码改进
|
||||
- **历史记录**：记住之前的对话和决策
|
||||
|
||||
#### 自主代理系统
|
||||
- **任务分解**：将复杂需求分解为可管理的小任务
|
||||
- **自动执行**：AI可以自主完成某些开发步骤
|
||||
- **质量保证**：内置的测试和验证机制
|
||||
|
||||
## 主要工具与平台
|
||||
|
||||
### AI编程助手
|
||||
|
||||
#### 主流AI编程工具
|
||||
- **GitHub Copilot**: GitHub和OpenAI联合开发的AI编程助手
|
||||
- **Cursor**: 基于VS Code的AI原生IDE，支持完整的对话式编程
|
||||
- **Claude Code**: Anthropic的Claude模型，擅长代码生成和调试
|
||||
|
||||
#### 专业编程扩展
|
||||
- **Cline**: VS Code开源扩展，支持计划和执行开发任务
|
||||
- **Roo Code**: 自主开发代理，可以循环执行计划-编码-测试-调试
|
||||
- **Tabnine**: 基于AI的代码补全工具
|
||||
- **CodeWhisperer**: Amazon的AI代码生成服务
|
||||
|
||||
### 对话式开发平台
|
||||
|
||||
#### 无代码AI构建器
|
||||
- **Lovable**: 浏览器内的AI应用构建平台
|
||||
- **Vitara**: 支持自然语言描述的全栈应用生成器
|
||||
- **Bolt.new**: StackBlitz的AI驱动的全栈开发环境
|
||||
- **v0.dev**: Vercel的AI界面生成工具
|
||||
|
||||
#### 专业开发环境
|
||||
- **Replit**: 支持AI协作的云端IDE
|
||||
- **CodeSandbox**: 在线代码编辑器，集成AI助手
|
||||
- **Gitpod**: 云端开发环境，支持AI增强功能
|
||||
|
||||
### 专业化AI工具
|
||||
|
||||
#### 代码审查与测试
|
||||
- **Sweep AI**: 自动生成Pull Request修复的AI工具
|
||||
- **Codium**: AI驱动的测试生成和代码审查工具
|
||||
- **DeepCode**: 基于AI的代码质量分析
|
||||
- **Snyk Code**: AI增强的安全漏洞检测
|
||||
|
||||
#### 项目管理与协作
|
||||
- **Linear**: 集成AI功能的项目管理工具
|
||||
- **Notion AI**: 支持AI协作的文档和项目管理
|
||||
- **GitHub Issues AI**: 自动分析和处理GitHub Issues
|
||||
|
||||
|
||||
## 实战教程
|
||||
|
||||
### 入门教程：你的第一个Vibe Coding项目
|
||||
|
||||
#### 步骤1：选择AI编程工具
|
||||
推荐初学者使用的工具：
|
||||
- **Cursor**: 下载并安装Cursor IDE
|
||||
- **GitHub Copilot**: 在VS Code中安装Copilot扩展
|
||||
- **Claude**: 访问claude.ai进行对话式编程
|
||||
|
||||
#### 步骤2：制定项目提示（Prompt）
|
||||
清晰的需求描述是成功的关键：
|
||||
|
||||
**有效提示示例**：
|
||||
```
|
||||
"我想创建一个待办事项应用，具有以下功能：
|
||||
1. 添加、编辑、删除待办事项
|
||||
2. 标记完成状态
|
||||
3. 按日期排序
|
||||
4. 使用React和Tailwind CSS
|
||||
5. 数据存储在localStorage中
|
||||
6. 包含深色模式切换"
|
||||
```
|
||||
|
||||
#### 步骤3：与AI对话开发
|
||||
开始与AI的协作开发过程：
|
||||
|
||||
**对话流程**：
|
||||
1. **初始需求**：描述你想要的应用
|
||||
2. **AI回应**：AI生成代码框架
|
||||
3. **运行测试**：执行生成的代码
|
||||
4. **反馈修正**：报告问题或提出改进
|
||||
5. **迭代优化**：重复直到满意
|
||||
|
||||
**示例对话**：
|
||||
```
|
||||
你: "帮我创建一个简单的计算器应用"
|
||||
AI: [生成HTML+CSS+JavaScript代码]
|
||||
你: "按钮太小了，能否增大一些？"
|
||||
AI: [修改CSS样式，增大按钮尺寸]
|
||||
你: "添加键盘支持"
|
||||
AI: [添加键盘事件监听器]
|
||||
```
|
||||
|
||||
#### 步骤4：优化和部署
|
||||
完善项目并部署：
|
||||
|
||||
**优化检查清单**：
|
||||
- [ ] 功能完整性测试
|
||||
- [ ] 响应式设计验证
|
||||
- [ ] 性能优化检查
|
||||
- [ ] 错误处理完善
|
||||
- [ ] 代码质量审查
|
||||
|
||||
**部署选项**：
|
||||
- **Vercel**: 最适合React/Next.js应用
|
||||
- **Netlify**: 静态网站部署
|
||||
- **GitHub Pages**: 免费的静态托管
|
||||
|
||||
### 进阶教程：复杂项目的Vibe Coding
|
||||
|
||||
#### 项目分解策略
|
||||
将大型项目分解为可管理的模块：
|
||||
|
||||
1. **用户界面层**：
|
||||
```
|
||||
"创建应用的主要布局，包含导航栏、侧边栏和主内容区域"
|
||||
```
|
||||
|
||||
2. **数据层**：
|
||||
```
|
||||
"设计用户数据模型，包括注册、登录和个人资料管理"
|
||||
```
|
||||
|
||||
3. **业务逻辑层**：
|
||||
```
|
||||
"实现核心功能逻辑，如搜索、过滤和数据处理"
|
||||
```
|
||||
|
||||
#### 多轮对话管理
|
||||
保持上下文连续性的技巧：
|
||||
|
||||
**上下文提示**：
|
||||
```
|
||||
"基于之前创建的用户认证系统，现在添加密码重置功能"
|
||||
```
|
||||
|
||||
**引用之前的代码**：
|
||||
```
|
||||
"修改我们之前讨论的登录组件，添加'记住我'选项"
|
||||
```
|
||||
|
||||
#### 代码审查与重构
|
||||
使用AI进行代码优化：
|
||||
|
||||
**重构提示**：
|
||||
```
|
||||
"请审查这段代码的性能和可维护性，并提供改进建议"
|
||||
```
|
||||
|
||||
**安全检查**：
|
||||
```
|
||||
"检查这个用户输入处理代码是否存在安全漏洞"
|
||||
```
|
||||
|
||||
## 最佳实践
|
||||
|
||||
### 有效提示工程
|
||||
|
||||
#### 1. 清晰的需求描述
|
||||
好的提示应该具备以下特征：
|
||||
- **具体明确**：避免模糊的表述，提供具体的功能需求
|
||||
- **技术栈说明**：明确指定想要使用的技术和框架
|
||||
- **约束条件**：说明性能、兼容性等限制条件
|
||||
- **预期结果**：描述期望的最终效果
|
||||
|
||||
**示例对比**：
|
||||
```
|
||||
❌ 糟糕的提示：
|
||||
"做一个网站"
|
||||
|
||||
✅ 好的提示：
|
||||
"使用React和Tailwind CSS创建一个响应式的个人博客网站，
|
||||
包含文章列表、详情页面、搜索功能，支持Markdown渲染"
|
||||
```
|
||||
|
||||
#### 2. 迭代式开发
|
||||
- **小步快跑**：每次只要求实现一个小功能
|
||||
- **逐步完善**：基于前一步的结果提出改进
|
||||
- **保持上下文**：在对话中引用之前的代码
|
||||
|
||||
|
||||
### 常见问题与解决方案
|
||||
|
||||
#### 1. AI生成代码质量差
|
||||
**问题**：代码存在bug或不符合最佳实践
|
||||
**解决方案**：
|
||||
- 提供更具体的技术要求
|
||||
- 分步骤生成，逐步完善
|
||||
- 结合人工审查和修正
|
||||
|
||||
#### 2. 上下文丢失
|
||||
**问题**：AI忘记了之前的对话内容
|
||||
**解决方案**：
|
||||
- 在新的对话中重新提供关键信息
|
||||
- 使用代码注释记录设计决策
|
||||
- 保持对话的连续性
|
||||
|
||||
#### 3. 过度依赖AI
|
||||
**问题**：团队成员缺乏基础编程能力
|
||||
**解决方案**：
|
||||
- 平衡AI使用和传统学习
|
||||
- 定期进行技术培训
|
||||
- 建立代码审查机制
|
||||
|
||||
## 社区与资源
|
||||
|
||||
### 学习资源
|
||||
|
||||
#### Vibe Coding专门资源
|
||||
- **Vibe Coding Guide**: [https://ai-hive.net/datacenters/vibe-coding](https://ai-hive.net/datacenters/vibe-coding)
|
||||
- **Andrej Karpathy的博客**: [https://karpathy.ai](https://karpathy.ai)
|
||||
- **MIT Technology Review**: [Vibe Coding解释](https://www.technologyreview.com/2025/04/16/1115135/what-is-vibe-coding-exactly/)
|
||||
|
||||
#### AI编程教程
|
||||
- **Prompt Engineering指南**: [https://www.promptingguide.ai](https://www.promptingguide.ai)
|
||||
- **OpenAI Cookbook**: [https://cookbook.openai.com](https://cookbook.openai.com)
|
||||
- **Anthropic的Claude文档**: [https://docs.anthropic.com](https://docs.anthropic.com)
|
||||
|
||||
#### 视频教程
|
||||
- **Cursor IDE教程**: YouTube上的官方教程
|
||||
- **GitHub Copilot最佳实践**: Microsoft Learn
|
||||
- **AI编程技巧**: Fireship, Code with Antonio
|
||||
|
||||
#### 技术博客
|
||||
- **Google Cloud AI Blog**: [https://cloud.google.com/blog/topics/ai-ml](https://cloud.google.com/blog/topics/ai-ml)
|
||||
- **Hugging Face Blog**: [https://huggingface.co/blog](https://huggingface.co/blog)
|
||||
- **OpenAI Research**: [https://openai.com/research](https://openai.com/research)
|
||||
|
||||
### 开源项目
|
||||
|
||||
#### Vibe Coding相关项目
|
||||
- **Aider**: [https://github.com/paul-gauthier/aider](https://github.com/paul-gauthier/aider) - 命令行AI编程助手
|
||||
- **Cline**: [https://github.com/cline/cline](https://github.com/cline/cline) - VS Code自主开发扩展
|
||||
- **Devin**: [https://github.com/Cognition-AI/devin](https://github.com/Cognition-AI/devin) - AI软件工程师
|
||||
|
||||
#### 提示工程库
|
||||
- **LangChain**: [https://github.com/langchain-ai/langchain](https://github.com/langchain-ai/langchain)
|
||||
- **Guidance**: [https://github.com/guidance-ai/guidance](https://github.com/guidance-ai/guidance)
|
||||
- **Promptflow**: [https://github.com/microsoft/promptflow](https://github.com/microsoft/promptflow)
|
||||
|
||||
### 社区平台
|
||||
|
||||
#### 讨论社区
|
||||
- **Reddit r/MachineLearning**: AI编程讨论
|
||||
- **Discord服务器**: Cursor IDE, GitHub Copilot官方群
|
||||
- **Stack Overflow**: AI编程相关问题
|
||||
|
||||
#### 开发者社区
|
||||
- **Hugging Face Community**: [https://huggingface.co/community](https://huggingface.co/community)
|
||||
- **OpenAI Community**: [https://community.openai.com](https://community.openai.com)
|
||||
- **GitHub Discussions**: 各大AI编程工具的讨论区
|
||||
|
||||
### 工具与平台
|
||||
|
||||
#### AI编程工具
|
||||
- **Cursor**: [https://cursor.sh](https://cursor.sh)
|
||||
- **GitHub Copilot**: [https://github.com/features/copilot](https://github.com/features/copilot)
|
||||
- **Windsurf**: [https://codeium.com/windsurf](https://codeium.com/windsurf)
|
||||
- **Replit**: [https://replit.com](https://replit.com)
|
||||
|
||||
#### 在线IDE
|
||||
- **CodeSandbox**: [https://codesandbox.io](https://codesandbox.io)
|
||||
- **StackBlitz**: [https://stackblitz.com](https://stackblitz.com)
|
||||
- **Gitpod**: [https://gitpod.io](https://gitpod.io)
|
||||
|
||||
#### 部署平台
|
||||
- **Vercel**: [https://vercel.com](https://vercel.com)
|
||||
- **Netlify**: [https://netlify.com](https://netlify.com)
|
||||
- **Railway**: [https://railway.app](https://railway.app)
|
||||
|
||||
## 参考文献
|
||||
|
||||
### 核心文献
|
||||
|
||||
1. **Karpathy, A.** (2025). *Vibe Coding: A New Programming Paradigm*. OpenAI Blog.
|
||||
2. **Chen, M., et al.** (2021). *Evaluating Large Language Models Trained on Code*. arXiv:2107.03374.
|
||||
3. **Austin, J., et al.** (2021). *Program Synthesis with Large Language Models*. arXiv:2108.07732.
|
||||
4. **Li, Y., et al.** (2022). *Competition-Level Code Generation with AlphaCode*. Science, 378(6624), 1092-1097.
|
||||
5. **Nijkamp, E., et al.** (2022). *CodeGen: An Open Large Language Model for Code Generation*. arXiv:2203.13474.
|
||||
|
||||
### 技术研究
|
||||
|
||||
6. **Fried, D., et al.** (2023). *InCoder: A Generative Model for Code Infilling and Synthesis*. ICLR 2023.
|
||||
7. **Wang, Y., et al.** (2023). *CodeT5+: Open Code Large Language Models for Code Understanding and Generation*. arXiv:2305.07922.
|
||||
8. **Rozière, B., et al.** (2023). *Code Llama: Open Foundation Models for Code*. arXiv:2308.12950.
|
||||
9. **Zheng, S., et al.** (2024). *SWE-RL: Training Code Generation Models with Reinforcement Learning from Software Engineering Feedback*. arXiv:2401.03994.
|
||||
|
||||
### 行业报告
|
||||
|
||||
10. **Y Combinator** (2025). *AI-Generated Codebases in Startup Ecosystem*. YC Research.
|
||||
11. **GitHub** (2024). *GitHub Copilot Impact Report: Developer Productivity Study*. GitHub Inc.
|
||||
12. **McKinsey & Company** (2024). *The Economic Impact of AI-Assisted Programming*. McKinsey Global Institute.
|
||||
13. **Stack Overflow** (2024). *Developer Survey: AI Tools in Programming*. Stack Overflow Insights.
|
||||
|
||||
### 网络资源
|
||||
|
||||
#### 官方文档
|
||||
- **OpenAI Codex**: [https://openai.com/blog/openai-codex](https://openai.com/blog/openai-codex)
|
||||
- **GitHub Copilot Documentation**: [https://docs.github.com/en/copilot](https://docs.github.com/en/copilot)
|
||||
- **Anthropic Claude for Coding**: [https://docs.anthropic.com/claude/docs/coding](https://docs.anthropic.com/claude/docs/coding)
|
||||
|
||||
#### 研究机构
|
||||
- **MIT CSAIL**: [https://www.csail.mit.edu](https://www.csail.mit.edu)
|
||||
- **Stanford HAI**: [https://hai.stanford.edu](https://hai.stanford.edu)
|
||||
- **Google Research**: [https://research.google](https://research.google)
|
||||
|
||||
#### 技术博客
|
||||
- **The Pragmatic Engineer**: [https://blog.pragmaticengineer.com](https://blog.pragmaticengineer.com)
|
||||
- **Towards Data Science**: [https://towardsdatascience.com](https://towardsdatascience.com)
|
||||
- **AI Research**: [https://ai.googleblog.com](https://ai.googleblog.com)
|
||||
|
||||
#### 学术数据库
|
||||
- **arXiv Computer Science**: [https://arxiv.org/list/cs/recent](https://arxiv.org/list/cs/recent)
|
||||
- **ACM Digital Library**: [https://dl.acm.org](https://dl.acm.org)
|
||||
- **IEEE Xplore**: [https://ieeexplore.ieee.org](https://ieeexplore.ieee.org)
|
||||
|
||||
#### 开源项目
|
||||
- **Hugging Face Code Models**: [https://huggingface.co/models?pipeline_tag=text-generation&other=code](https://huggingface.co/models?pipeline_tag=text-generation&other=code)
|
||||
- **Papers with Code**: [https://paperswithcode.com/task/code-generation](https://paperswithcode.com/task/code-generation)
|
||||
- **Awesome AI for Code**: [https://github.com/sourcegraph/awesome-ai-coding](https://github.com/sourcegraph/awesome-ai-coding)
|
||||
|
||||
---
|
||||
|
||||
## 贡献指南
|
||||
|
||||
欢迎为本指南贡献内容！请遵循以下步骤：
|
||||
|
||||
1. Fork 本仓库
|
||||
2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
|
||||
3. 提交更改 (`git commit -m 'Add some amazing feature'`)
|
||||
4. 推送到分支 (`git push origin feature/amazing-feature`)
|
||||
5. 创建 Pull Request
|
||||
|
||||
## 许可证
|
||||
|
||||
本项目采用 Apache License 2.0 许可证。详情请参阅 [LICENSE](LICENSE) 文件。
|
||||
|
||||
---
|
||||
|
||||
*让编程成为一种美的享受。*
|
||||
Reference in New Issue
Block a user