B.4 工具问题 转载

来源:https://github.com/datawhalechina/vibe-vibe

99-appendix_b-4-content.png

这一节解决你在使用 AI 编程工具时可能遇到的问题。

AI 不理解我的需求

现象:AI 给的代码完全不是你想要的。

可能原因与解决

原因 解决方法
描述太模糊 增加具体细节,比如尺寸、颜色、位置
需求太复杂 拆分成多个小需求,一步一步来
缺少上下文 告诉 AI 你已有的代码结构、用的技术栈
术语不准确 换个说法,或者用截图/示例网站描述

示例对比

❌ 不好的描述:
做一个好看的页面

✅ 好的描述:
做一个产品展示页面。
- 顶部是大标题"智能记账本",白色字,蓝色背景
- 下面是 3 个功能介绍卡片,横向排列
- 每个卡片有图标、标题、一句话描述
- 底部有一个"立即下载"按钮
- 整体风格简洁现代

AI 生成的代码无法运行

现象:复制 AI 的代码后,页面报错或空白。

排查清单

检查项 解决方法
代码不完整 让 AI 「请给出完整代码」
缺少依赖 询问需要引入什么库或框架
代码需要在特定环境运行 确认是浏览器代码还是 Node.js 代码
文件结构不对 让 AI 说明代码应该放在哪个文件
复制粘贴出错 检查是否漏复制了什么

快速修复 Prompt

你给的代码运行后出错了。

错误信息:
[粘贴错误信息]

请帮我修复,并给出完整的可运行代码。

部署失败

现象:本地能跑,但部署到 Vercel/Netlify 后打不开。

常见原因与解决

错误类型 可能原因 解决方法
Build failed 代码有语法错误 查看部署日志,修复错误
404 Not Found 文件路径问题 检查文件名大小写、路径是否正确
页面空白 JS 报错 打开浏览器控制台查看错误
样式丢失 CSS 路径问题 使用相对路径,确保文件已上传
API 不工作 环境变量没配置 在部署平台配置环境变量

部署前检查清单
所有文件都已保存
本地测试运行正常
文件名没有使用中文和特殊字符
路径使用相对路径(./../
入口文件是 index.html

AI 反复给同样的错误答案

现象:反复问 AI,它一直给同样的(错误的)代码。

解决策略

策略 1:换个问法

之前:请帮我实现一个轮播图

之后:请用原生 JavaScript 实现一个图片轮播组件,要求:
- 每 3 秒自动切换到下一张
- 底部有小圆点指示当前图片
- 点击圆点可以跳转到对应图片

策略 2:明确排除

请帮我实现 xxx,但是不要使用 [之前失败的方案]。

策略 3:提供更多信息

我按你说的做了,但还是报错。具体情况:
- 我的代码:[粘贴]
- 报错信息:[粘贴]
- 我的操作步骤:[描述]

策略 4:换一个 AI 工具

不同的 AI 工具可能有不同的「知识盲区」。如果一个工具反复不行,换一个试试。

网络/登录问题

问题 解决方法
页面加载慢 检查网络,尝试科学上网
登录不上 清除浏览器缓存,重新登录
聊天没响应 刷新页面,或稍等几分钟
消息发不出去 检查是否超出使用限制

工具问题通用解决思路

flowchart LR
    A[遇到工具问题] --> B{是代码问题还是工具问题?}
    B -->|代码问题| C[让 AI 帮你调试]
    B -->|工具问题| D{能换个方式吗?}
    D -->|能| E[换个 Prompt/换个工具]
    D -->|不能| F[查文档/搜索/问社区]

记住:工具是为你服务的,不是为难你的。 换个姿势再试试!

最后编辑:Alex 2026-03-05 11:39:50