手把手教你学 AI Coding · 中文教程

手把手教你学 AI Coding · 中文教程

从工具选型到 Agent 实战:把 AI 变成你的编程搭档

这本教程讲什么

本教程是一份体系化的 AI 编程(AI Coding)中文教程,面向想用 AI 工具提升开发效率的程序员。教程从主流 AI 编程环境的选型与配置讲起,深入 Prompt Engineering 在编程场景的实战应用,再剖析两大核心机制——MCP(Model Context Protocol) 如何让 AI 安全连接外部工具与数据、Skills 与项目规范如何把团队经验注入 AI 的每一次生成——最终以一个完整的全栈项目实战收尾,走通「需求 → 架构 → 生成 → Debug → 上线」的完整闭环。

教程覆盖当前最主流的 AI 编程环境:Cursor(热度最高的 AI-native IDE)、VS Code + Copilot / Cline(经典生态 + 开源 Agent)、Windsurf(Cascade 多步推理)、Replit Agent(云端全栈),以及国产三强 Qoder CN(阿里)、CodeBuddy / WorkBuddy(腾讯)、ZCode(智谱)。不止教「按钮在哪」,更讲透「为什么这样设计」和「怎么用才高效」。

文件组织:本教程为原创内容,按「支柱页 + 子节」结构组织,每章先读支柱页建立全局观,再逐节深入。详细写作规范见同目录「PLAN.md」。

五章学习路径一览

本教程按「选工具 → 学对话 → 懂机制(MCP) → 懂机制(Skills/RAG) → 实战大项目」的递进逻辑组织:

第 1 章 AI 编程新时代 ── 选对你的 AI 编程搭档
   演变历程 · 工具横评 · Cursor 配置 · VS Code 生态 · Windsurf 与云端 · 国产生态
        │
第 2 章 基础操作与对话艺术 ── 精准描述需求是第一生产力
   Prompt 原则 · Chat vs Inline · Composer 多文件编辑 · 需求描述模板
        │
第 3 章 核心机制:MCP 协议详解 ── 让 AI 安全连接外部世界
   MCP 是什么 · Client-Server 架构 · 配置实战 · 文件系统与搜索 · 自定义 Server
        │
第 4 章 核心机制:Skills 与项目规范 ── 把经验变成 AI 的肌肉记忆
   为什么需要 Skills · .cursorrules · RAG 与代码库感知 · 构建专属助手
        │
第 5 章 高阶实战:从零构建全栈项目 ── 一个闭环串起全部
   需求分析 · 项目初始化 · 迭代开发 · Debug 修复 · 工作流总结
​

如果你是第一次接触 AI 编程,从第 1 章读起;如果你已经在用 Cursor 但想提效,重点看第 2 章和第 4 章;如果你对 MCP 这个新协议好奇,直接跳第 3 章;想直接看实战,第 5 章等你。

章节目录

第 1 章 AI 编程新时代
从 Copilot 到 Agent 的三阶段演变;Cursor / VS Code + Copilot + Cline / Windsurf / Replit Agent 四大海外环境 + Qoder CN / CodeBuddy / ZCode 三大国产新势力横向对比(定位、核心机制、适用场景、价格);Cursor 深度配置(Tab / Cmd+K / Composer / Agent 模式);VS Code 生态搭建;Windsurf Cascade 与云端 IDE;国产 AI 编程生态深度解析。读完你能选对工具并配好环境。

第 2 章 基础操作与对话艺术
编程场景的 Prompt Engineering 核心原则(角色 / 上下文 / 约束 / 分步);Chat 模式与 Inline Edit 的使用时机;Cursor Composer 与 Windsurf Cascade 的多文件编辑逻辑;从模糊需求到精准 Prompt 的转化模板。读完你能用自然语言高效驱动 AI 写代码。

第 3 章 核心机制:MCP 协议详解
Model Context Protocol 的设计动机与核心概念;Host / Client / Server 三层架构与传输层(stdio / SSE);在 Cursor / VS Code / Windsurf 中配置 MCP Server 的方法与关键配置项;实战接入文件系统与搜索服务;用 Python / TypeScript SDK 开发自定义 MCP Server。读完你能让 AI 安全、标准化地访问任意外部资源。

第 4 章 核心机制:Skills 与项目规范
AI 默认行为的局限与 Skills 的价值;.cursorrules / .windsurfrules / Cline custom instructions 的配置机制;RAG 与代码库感知——向量嵌入、代码索引、@codebase 检索流程;实战为 FastAPI 后端和 React 前端项目定制专属 AI 编程助手。读完你能把团队规范和个人经验注入 AI 的每一次生成。

第 5 章 高阶实战:从零构建全栈项目
用 AI 做需求拆解与架构设计;Agent 模式搭建项目脚手架;多轮对话迭代开发与复杂依赖处理;AI 辅助 Debug 的完整工作流;从需求到上线的效率飞轮总结。读完你能独立用 AI Agent 完成一个生产级全栈项目。

适合读者

本教程适合有编程基础、想用 AI 工具大幅提升开发效率的开发者:

• 刚接触 AI 编程、想系统了解工具生态的新手
• 已在用 Copilot 补全、想进阶到 Agent 模式的中级开发者
• 对 MCP 协议、代码 RAG 等底层机制好奇的技术探索者
• 想在团队中推广 AI 编程规范的技术负责人
• 准备用 AI 独立完成全栈项目的独立开发者

前置知识:

• 至少熟悉一门编程语言(Python / JavaScript / TypeScript 任一)
• 基本的命令行操作经验
• 有 VS Code 或其他 IDE 的使用经验
• 不需要 AI / 机器学习背景——本教程从应用层讲起

版本与更新

本教程内容基于 2026 年中的各工具版本撰写。AI 编程工具迭代极快(Cursor 几乎每周更新),若你使用的版本与教程有差异,请以工具官方文档为最终依据。教程侧重讲解机制与原理(MCP 协议、RAG 检索、Skills 注入),这些底层逻辑不会因 UI 改版而失效。