VibeCraft Vibe Coding 实战指南
实时检索字典 20+ 核心概念 高频 FAQ

核心术语百科与高频踩坑 FAQ

看懂技术文档与 AI 对话里的高频英文黑话,踩坑时就能一句话精准定位问题所在。

1. 核心术语速查表(支持关键词实时筛选)

术语大白话解释工程实战注意点
Vibe Coding通过自然语言指挥 AI 完成编码与迭代的编程方式人负责需求规格、边界把控与实测验收,不盲目托管安全逻辑
Context Window上下文窗口,模型单次对话能“记住”的最大字数上限超过 20 轮或贴入大段无关日志后记忆会退化,及时总结并开新对话
Agentic LoopAI 自主循环:思考 → 查文件 → 改代码 → 跑终端验证 → 修复报错给 AI 明确测试命令时,它才能真正形成自愈闭环
MCPModel Context Protocol,给 AI 连接数据库/浏览器/文档的标准接口优先用来只读查表、自动抓控制台报错,减少人工搬运上下文
AGENTS.md / CLAUDE.md放在项目根目录的“AI 入职手册与编码铁律”写清技术栈、目录位置、常用测试命令和禁止事项
Schema First先写死数据库表结构和 API 接口字段,再写页面和业务逻辑避免前后端各自起名导致联调大面积报错
Vertical Slice纵向切片:每次做出一条从界面到数据库的完整可用小功能每完成一个切片就验收+提交 Git,绝不一次堆几十个半成品文件
Hallucination(幻觉)AI 自信地编造不存在的库名、API 参数或文件路径要求修改前先读取真实文件;安装新依赖前先查官方源是否存在
Git Worktree同一个代码仓库同时展开多个独立工作目录可让多个 Agent 并行写不同特性分支而不互相覆盖文件
CORS浏览器的同源安全拦截机制(不同端口或域名调接口被拒)前后端同源部署(同域同端口)或后端正确配置 allow_origins
Hydration(水合)SSR 框架在浏览器把服务端预渲染 HTML 重新接管为可交互页面的过程避免在首屏渲染直接读 window、localStorage 或随机时间
SSEServer-Sent Events,服务器向浏览器单向持续推送文本流的协议AI 打字机流式回复标配;Nginx 反代记得加 proxy_buffering off
IDOR 越权改一下 URL 里的数字 ID 就能看或删别人的数据后端查改删必须同时校验 AND user_id = current_user.id
SSRF诱导服务器去请求内网地址或云主机元数据接口服务器替用户访问外部 URL 前,必须解析并拦截私有/回环 IP
DNS-01通过在域名 DNS 添加 TXT 验证记录来签发 HTTPS 证书的方式不需要开放 80 端口,非常适合自动化证书续期与泛域名证书

2. 高频踩坑问答(点击展开)

Q1:为什么我让 AI 修一个小样式,它却把我原有功能弄坏了?

因为没限定修改范围、或单文件已经膨胀到上千行导致重写漏行。每次提需求时加上一句:“只修改与目标样式相关的组件/CSS,严禁改动现有事件绑定与业务逻辑,保留原有注释”,并保持单文件不超过 300 行。

Q2:AI 连续修 3 次同一个报错还是不行,该怎么办?

立刻停下,不要进行第 4 次盲改!先用 git checkout -- . 退回修改前干净代码,然后让 AI 写一段 10 行诊断脚本打印真实参数与返回值,确认根因后再重来;或者把报错栈与相关代码摘要带进一个全新的干净对话窗口。

Q3:网页端生成平台(Bolt/v0/Lovable)和本地 IDE(Cursor/Claude Code)怎么配合?

最佳配合是:先用 v0 / Lovable 在 10 分钟内敲定好看的页面风格与交互原型,把代码下载到本地仓库,然后立刻切换回 Cursor / Claude Code 接管数据库、接口鉴权、测试脚本和 Docker 上线。

Q4:完全不懂运维,怎么把做好的小网站安全放到公网?

两条路:纯静态页面或轻量 Next.js 可以直接托管到 Cloudflare Pages / Vercel;需要跑 Python 后端和 SQLite 数据库的,按第 10 章模板用 Docker 把端口绑在 127.0.0.1,再由宿主机 Nginx + HTTPS 证书对外转发即可。

Q5:怎么确保 AI 不会偷偷把我的数据库删掉或者执行危险命令?

养成 3 个保护习惯:1. 开发环境永远使用独立的本地测试数据库,不连生产库;2. 重要数据定期自动备份;3. 在命令行 Agent 里关闭危险命令的自动免确认放行,涉及 rm -rf、DROP TABLE、修改生产防火墙前必须人工看一眼再回车。