准备设备、时间与工作方式
开始比完美准备更重要。真正需要的不是昂贵设备，而是一台能管理文件、运行终端和安装工具的电脑。
- 能稳定找到自己的项目，并能描述当前使用的开发环境。
- macOS、Windows 与 Linux 的路径和终端差异
- 创建固定的开发目录，并写一份包含系统、终端和编辑器信息的 environment.md。
- 完成 1.2「先看完整路线，再开始走」
FOUNDATION
必须理解
开始比完美准备更重要。真正需要的不是昂贵设备，而是一台能管理文件、运行终端和安装工具的电脑。
零基础学习最常见的中断，不是能力不足，而是环境、资料和节奏失控。一个可重复的工作方式可以让错误变成记录，而不是每次都从头开始。
做实验前会先准备台面、器材和记录本。开发环境也是实验台：编辑器、浏览器、终端和项目目录各有位置，记录能帮助你复现实验。
为任务应用建立唯一项目目录、学习日志和版本记录，所有素材与代码都从这里进入，不散落在下载目录和聊天窗口。
macOS、Windows 与 Linux 的路径和终端差异
电脑不用很贵，能稳定打开浏览器、编辑器和终端就可以开始。卡顿时先看看是哪一步变慢，别一口气装三四个同类工具，最后连谁在运行都分不清。
基础概念
操作系统管理文件、程序、设备和权限。macOS、Windows 与 Linux 能完成相似任务，但路径格式、默认终端、命令名称和权限习惯有所不同。
进一步理解
教程里的命令必须放回操作系统理解。Windows 常见盘符和反斜杠，macOS、Linux 常从 / 开始；PowerShell、cmd、zsh、bash 对引号和环境变量的写法也不同。
真正重要的是记录实际环境：系统版本、终端类型、运行时版本和当前目录。这样同一问题才能被别人或 AI 重现。
看到教程使用 `ls` 时，Windows PowerShell 可能支持别名，但 `dir`、路径盘符和脚本权限仍可能与 Linux 示例不同，应先确认当前 shell。
操作系统差异不代表必须换系统。多数入门 Web 开发都能在三者完成；需要调整的是命令和路径，而不是盲目照抄。
这一小节记住：先确认自己实际使用的系统与终端，再翻译教程里的操作。
固定练习目录、清晰命名和保存习惯
一次能专心 45 到 90 分钟已经够做出东西了。看半天视频却一次都没按下运行，往往第二天就只记得“好像看懂了”。
基础概念
固定工作区是项目唯一可信位置；命名约定则让文件名称稳定表达用途。它们共同减少打开错文件、运行错目录和保留多份冲突副本的问题。
进一步理解
一个项目应有清楚的根目录，源码、图片、说明和配置都从这里组织。编辑器打开根目录后，搜索、终端和版本控制才能共享同一个上下文。
命名要能预测：使用有意义的英文或统一中文，避免空格和“最终版2”。重要变化交给 Git 记录，而不是复制整个文件夹制造版本。
把任务应用固定在 `VibeCodingLab/task-app`，以后启动前先确认终端位于这个目录，截图或提问时也能给出明确相对路径。
文件夹名称整齐不等于项目结构合理。关键是每个名称能说明职责，且所有工具确实从同一个根目录工作。
这一小节记住：唯一工作区加可预测命名，是减少低级错误最便宜的方法。
遇到安装错误时完整保留命令、输出和环境信息
找 AI 帮忙时，把刚才做了什么、看到什么错误、用的是什么系统一起说出来。它能不能帮上忙，很多时候就取决于问题能不能被还原。
基础概念
可复现问题描述包含环境、目标、执行步骤、预期结果、实际结果和完整错误。命令输出是程序留下的证据，不应只保留最后一句。
进一步理解
错误通常有上下文：执行了什么命令、在哪个目录、使用哪个版本、前面是否已有警告。只说“不能用”，AI 只能猜测并给出通用建议。
记录要脱敏。密码、令牌、私钥和完整个人数据不能为了排错直接粘贴；保留字段形状和错误信息即可。
报告安装失败时写明 Windows 版本、PowerShell、Node 与 npm 版本、项目路径、执行命令、完整输出和最近一次改动。
截图可以展示界面，却不一定包含可复制的错误文本和前后日志。能粘贴原文时优先原文，必要时再补截图。
这一小节记住：让问题可复现，比一次尝试更多修复命令更有效。
AI COLLABORATION
AI 如何参与
把操作系统、工具版本、执行命令和完整报错交给 AI，避免只说“安装失败了”。
推荐协作顺序
- 1
把设备系统、可用时间和目标说清楚，让 AI 给一份最小准备清单。
- 2
对清单里的每个工具追问“这一周不用它会怎样”，删除暂时用不到的。
- 3
把最终环境和启动方式整理成自己的三行备忘，不依赖聊天记录。
请帮我设计一份零基础开发学习日志模板。我的设备是 Windows，目标项目是个人学习任务应用。模板需要包含：今天的唯一目标、环境与版本、执行步骤、实际输出、错误原文、AI 建议、我如何验证、下次起点。请保持一页内可填写。
一份围绕证据和复现设计的日志，而不是只有“今天学了什么”和心情的打卡表。
人工检查清单
- 确认模板不会要求记录密码、API Key 或其他秘密，并且包含实际结果而不只有 AI 的结论。
- 确认建议明确区分 Windows、macOS 和 Linux，命令与当前终端一致。
- 按建议操作后记录实际输出；如果结果不同，停止后续步骤并把差异返回给 AI。
COMMON TRAPS
常见误区
错误不是需要隐藏的失败，而是帮助你看清系统边界的证据。下面三类问题在 AI 辅助学习中最常出现。
还没写代码，先装了一桌工具
- 你会看到
- 同时安装多个编辑器、终端和环境管理器，出错后不知道是哪一个在生效。
- 为什么发生
- 工具越多，路径、版本和配置来源越多；新手尚未建立判断标准时，很难知道当前真正生效的是哪一个。
- 怎样纠正
- 先固定一个编辑器和系统自带终端，确实遇到能力缺口再添加工具。
项目文件散落在下载目录
- 你会看到
- 同名文件到处都是，打开后不知道哪份才是刚修改的版本。
- 为什么发生
- 下载目录和聊天附件默认鼓励复制副本，没有唯一根目录时，编辑器与终端很容易指向不同版本。
- 怎样纠正
- 建立唯一练习总目录，每个项目只有一个明确入口。
报错时只发一句“不能用”
- 你会看到
- AI 看不到命令、路径、版本和错误原文，只能不断猜测。
- 为什么发生
- 缺少环境和错误原文时，帮助者无法区分路径、网络、权限或版本问题，只能给概率很低的猜测。
- 怎样纠正
- 保留完整错误和刚才的操作，用最少但足够的信息让问题可以复现。
HANDS-ON
动手任务
创建固定的开发目录，并写一份包含系统、终端和编辑器信息的 environment.md。
- 完成 1.2「先看完整路线，再开始走」
跟着做
- 01
确认浏览器、编辑器和终端都能正常打开。
- 02
在明确位置建立 VibeCodingLab 练习总目录。
- 03
创建学习日志并填写今天日期、目标和设备环境。
- 04
约定文件命名规则，避免“最终版2真的最终版”这类名称。
- 05
安排第一次 60 分钟练习，并在结束前留下下次起点。
能稳定找到自己的项目，并能描述当前使用的开发环境。
设计一份“遇到错误时的五问卡片”，放在学习日志顶部。
离开本课前，自问四件事
- 我能否说出当前操作系统、终端、编辑器和项目根目录？
- 同一个教程命令在不同系统中可能需要调整哪些部分？
- 一次可复现的报错描述至少应包含哪些信息？
- 哪些秘密即使为了排错也不能发送给 AI？
确认完成后，会同步更新学习中心的课程学习进度。