最近“Vibe Coding”的热度一直没降,很多人把它理解成“用嘴写代码”,但真到自己上手,还是会卡在几个关键问题上:用什么工具、怎么描述需求、写完怎么跑起来、怎么部署给别人看。这次我分享一个用 Vibe Coding 方式做的个人网站,从一句话想法到最终上线部署的完整过程,包括提示词怎么写、AI 生成的代码长什么样、如何本地验证、如何部署到线上,以及中途踩过的坑。
先说结论:Vibe Coding 不是让你完全不懂代码,而是把“从零实现”变成“从需求到验证”的高频迭代。对个人网站、作品集、小工具页面这类场景,它的效率提升非常明显。整篇文章会围绕一套可复用的流程展开,读完你可以直接照着做一个自己的网站。
1. Vibe Coding 核心能力速览
| 能力项 | 说明 |
|---|---|
| 核心理念 | 用自然语言描述功能需求,由 AI 生成主要代码,开发者负责验证与修正 |
| 主流工具 | Cursor、Claude Code、Bolt.new、v0、通义灵码等 AI 编程工具 |
| 硬件需求 | 不需要本地 GPU,主要依赖云端模型算力 |
| 技术门槛 | 不需要精通框架,但需要能看懂报错、能描述清楚需求 |
| 主要应用 | 个人网站、静态页面、小工具、原型验证、脚本编写 |
| 部署平台 | Vercel、Netlify、GitHub Pages 等静态托管服务 |
| 是否支持 API | 支持,AI 生成的代码可调用第三方 API |
| 是否支持批量任务 | 取决于具体项目,静态站可批量生成页面 |
| 适合人群 | 产品经理、设计师、独立开发者、想快速验证想法的技术爱好者 |
从这张表能看出,Vibe Coding 最大的特点就是“低硬件门槛 + 高迭代速度”。它不挑显卡、不挑系统,真正关键的是你的需求描述能力和验证能力。
2. Vibe Coding 的适用场景与使用边界
2.1 适合做什么
Vibe Coding 最舒服的场景是“信息展示 + 轻交互”的网站。
- 个人主页 / 作品集:展示项目、照片、联系方式。
- 小工具页面:计算器、待办清单、随机生成器。
- 文档站点:把 Markdown 文档转换成静态网站。
- 活动落地页:短时间上线一个活动介绍页面。
- 原型验证:把产品想法快速做成可点击的页面给团队看。
这类网站的特点是:页面数量少、交互逻辑简单、样式需求明确。AI 在这种场景下的代码生成质量非常高,基本一次生成就能达到可用状态。
2.2 不适合做什么
- 大型业务系统:需要复杂权限、数据库事务、多服务协同,AI 生成的代码难以维护。
- 高并发应用:性能调优、缓存策略、分布式架构,还是需要专业工程师。
- 涉及敏感数据的应用:身份认证、支付、隐私数据处理,不能完全交给 AI 输出。
- 深度定制的前端动画:复杂的交互细节,AI 需要多轮修正才能达到效果。
2.3 合规与安全边界
用 Vibe Coding 做网站,必须注意几个边界:
- 不要把内部敏感数据、数据库连接串、密钥直接粘贴给 AI。
- 如果 AI 生成了类似其他网站的设计或文案,要确认是否符合版权要求。
- 网站涉及用户上传内容、评论、表单时,要明确数据用途,添加隐私说明。
- 如果以后要商用,建议在项目早期就确认代码和素材的授权范围。
3. Vibe Coding 个人网站环境准备
Vibe Coding 对本地环境要求很低,但该装的东西还是得装。
3.1 工具清单
| 工具 | 用途 | 是否必须 |
|---|---|---|
| AI 编程工具 | 核心,用于生成代码 | 必须 |
| GitHub 账号 | 代码托管、部署关联 | 推荐 |
| Vercel / Netlify 账号 | 一键部署网站 | 推荐 |
| Node.js | 本地运行前端项目 | 推荐 |
| Git | 版本管理 | 推荐 |
| 浏览器 | 预览和调试 | 必须 |
如果你完全不用本地环境,也能在 Bolt.new 这类云端工具里完成开发和预览,最后直接部署。但本地装一套 Node.js 和 Git,后面调试和改代码会方便很多。
3.2 Node.js 安装检查
在本地终端执行:
node -v npm -v如果没有输出,去 Node.js 官网下载 LTS 版本安装。安装完成后重新打开终端,再执行一次确认。
3.3 项目目录规划
建议先建一个干净的目录,后面 AI 生成的代码都放这里。
mkdir my-vibe-site cd my-vibe-site git init这样做的目的是:从第一步就进入版本管理,后面 AI 每改一版,你都能知道改了什么、出问题还能回退。
4. 从一句话需求到第一版网站
这是 Vibe Coding 的核心流程:用自然语言描述需求,让 AI 输出代码,然后本地运行验证。
4.1 需求描述技巧
AI 生成代码的质量,很大程度上取决于你的描述质量。一个好的 Vibe Coding 提示词应该包含:
- 网站类型:个人主页、作品集、落地页。
- 目标用户:给谁看。
- 内容结构:需要哪些板块。
- 视觉风格:简洁、活泼、科技感、极简。
- 功能要求:导航、轮播、点击效果、表单。
- 技术偏好:如果会代码,可以直接指定 React、Vue 或纯 HTML。
4.2 示例提示词
以“做一个个人的趣味作品集网站”为例,提示词可以这样写:
我要做一个个人作品集网站,要求如下: 1. 网站类型:单页静态网站,移动端和电脑端都能正常显示。 2. 主色调:深色背景 + 蓝色渐变点缀。 3. 内容板块: - 顶部导航:主页、关于我、项目、联系方式,点击可平滑滚动到对应区域。 - Hero 区域:一句个人介绍,一个“查看我的项目”按钮。 - 项目列表:展示 3 个虚拟项目卡片,每张卡片包含标题、一句话描述、技术标签。 - 关于我:一段个人简介。 - 联系区域:一个邮箱链接和 GitHub 链接。 4. 技术要求:使用纯 HTML + CSS + 少量 JavaScript,不需要引入大型框架。 5. 请给出完整代码文件,并说明如何本地运行。注意这里我特意写了“虚拟项目”,是因为如果用真实项目信息,需要你提供材料;Vibe Coding 阶段建议先用占位内容跑通流程,后面再替换真实信息。
4.3 AI 生成的代码结构
按照上面的提示词,AI 通常会生成类似这样的文件结构:
my-vibe-site/ ├── index.html ├── style.css └── script.js如果你用的是 React 类的技术栈,会生成:
my-vibe-site/ ├── package.json ├── vite.config.js ├── index.html └── src/ ├── App.jsx ├── main.jsx └── components/不管哪种结构,核心逻辑都一样:HTML 负责内容,CSS 负责样式,JavaScript 负责交互。
4.4 本地运行验证
如果是纯 HTML 文件,直接双击index.html就能在浏览器打开。
如果是 React 或 Vite 项目,进入项目目录:
npm install npm run dev启动后终端会显示一个地址,通常是http://localhost:5173,在浏览器里访问这个地址就能看到页面。
这里要注意:AI 生成的项目依赖版本可能与你本地的 Node 版本有差异。如果npm install报错,一般是因为依赖版本过高,具体排查方式写在后面的常见问题章节。
5. 功能测试与效果验证
网站代码生成后,不要急着部署,先做一轮验证。我把 Vibe Coding 项目的验证分为四个层级:页面渲染、交互逻辑、响应式布局、部署后回归。
5.1 页面渲染测试
打开页面后,检查以下内容:
- 首页文字是否完整显示,有没有乱码。
- 导航栏是否在预期位置。
- 图片是否能正常加载。
- 背景色和文字颜色对比是否清晰。
这一步主要看 AI 有没有把基础内容遗漏。
5.2 交互逻辑测试
Vibe Coding 生成的网站通常包含一些 JavaScript 交互,比如平滑滚动、点击按钮、弹窗。逐项测试:
- 点击导航链接,是否滚到对应区域。
- 点击“查看项目”按钮,是否跳转或展开内容。
- 如果有表单,输入内容后是否有反馈。
- 控制台
F12打开,看有没有报错。
5.3 响应式布局测试
在浏览器开发者工具里,切换到手机宽度(375px 左右),再切换到平板宽度(768px),确认页面没有横向滚动条、文字没有被截断、按钮可以正常点击。
这一步很关键。Vibe Coding 生成的页面桌面端通常没问题,但移动端偶尔会出现元素溢出。
5.4 判断标准
| 测试项 | 通过标准 |
|---|---|
| 页面渲染 | 所有板块正常显示,无乱码 |
| 交互逻辑 | 点击、滚动无报错,交互有反馈 |
| 响应式 | 手机 / 平板 / 桌面布局均无溢出 |
| 控制台 | 无红色错误信息 |
如果其中任何一项不通过,把具体现象和浏览器报错信息复制给 AI,让它修复。
6. 部署上线与接口接入
本地跑通只是第一步,个人网站要给别人看,需要部署到线上。
6.1 推送到 GitHub
先在 GitHub 创建一个仓库,然后关联本地目录。
git add . git commit -m "vibe coding personal site" git branch -M main git remote add origin https://github.com/你的用户名/你的仓库名.git git push -u origin main如果不会命令行,也可以在 GitHub 网页端直接上传文件,但用 Git 管理后面更新更方便。
6.2 Vercel 一键部署
Vercel 是目前部署静态网站最方便的平台之一,和 GitHub 配合使用流程很顺。
- 打开 Vercel 官网,用 GitHub 账号登录。
- 点击
Add New Project。 - 选择刚才推送的 GitHub 仓库。
- 框架预设选择
Vite或Other,静态文件目录一般不用改。 - 点击
Deploy。
等待一两分钟,Vercel 会返回一个专属域名,网站直接上线。
部署完成后,以后每次往 GitHub 推送代码,Vercel 都会自动重新部署,这种“提交即上线”的体验,和 Vibe Coding 的迭代节奏很匹配。
6.3 接入接口 API
静态网站本身没有后端,但可以通过第三方 API 实现动态功能。以联系表单为例,可以接入表单服务:
import requests url = "https://formspree.io/f/YOUR_FORM_ID" data = { "name": "测试用户", "email": "test@example.com", "message": "这是一条来自 Vibe Coding 网站的测试消息" } response = requests.post(url, data=data, timeout=30) print(response.status_code) print(response.text)需要替换为你自己的表单 ID。接入后,网站里的表单就能把用户输入发送到你的邮箱,适合个人网站的留言场景。
如果你想把接口能力也交给 AI 生成,提示词这样写:
帮我给网站的联系表单添加提交功能,提交后调用 https://formspree.io/f/YOUR_FORM_ID 这个接口, 成功时提示“发送成功”,失败时提示“请稍后重试”。输出修改后的表单代码。7. 成本与性能观察
7.1 时间成本
同样做一个个人作品集站点,传统开发方式可能需要一两天,Vibe Coding 的流程可以压缩到半小时以内,前提是需求描述清楚。如果需求含糊,AI 会生成一版“通用”页面,再花几轮来回调整。
我自己实际感受:第一次使用 Vibe Coding 建站,大部分时间花在“描述需求”和“验证结果”上,而不是写代码本身。这和传统的“边写边想”是很不一样的体验。
7.2 工具成本
Vibe Coding 工具的费用要看具体产品。有的 AI 编程工具提供免费额度,适合个人尝试;深度使用且需要高速模型时,通常要订阅付费版本。部署平台方面,Vercel 对个人项目有免费额度,个人网站流量一般不会触发计费。
具体的费用以官方页面为准,建议第一次先用免费额度跑通。
7.3 网站性能
Vibe Coding 生成的静态网站,性能一般不会太差。但如果 AI 引入了大量 JavaScript 动画或较大的图片,页面加载速度会受影响。
验证性能的方式很直接:
# 使用 Lighthouse 检测页面性能,直接在浏览器 DevTools 中选择 Lighthouse 标签页重点关注三项:首屏加载时间、资源大小、移动端表现。如果得分偏低,可以要求 AI 精简代码、压缩图片、移除冗余依赖。
8. 常见问题与排查方法
Vibe Coding 建站过程中,最容易遇到下面这些问题:
| 问题现象 | 可能原因 | 排查方式 | 解决方案 |
|---|---|---|---|
| AI 生成的代码本地跑不起来 | 依赖版本与本地环境不兼容 | 查看终端报错信息 | 让 AI 提供兼容版本,或手动降低依赖版本 |
| 页面打开是空白 | JS 报错或资源路径错误 | 打开控制台查看错误 | 把报错信息复制给 AI,让它修复 |
| 移动端布局错乱 | 缺少响应式样式 | 使用开发者工具切换设备 | 要求 AI 增加媒体查询和响应式布局 |
| GitHub 推送失败 | 认证失败或仓库冲突 | 查看 Git 报错信息 | 使用 Personal Access Token 或重新关联仓库 |
| Vercel 部署失败 | 构建命令或输出目录不对 | 查看 Vercel 构建日志 | 调整构建命令,静态站通常用npm run build |
| 表单无法提交 | API 接口配置错误 | 检查网络请求状态 | 确认表单服务 ID 是否正确 |
| AI 生成的网站风格不符合预期 | 提示词不够具体 | 补充风格参考 | 描述更明确的颜色、字体、布局偏好 |
| 页面字体加载慢 | 引入了外部字体库 | 查看 Network 面板 | 去掉不必要的外部字体或使用系统字体 |
上面这些坑,90% 都能通过“复制报错信息给 AI”解决。Vibe Coding 的调试逻辑不是直接去改代码,而是让 AI 基于报错信息给出修复方案,然后验证修复结果。
9. 最佳实践与建议
9.1 提示词分阶段描述
不要一次把所有需求全部丢给 AI。先让它做一版基础页面,再逐步增加功能,比一次性生成复杂页面更稳定。推荐的节奏是:结构 → 样式 → 交互 → 部署。
9.2 保留最小可运行版本
每一轮 AI 修改前,确保当前版本是可运行的。如果新一轮修改引入了问题,可以回退到上一个稳定版本而不是从头再生成。这就是前面建议用 Git 管理项目的原因。
9.3 敏感信息不要进入提示词
AI 工具的数据处理方式各不相同,不要把密码、密钥、个人身份信息粘贴到对话中。Vibe Coding 应该处理的是一般性的功能需求,不是敏感数据。
9.4 验证后替换占位内容
在 Vibe Coding 阶段,建议先使用占位文字和示例图片,等页面结构和功能稳定后,再替换为真实内容。这样既能避免在最初阶段就因为文案反复调整,也能确保内容版权清晰。
9.5 明确授权与合规
如果 AI 生成的代码来自某个开源项目训练结果,或者设计风格明显参考了其他网站,商用前要谨慎确认。个人网站可以放宽,但涉及商业用途时,保留必要的合规审查习惯是值得的。
9.6 建立自己的验证清单
每次让 AI 修改后,不要急着看效果,先按固定清单核验:页面是否能打开、控制台是否有报错、移动端是否正常、核心功能是否可用。否则很多问题会叠加在一起,难以定位。
10. 总结与下一步
这次用 Vibe Coding 做个人网站,最值得尝试的点是:它把“从零写代码”变成了“描述需求 + 验证结果”的循环,对于个人网站这种轻量页面,效率提升非常明显。如果你也想试,建议先验证这四件事:能不能用自然语言生成一版完整页面、能不能本地运行、能不能一键部署、能不能通过继续对话迭代功能。
最容易踩的坑是需求描述不清楚,导致 AI 反复生成不相关的版本。解决方式很简单,就是先写清楚网站类型、内容板块、视觉风格,然后逐步迭代。
下一步可以尝试的方向很多:
- 在个人网站中加入一个自己的小工具,比如抽奖、随机数、每日一句。
- 接入第三方 API,展示 GitHub 最新项目或天气信息。
- 尝试用 React 等框架构建更复杂的交互页面。
- 把 Vibe Coding 的方式用在工作中的原型验证上,给团队快速提供可点击的 Demo。
Vibe Coding 能做的事不局限于个人网站。把它当成一个“快速原型工具”和“学习编程的辅助工具”,会比单纯追求“纯 AI 写代码”更有价值。建议先做一个简单的小网站跑通全流程,再逐步拓展功能。