准备设备、时间与工作方式
一台能打开浏览器、编辑器和终端的电脑就可以开始。比设备配置更需要先固定项目位置、练习节奏和错误记录方式。
- 能快速找到任务项目，并用系统、路径、版本、命令和错误原文描述当前环境。
- macOS、Windows 与 Linux 的路径和终端差异
- 观察准备设备、时间与工作方式后，应当能快速找到任务项目，并用系统、路径、版本、命令和错误原文描述当前环境，并保留学习日志、页面截图和终端输出作为可重复检查的依据。
- 完成 1.2「先看完整路线，再开始走」
FOUNDATION
必须理解
零基础学习最常见的中断，不是能力不足，而是环境、资料和节奏失控。一个可重复的工作方式可以让错误变成记录，而不是每次都从头开始。
本课依次讲清macOS、Windows 与 Linux 的路径和终端差异、固定练习目录、清晰命名和保存习惯和遇到安装错误时完整保留命令、输出和环境信息，最后通过“安排第一次 60 分钟练习，并在结束前留下下次起点”检查学习结果。
做实验前会先准备台面、器材和记录本。开发环境也是实验台：编辑器、浏览器、终端和项目目录各有位置，记录能帮助你复现实验。
为任务应用建立唯一项目目录、学习日志和版本记录，所有素材与代码都从这里进入，不散落在下载目录和聊天窗口。
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 负责根据真实材料解释macOS、Windows 与 Linux 的路径和终端差异并指出遗漏，学习者负责控制范围、执行修改和核对学习日志、页面截图和终端输出。
推荐协作顺序
- 1
把设备系统、可用时间和目标说清楚，让 AI 给一份最小准备清单。
- 2
对清单里的每个工具追问“这一周不用它会怎样”，删除暂时用不到的。
- 3
把最终环境和启动方式整理成自己的三行备忘，不依赖聊天记录。
我是零基础学习者，使用当前这台电脑制作任务应用。请根据我提供的系统、终端和编辑器信息，给出最小准备清单与一页学习日志模板。不要要求安装暂时用不到的工具，也不要记录任何秘密。
一份围绕证据和复现设计的日志，而不是只有“今天学了什么”和心情的打卡表；准备设备、时间与工作方式的人工验收必须回到真实页面、请求、终端、测试或数据结果，不能用 AI 的文字说明代替。
人工检查清单
- 确认模板不会要求记录密码、API Key 或其他秘密，并且包含实际结果而不只有 AI 的结论。
- 确认建议明确区分 Windows、macOS 和 Linux，命令与当前终端一致。
- 按建议操作后记录实际输出；如果结果不同，停止后续步骤并把差异返回给 AI。
COMMON TRAPS
常见误区
下面三类问题会让任务看似完成，却经不起刷新、错误输入或真实环境检查。先看现象，再找原因和修正方法。
一次安装太多工具
- 你会看到
- 多个编辑器、终端和环境管理器同时存在，出错后不知道谁在生效。
- 为什么发生
- 新手还没有判断来源和优先级的经验。
- 怎样纠正
- 先固定一套最小工具，出现明确缺口时再增加。
项目散落在下载目录
- 你会看到
- 同名文件很多，编辑器修改的和浏览器打开的不是同一份。
- 为什么发生
- 复制附件比维护唯一来源容易，但会迅速制造版本分叉。
- 怎样纠正
- 每个项目只保留一个明确根目录，并从根目录打开编辑器。
报错只说不能用
- 你会看到
- 帮助者看不到命令、路径和错误原文，只能不断猜测。
- 为什么发生
- 现象缺少重现条件，无法排除环境差异。
- 怎样纠正
- 按环境、操作、预期、实际输出四项记录。
HANDS-ON
动手任务
能快速找到任务项目，并用系统、路径、版本、命令和错误原文描述当前环境。
- 完成 1.2「先看完整路线，再开始走」
跟着做
- 01
确认浏览器、编辑器和终端都能正常打开。
- 02
在明确位置建立 VibeCodingLab 练习总目录。
- 03
创建学习日志并填写今天日期、目标和设备环境。
- 04
约定文件命名规则，避免“最终版2真的最终版”这类名称。
- 05
安排第一次 60 分钟练习，并在结束前留下下次起点。
能快速找到任务项目，并用系统、路径、版本、命令和错误原文描述当前环境。
设计一份“遇到错误时的五问卡片”，放在学习日志顶部。
离开本课前，自问四件事
- 我能否说出当前操作系统、终端、编辑器和项目根目录？
- 同一个教程命令在不同系统中可能需要调整哪些部分？
- 一次可复现的报错描述至少应包含哪些信息？
- 哪些秘密即使为了排错也不能发送给 AI？
确认完成后，会同步更新学习中心的课程学习进度。