第二章:把想法说给 AI 编程助手听

vibecoding入门教程

浏览 362 次


第一章你已经知道了什么是 vibecoding:人负责想法、判断和验收,AI 编程助手负责读项目、改代码、跑命令和解释问题。

这一章开始进入真正的操作。目标不是让你背概念,而是让你知道:遇到 Python、报错、依赖、bat 启动这些词时,应该复制什么提示词问 AI,然后照着结果一步一步做。

注意:这一章里,代码块通常是要复制给 AI 的内容;“你会得到”“本章重点”“使用场景”这些文字是说明,不要复制。

问 AI:我的电脑能不能运行 Python
问 AI:这个 .py 文件怎么运行
问 AI:requirements.txt 怎么安装
问 AI:帮我生成 start.bat
问 AI:我要改哪里,应该先告诉你什么
问 AI:改完后我怎么验证

只要这套流程养成习惯,你就不会一上来被终端、文件、权限、模型这些词吓住。

本章提示词索引:看到就能直接试

这一章不是让你背知识点,而是让你先把下面这些提示词用起来:

提示词 1:检查电脑能不能运行 Python
提示词 2:让 AI 用三句话解释编程语言
提示词 3:让 AI 判断 Python 是否适合你当前任务
提示词 4:让 AI 解释编码、调试、依赖和 requirements.txt
提示词 5:让 AI 教你运行一个 .py 文件
提示词 6:让 AI 教你安装 requirements.txt
提示词 7:让 AI 帮你生成 start.bat
提示词 8:让 AI 先说清楚要改什么,再开始修改

你可以先不看后面的解释,直接复制任意一个提示词去试。遇到结果看不懂,再回来看对应小节。

学完这一章,你应该能做到:

  • 用人话解释什么是编程语言;
  • 知道 Python 适合小白上手的原因;
  • 看懂“编码”“调试”“依赖”“requirements.txt”这些词;
  • 会用命令运行 Python 文件;
  • 会用 .bat 文件在 Windows 上一键启动 Python 项目;
  • 知道怎样在 AI 编程工具中打开正确的项目文件夹;
  • 会打开正确的项目目录,不让 AI 编程工具跑错地方;
  • 会写第一条安全提示词:先分析,不修改;
  • 会让工具先分析项目,再限定范围修改文件;
  • 会在 AI 编程工具修改后查看 diff,并让它解释改动风险。

如果还没有打开可用的 AI 编程工具,先按第一章从官网安装并完成第一个练习,再继续这一章。

【可直接复制的提示词 1】检查电脑能不能运行 Python

使用场景:你刚开始学 vibecoding,不确定电脑能不能运行 Python。

【可直接复制给 AI】

我是编程小白。请用最简单的话教我检查电脑能不能运行 Python。
请告诉我:
1. 打开哪里;
2. 输入什么命令;
3. 看到什么算成功;
4. 如果失败,下一步怎么排查。

【你会得到】

  • AI 会让你打开 PowerShell;
  • 输入 python --version 或 py --version;
  • 看到 Python 版本号就说明第一步成功。

【继续追问】

我输入命令后失败了,这是提示:
(粘贴完整提示)

请直接告诉我下一步应该点哪里、输入什么。

【可直接复制的提示词 2】不懂编程语言时,先这样问 AI

如果你完全不懂“编程语言”,不要先去背定义。直接把下面这段【可直接复制给 AI】

我是编程小白。请用 3 句话解释“编程语言”是什么。
然后请告诉我:
1. Python 文件一般长什么样;
2. 我应该怎么运行一个 Python 文件;
3. 如果运行失败,我应该复制哪段报错给你。

请只告诉我能马上操作的内容。

【你会得到】

AI 会用很短的话解释编程语言,然后给你运行 .py 文件的命令。

比如最简单的 Python 程序长这样:

print("你好,vibecoding")

你不需要一开始记住很多语言。先知道:Python 文件通常以 .py 结尾,可以用 Python 运行。

【继续追问】

如果你还是听不懂,继续复制这段:

请直接给我一个最小 Python 示例,并告诉我复制到哪个文件、运行哪条命令、看到什么算成功。

【可直接复制的提示词 3】让 AI 判断 Python 适不适合你

【可直接复制给 AI】

我是编程小白。请判断 Python 是否适合我当前这个任务。

我的任务是:
(写下你想做的东西,比如:批量整理文件、做一个小网页、调用 AI 接口、做自动化脚本)

请直接告诉我:
1. 这个任务适不适合用 Python;
2. 如果适合,第一步应该创建什么文件;
3. 如果不适合,更推荐用什么;
4. 我下一步应该输入什么命令或提示词。

【说明】AI 会根据你的具体任务,告诉你该不该用 Python,而不是让你抽象地学习一门语言。

Python 是一种通用编程语言,可以用来写脚本、做网页后端、处理文件、分析数据、调用 AI 接口、做自动化工具。

它适合小白,有几个原因:

  • 语法比较接近英语,读起来没那么吓人;
  • 安装依赖和运行脚本相对简单;
  • 很多 AI、自动化、数据处理项目都用 Python;
  • AI 编程工具很擅长解释和修改 Python 代码;
  • 遇到报错时,网上和官方文档资料很多。

一个最简单的 Python 程序长这样:

print("你好,vibecoding")

这行代码的意思是:让电脑在屏幕上输出一句话。

你不需要一开始记住所有语法。你只要先知道:Python 文件通常以 .py 结尾,电脑需要通过 Python 解释器来运行它。

【可直接复制的提示词 4】让 AI 解释编码、调试、依赖这些词

【可直接复制给 AI】

我是编程小白。请用最简单的话解释下面几个词:
1. 编码;
2. 调试;
3. 依赖;
4. requirements.txt;
5. bat 启动文件。

每个词只解释 2 句话。
每个词后面都给我一个“我应该怎么问 AI”的示例提示词。

【说明】AI 会把这些词翻译成你能操作的动作,并给你下一句可以继续复制的提示词。

2.3 Vibecoding 还需要懂编码吗?

需要懂一点,但不是让你马上手写很多代码。

在 vibecoding 里,AI 编程助手可以帮你写大部分代码,但你至少要知道这些词是什么意思:

编码

编码就是把想法写成代码。

比如你想要一个“点击按钮后开始倒计时”的功能,AI 编程助手会把这个需求变成代码。

你不一定要自己从零写,但你要能判断:

  • 这个代码是不是在做我想要的事;
  • 它改的是不是相关文件;
  • 它有没有顺手改了无关内容。

调试

调试就是发现问题、定位原因、修复问题。

比如程序报错、页面打不开、按钮没反应,都需要调试。

小白调试时不要只说:

坏了,帮我修。

更好的说法是:

程序运行失败了,这是完整报错:
(粘贴报错)

请先解释这是什么意思,不要修改文件。
然后告诉我最可能的原因和下一步要检查哪里。

依赖

依赖就是项目运行时需要用到的第三方工具包。

比如一个 Python 项目要调用网页接口,可能需要 requests;要做网页服务,可能需要 flask 或 fastapi。

这些包不是 Python 自带的,就需要安装。

requirements.txt

requirements.txt 是 Python 项目里常见的依赖清单。

你可以把它理解成:

这个项目运行前,需要先安装哪些工具包。

常见内容长这样:

requests
flask
python-dotenv

安装这些依赖时,通常在项目目录运行:

pip install -r requirements.txt

【可直接复制的提示词 5】让 AI 教你运行一个 Python 文件

【可直接复制给 AI】

我是编程小白。请一步一步教我运行一个 Python 文件。

请告诉我:
1. 应该新建什么文件;
2. 文件里复制什么代码;
3. 在哪里打开 PowerShell;
4. 输入什么命令运行;
5. 看到什么算成功;
6. 如果失败,我应该复制哪段报错给你。

【说明】AI 会带你创建 hello.py,运行它,并告诉你成功时应该看到什么。

2.4 第一次运行 Python 文件

先确认电脑里有没有 Python。

在 Windows PowerShell 或命令提示符里输入:

python --version

如果看到类似:

Python 3.12.5

说明 Python 已经安装。

如果提示找不到 Python,可以试:

py --version

Windows 上有时会用 py 这个启动器来运行 Python。

创建一个文件:

hello.py

写入:

print("你好,vibecoding")

在这个文件所在目录运行:

python hello.py

或:

py hello.py

成功标志:

你好,vibecoding

如果失败,把完整报错发给 AI 编程助手,不要只截图最后一行。

【可直接复制的提示词 6】让 AI 教你安装 requirements.txt

【可直接复制给 AI】

我是编程小白。当前文件夹里有 requirements.txt。
请一步一步教我安装依赖。

请告诉我:
1. 先确认我在哪个文件夹;
2. 应该运行哪条命令;
3. 如果 pip 不可用,备用命令是什么;
4. 看到什么算安装成功;
5. 如果失败,我应该复制哪段报错给你。

【说明】AI 会让你运行 pip install -r requirements.txt 或 py -m pip install -r requirements.txt,并帮你判断失败原因。

2.5 如何安装 requirements.txt?

当你下载一个 Python 项目后,先看目录里有没有:

requirements.txt

如果有,通常先进入项目目录:

cd 你的项目目录

再运行:

pip install -r requirements.txt

如果你的电脑用 py 更稳定,也可以这样:

py -m pip install -r requirements.txt

这句的意思是:让当前 Python 去运行 pip,并按 requirements.txt 安装依赖。

小白常见卡点:

  • 没有进入项目目录;
  • 文件名写错了;
  • 网络不好导致下载失败;
  • Python 没装好;
  • 同时装了多个 Python,pip 装到另一个版本里。

遇到问题时,可以这样问 AI 编程助手:

我正在安装 Python 项目的依赖,命令是:
pip install -r requirements.txt

这是报错:
(粘贴完整报错)

请先解释原因,不要让我重装系统。
请按小白能操作的步骤告诉我下一步怎么检查。

【可直接复制的提示词 7】让 AI 帮你生成 start.bat

【可直接复制给 AI】

我是 Windows 小白。
请根据当前 Python 项目,帮我生成一个 start.bat。

要求:
1. 双击后自动进入当前目录;
2. 如果有 requirements.txt,就安装依赖;
3. 启动主程序;
4. 运行失败时窗口不要自动关闭;
5. 先告诉我你准备写入哪些命令,再修改文件。

【说明】AI 会生成一个可以双击运行的 start.bat,里面通常会包含 cd /d "%~dp0"、安装依赖命令和启动命令。

2.6 用 bat 一键启动 Python 项目

Windows 用户经常不想每次都打开终端、输入命令。

这时候可以做一个 .bat 文件。

.bat 可以理解成“把几条 Windows 命令打包成一个双击就能运行的小脚本”。

比如你的项目启动命令是:

python app.py

可以在项目根目录新建:

start.bat

写入:

@echo off
cd /d "%~dp0"
python app.py
pause

每一行是什么意思:

  • @echo off:不要把每条命令都显示出来;
  • cd /d "%~dp0":切换到这个 bat 文件所在目录,路径里有空格也更稳;
  • python app.py:运行 Python 文件;
  • pause:运行结束后不要马上关闭窗口,方便你看报错。

如果项目需要先安装依赖,可以写成:

@echo off
cd /d "%~dp0"
python -m pip install -r requirements.txt
python app.py
pause

如果你的电脑使用 py 命令更稳定,可以写成:

@echo off
cd /d "%~dp0"
py -m pip install -r requirements.txt
py app.py
pause

你也可以让 AI 编程助手帮你生成:

我是 Windows 小白。
请根据当前 Python 项目,帮我生成一个 start.bat。
要求:
1. 双击后自动进入当前目录;
2. 如果有 requirements.txt,就安装依赖;
3. 启动主程序;
4. 运行失败时窗口不要自动关闭;
5. 先告诉我你准备写入哪些命令,再修改文件。

参考资料:

  • Python 官方教程:https://docs.python.org/3/tutorial/
  • Python venv 官方文档:https://docs.python.org/3/library/venv.html
  • pip requirements 文件说明:https://pip.pypa.io/en/stable/user_guide/#requirements-files

2.7 在 AI 编程工具中打开项目

前面你已经知道 Python 文件、依赖和启动命令是什么。现在把这些知识用在一个真实文件夹里。这一节训练的能力:给 AI 编程工具正确的工作范围,先看清项目,再让它修改。

在 Windows 文件管理器里新建一个练习文件夹。在 TRAE 或 CodeBuddy 中选择“打开文件夹”,选中这个文件夹。如果你使用通义灵码,先在它支持的编辑器里打开同一个文件夹,再打开 AI 对话;WorkBuddy 适合先处理轻量文件任务。各工具入口名称以实际界面为准。

【可直接复制给 AI 编程工具】

我是编程小白。请先查看当前打开的文件夹,不修改任何文件。
告诉我:这里有没有 Python 项目?如果有,我应该先打开哪个文件?
请只给出一个最容易理解的下一步。

【AI 正常会返回什么】 当前文件夹里的主要文件、是否有 requirements.txt、可能的启动文件和下一步操作。若工具说“无法读取文件夹”,先检查是否打开了正确的文件夹,以及是否授予了读取权限。

2.8 第一次让工具改文件

先限定一个小任务和明确的验收方法,避免第一次就改动整个项目。

【可直接复制给 AI 编程工具】

请在当前文件夹创建一个最简单的 Python 记账小工具。
运行后让我输入一笔支出金额和用途,并显示刚输入的记录。
请先说出准备创建哪些文件;完成后告诉我在 Windows PowerShell 里运行哪条命令,以及看到什么算成功。

【AI 正常会返回什么】 一个或少量 Python 文件、运行命令,以及可核对的输出。打开 PowerShell 前,先在文件管理器里进入项目文件夹,在地址栏输入 powershell 并回车。

在打开的 PowerShell 中,按工具给出的文件名运行。例如主文件是 app.py 时:

python app.py

如果 python 不可用,可试:

py app.py

成功标志: 程序等待你输入金额和用途,输入后显示这笔记录。若出现红字报错,复制完整报错发给工具。

2.9 看改动、继续追问

AI 编程工具可能会显示“更改”“差异”或文件列表。先看它改了哪些文件,再运行程序。

【可直接复制给 AI 编程工具】

程序已经能运行,但我希望再加一个“查看今天总支出”的功能。
请只修改实现这个功能需要的文件。改完后列出修改的文件,并告诉我用哪两组输入验证新功能。

【AI 正常会返回什么】 小范围的代码修改、修改文件清单,以及具体测试输入。若它改了无关文件,请追问:“这些文件为什么需要修改?请撤回无关改动。”

2.10 常见卡点

  • 打开错文件夹: 问工具“你现在看到的文件夹路径是什么”,与文件管理器地址栏对比。
  • 找不到 Python: 回到本章前面的 python --version 和 py --version 检查步骤。
  • 缺少依赖: 先确认项目中是否有 requirements.txt,按前面的步骤安装。
  • 工具只给代码没有写文件: 让它说明当前模式是否支持修改本地文件;不支持时切换到可编辑本地项目的工具或模式。
  • 改动太多: 要求先列出修改范围,再限定一个文件或一个功能。
  • 出现密钥或收费提示: 不把密钥粘贴到聊天里,先看官方页面的额度与费用说明。

2.11 本章保存的提示词

你现在有三类可重复使用的提示词:检查 Python 和项目环境、创建最小可运行程序、根据实际运行结果继续修改。它们都可以用于 TRAE、CodeBuddy 等能操作本地项目的 AI 编程工具;具体按钮和自动执行能力以工具当前版本为准。

本章训练的 vibecoding 能力是:看懂最基本的 Python 项目,把运行结果和报错交给工具,再亲自确认修改是否有效。