Vibe Guide检查环境并初始化项目
运行环境就是让程序在电脑上运行所需的软件；依赖是项目要用的现成程序包。
为什么要有这一节点？
先把运行项目需要的软件装好，并确认能打开最小页面。
开始操作共 1 个步骤 · 按顺序完成
0101检查运行环境，启动最小项目待核对展开这一步收起这一步
01开始前准备什么，做完后留下什么？
技术方案和按顺序排列的开发任务表。
打开工具给出的地址能看到页面，README 中有下次启动方法。
这一步要让 AI 读取和保存哪些文件？
在所选工具的项目对话中，让它先打开下面的文件。找不到时，点击下方链接回到创建文件的步骤。
先让 AI 读取这些材料：docs/design.md · tasks/todo.md
让 AI 将结果保存到：README.md · docs/checks.md
02这一步要帮你解决什么问题？
先把运行项目需要的软件装好，并确认能打开最小页面。
弄懂原理，再试着自己判断
这个概念是什么意思？
运行环境就是让程序在电脑上运行所需的软件；依赖是项目要用的现成程序包。
换个情况，你会怎样判断？
已经有 Git 提交，但预览打不开，能否据此认定环境已经准备好？
查看参考答案
不能。Git只管理文件版本；运行时、依赖、配置和启动过程仍需实际验证。
试着用自己的话回答；拿不准时先对照上面的解释，再用自己的项目举例核对。
03这一步具体怎么做？
展开收起
当前项目对话
每次只发送当前这一项的提示词：选中框内文字复制（Mac 按 ⌘C，Windows 按 Ctrl+C），切到所选工具的项目对话，粘贴后把【】替换成自己的内容，再点发送。等工具回复并核对“完成后应该看到”的结果，再做下一项。
先检查电脑能否运行这个项目。展开收起
建议提示词：
请读 docs/design.md 和 tasks/todo.md，检查本项目需要的运行软件是否已安装。缺什么请给我官方安装入口、适合我的系统的操作，以及怎样确认装好了。先不要开发功能。
完成后应该看到：知道缺哪些软件，以及从哪里安装。
让工具准备最小项目需要的文件，再安装必要程序包。空文件夹还没有运行配置，需要先创建；已有文件先检查并保留。展开收起
建议提示词：
请读 docs/design.md 和 tasks/todo.md。检查现有配置；缺少时，按已确认方案创建最小项目的配置和启动文件，再安装必要依赖。保留项目说明、规则和已有成果。本次只准备能启动的最小项目，不提前开发业务功能。失败时先解释第一条错误。
完成后应该看到：有实际配置和启动文件，必要程序包已安装。
启动一个能打开的最小页面，再记下启动方法。展开收起
建议提示词：
请启动本项目最小页面，告诉我在哪里执行、实际打开哪个地址，以及怎样停止。把验证过的方法写入 README.md，检查结果写入 docs/checks.md。
完成后应该看到：打开工具给出的地址能看到页面，README 中有下次启动方法。
跟练：个人学习记录（前端 + 后端 + 数据库）
选择这个示例时，沿用同一个 learning-journal 项目逐步完成。已有自己的项目时，对照检查相关要求即可，不必另建项目。
在 Codex 项目对话发送环境提示词；让它检查 Python，再创建本项目 .venv（单独放依赖的文件夹）并安装确认过的 Flask。
- 做完这一步，应该看到什么？
- 最小服务打开真实 http 地址；README 有所在目录、启动命令和停止方式。
- 做不下去时，先怎么办？
- 提示 command not found 就核对运行时，No module named flask 就核对是否用了 .venv；不要用管理员权限乱装。
对照具体报错，找到下一步
网址打不开 / Connection refused
- 先检查哪些地方？
- 先看 Codex 的服务输出是否还在运行，核对真实端口。
- 按下面的方法处理问题
- 请 Codex 只重启本项目服务并给出当前地址；不要一直刷新旧端口。
- 问题解决后，应该看到什么？
- 浏览器打开当前地址，出现最小页面。
Address already in use
- 先检查哪些地方？
- 端口已被另一个进程使用，不代表代码语法错。
- 按下面的方法处理问题
- 让 Codex 识别占用者；不确定就给本项目换空闲端口并同步 README，不结束无关进程。
- 问题解决后，应该看到什么？
- 运行输出和浏览器使用同一个新端口。
04不会具体操作？逐项跟着做
展开收起
先检查电脑能否运行这个项目。
- 操作后应该看到什么？
- 知道缺哪些软件，以及从哪里安装。
- 没有看到这个结果时，怎么办？
- 不懂报错就复制原文给工具，不同时安装多个不同版本试运气。
让工具准备最小项目需要的文件，再安装必要程序包。空文件夹还没有运行配置，需要先创建；已有文件先检查并保留。
- 操作后应该看到什么？
- 有实际配置和启动文件，必要程序包已安装。
- 没有看到这个结果时，怎么办？
- 权限不足就按工具说明完成当前必要操作，不直接删除配置重来。
启动一个能打开的最小页面，再记下启动方法。
- 操作后应该看到什么？
- 打开工具给出的地址能看到页面，README 中有下次启动方法。
- 没有看到这个结果时，怎么办？
- 地址打不开就核对服务是否还在运行和网址是否相同，不猜端口。
05这一步出现的词
展开收起
06遇到问题时，应该怎么处理？
展开收起
安装或启动失败，不知道停在哪里
- 先检查哪里，确认问题的原因？
- 保留原报错，核对命令在哪个文件夹执行及实际系统版本。
- 按下面的方法处理问题
- 把原报错和文件位置交给 AI，请它区分缺依赖、版本冲突、权限和端口占用，只处理查明的一项。不要删除项目或反复安装不同工具。
- 恢复后应该看到
- 重新执行原操作，得到本页要求的实际结果；未执行的检查仍标为未验证。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
我停在“检查运行环境，启动最小项目”。预期结果：最小项目能实际启动，README 写明再次打开的方法，未安装项不冒充完成。。实际画面/报错：[在这里补充]。请先根据已有文件检查原因，一次只给一个可逆的处理动作，说明在哪里操作、恢复后应看到什么。不要重建项目，不要删除已有成果。07本步材料（填写或复制）
展开收起
上面已经逐项发送并完成的，不必再发下面整段模板。需要整理本步材料时再使用；替换【】后确认，再复制到项目对话。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
先检查能否读取docs/design.md、tasks/todo.md。缺失或无访问能力时，明确缺项与需本人操作的入口，停止本步执行，不编造文件或前序结论。
读取已确认设计与 tasks/todo.md，仅准备本项目运行环境并验证最小入口。先检查系统、已有文件、运行时、包管理器和锁文件；保留已有配置。缺安装/权限条件先给本人对应官方入口、执行位置和成功检查；不得假装已安装。条件满足后按确认方案安装必要依赖、启动最小项目，报告真实网址/设备入口/命令、日志和停止方法。验证重新启动，并先执行设计中已确认的最小能力实验；失败记阻断并返回选型，不开发后续功能。把真实操作写入 README.md，结果写入 docs/checks.md，不发布。跟练个人学习记录：本步怎么填写／补充提示词
仅当你选择本页全栈跟练时使用：使用下面已合并本步要求的提示词，填好空白后复制发送；不必重复发送上方通用模板。它不授权跳到后续步骤。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
先检查能否读取docs/design.md、tasks/todo.md。缺失或无访问能力时，明确缺项与需本人操作的入口，停止本步执行，不编造文件或前序结论。
读取已确认设计与 tasks/todo.md，仅准备本项目运行环境并验证最小入口。先检查系统、已有文件、运行时、包管理器和锁文件；保留已有配置。缺安装/权限条件先给本人对应官方入口、执行位置和成功检查；不得假装已安装。条件满足后按确认方案安装必要依赖、启动最小项目，报告真实网址/设备入口/命令、日志和停止方法。验证重新启动，并先执行设计中已确认的最小能力实验；失败记阻断并返回选型，不开发后续功能。把真实操作写入 README.md，结果写入 docs/checks.md，不发布。
本次已选择个人学习记录全栈跟练。
核对 Python 官方安装入口和实际版本。Mac/Linux 可用 python3 -m venv .venv，Windows 可用 py -3 -m venv .venv，先确认命令存在；用 .venv 的 Python 安装锁定依赖。启动最小 Flask 入口，不实现记录业务，报告真实端口和停止方式。08看到这个结果才算完成
最小项目能实际启动，README 写明再次打开的方法，未安装项不冒充完成。
09没有看到预期结果，接下来怎么办？
展开收起
不懂报错就复制原文给工具，不同时安装多个不同版本试运气。
看结果对照（教学示意，不是你的项目结果）
成功记录示意（非真实日志）：命令/执行目录/版本/实际入口/停止方法/重启结果；“安装成功”不等于项目已启动。
本节点出现的词按出现顺序排列，点开可查完整解释
更多问题与排障资料
Git 与环境：遇到问题这样查
2 种情况以下路径整理自官方文档与公开求助，不代表发生频率。先按现象检查，再核对处理结果。
Git 初始化或首次提交失败
看到的现象：出现 not a git repository、Author identity unknown，或仓库包含无关目录。
- 先检查哪些地方？
确认项目根目录、git --version、git rev-parse --show-toplevel 和 git status。
- 接着处理
新项目根目录才执行 git init；父目录已有仓库先确认归属。身份缺失时由本人提供姓名与邮箱，只设置当前仓库；检查忽略文件和暂存差异后再提交。
- 这样才算解决
仓库根目录正确，git log -1 显示本次提交，密钥和无关文件未被跟踪。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
我在【Git 初始化或首次提交失败】这一步遇到问题。
项目与工具：[填写名称、版本和项目路径]
实际现象：[填写操作步骤、报错原文或附截图；隐去密钥和个人数据]
期望结果：[填写实际目标]
请先检查：确认项目根目录、git --version、git rev-parse --show-toplevel 和 git status。
处理方向：新项目根目录才执行 git init；父目录已有仓库先确认归属。身份缺失时由本人提供姓名与邮箱，只设置当前仓库；检查忽略文件和暂存差异后再提交。
请先说明证据和原因，再执行最小范围修复；保留已有改动，不扩展功能。需要我操作时，一次给出一个位置明确的动作，并说明应当看到什么。
验证标准：仓库根目录正确，git log -1 显示本次提交，密钥和无关文件未被跟踪。
最后列出实际验证结果、未验证项和下一步。查证依据Git · git init ↗GitHub · Commit username ↗GitHub · Commit email ↗
依赖安装失败或预览打不开
看到的现象：看到 command not found、安装报错或浏览器拒绝连接。
- 先检查哪些地方？
读取 README、项目版本文件、锁文件和终端第一条错误，确认当前目录。
- 接着处理
按项目要求安装运行时和匹配的包管理器；不要混用锁文件。启动项目已定义的命令，保持进程运行，打开终端实际给出的地址与端口。仍失败则检查监听地址与日志。
- 这样才算解决
同一地址能加载页面；终端无启动失败，记录实际命令和版本。
先在模板中补充实际材料，确认生成后再复制到当前项目的 AI 对话。不确定项写“尚未确定”，示例可以自行替换。
已确认 · 以下是本次专属内容，可一键复制
我在【依赖安装失败或预览打不开】这一步遇到问题。
项目与工具：[填写名称、版本和项目路径]
实际现象：[填写操作步骤、报错原文或附截图；隐去密钥和个人数据]
期望结果：[填写实际目标]
请先检查：读取 README、项目版本文件、锁文件和终端第一条错误，确认当前目录。
处理方向：按项目要求安装运行时和匹配的包管理器；不要混用锁文件。启动项目已定义的命令，保持进程运行，打开终端实际给出的地址与端口。仍失败则检查监听地址与日志。
请先说明证据和原因，再执行最小范围修复；保留已有改动，不扩展功能。需要我操作时，一次给出一个位置明确的动作，并说明应当看到什么。
验证标准：同一地址能加载页面；终端无启动失败，记录实际命令和版本。
最后列出实际验证结果、未验证项和下一步。查证依据npm · Install Node.js and npm ↗Astro · Develop and build ↗Vite · Original connection-refused report ↗
本节点可查的资料
遇到对应问题再查，资料不是额外必做步骤。
- 怎么选技术，不被名词绕晕？
范围与关键交互明确，需要确认实现方式时。
- 怎么让 AI 理解任务，避免越做越偏？
准备发新任务、修改一处或反馈错误时。
我的项目材料与备份
材料只存于这台设备的当前浏览器；不是项目文件，也不会自动发给 AI。中英文模板分别保存，项目选择和学习进度共用。不要在这里填写密码或 API Key。
包括想法、进度、各步模板、人工核对记录及选型条件；不包含你的真实项目代码。恢复会建立一个新草稿，不覆盖已有项目。
下载或导入不工作？复制备份文本恢复
草稿与进度只保存在当前浏览器。
按顺序完成本页操作，遇到问题时展开对应的检查和处理方法。