机器人课程实操：分清工作区与暂存区的代码差异

机器人课程里，学员说“我已经改过这段代码”，教师打开仓库却看到另一份内容，问题未必出在程序本身。代码编辑后的工作区、准备提交的暂存区和当前提交，是三个需要分开看的位置。下面用本地教学仓库说明怎样查看代码差异并形成复查记录，不执行控制程序，不连接机器人，也不替学员提交或还原文件。

先确认教学仓库与当前比较基点

进入教师指定的本地练习目录，确认这是本次作业对应的仓库，而不是下载资料的另一份副本。记录课程题目、当前分支和作为比较基点的提交标识。若题目要求对照某个已知版本，应由教师明确该版本；不要凭文件修改时间猜测练习起点。仓库仍在被编辑时，也应把观察时间写入记录。

先运行git status --short查看概况。Git官方status文档说明了普通非冲突状态下，短格式中两个状态位置分别表示暂存区和工作区的变化，并用专门标记表示未跟踪文件。本练习以没有未解决合并冲突的教学仓库为前提；若出现冲突，应交给教师按另一项合并练习处理。概况的作用是帮助确定要看的文件，不等于已经阅读了每一处差异。不同状态的文件应分别进入后续检查。

查看尚未暂存的修改，保留比较两端

git diff -- lesson.py可以用于查看示例文件lesson.py在工作区相对于暂存区的差异。把示例路径换成题目指定的实际路径，双横线用于分隔选项和文件范围。Git官方diff文档明确区分了这种比较与暂存区相对于提交的比较，阅读输出前应先写下本次采用哪一种。

查看差异时，关注文件路径、差异块位置以及增加和删除的行，再联系题目要求解释修改意图。看到一段新增配置，并不能单凭文本判断它在运行时被采用；需要执行验证的作业，应在课程安排的隔离教学环境中另做验证。本文的步骤只形成静态差异记录，不把未运行的代码写成已通过实验。

再查看已经暂存的修改，避免漏掉同一文件

使用git diff --cached -- lesson.py查看暂存区相对于当前提交的差异。同一文件可能既有已暂存的修改，又有后来继续编辑、尚未暂存的修改，所以不能只看一次普通diff就概括“准备提交的全部内容”。把两份观察分别标注为工作区对暂存区、暂存区对当前提交，教师就能知道讨论的是哪一层。

若需要查看工作区与当前提交之间的已跟踪内容差异，可按官方文档使用git diff HEAD -- lesson.py。这仍然不代表所有未跟踪文件已被包含。遇到新建的辅助脚本，要回到status列表单独确认其存在，并在有权限的本地编辑器中阅读；不要因为diff没有显示它，就在作业记录里写成没有新增文件。

把差异观察和练习结论分别写清楚

每项记录可以写成“比较端点、文件范围、看到的变化、与题目的关系、尚待验证事项”。如果输出为空，应说明是哪两个端点在指定范围内未显示差异，而不是笼统写成整个仓库完全一致。忽略规则、未跟踪文件以及未纳入本次路径范围的文件，都可能需要另外检查。

提交给教师的截图或摘录，应保留足够的文件路径和比较方式，同时避免泄露账号、令牌或其他同学的内容。对于较长差异，不要只截取一行看似正确的修改；可以提供完整的本地复查材料位置，再摘录与题目直接相关的部分。教学反馈指出的问题，应对应到具体文件和差异块。

继续编辑后重新观察，不覆盖旧的复查材料

学员继续修改后，先确认比较基点有没有变化，再生成新的观察记录。若已经形成新提交，应明确说明基点更新，不能把两轮不同端点的输出直接拼成一份记录。暂存、提交、推送和丢弃修改都是另有含义的动作，本练习不要求为了得到整洁输出而执行它们。

两张配图是原创AI辅助概念图，没有真实课程代码或学员仓库数据。更多练习见机器人培训栏目和文章目录。能够准确说明“正在比较哪两份内容”，有助于把模糊的代码争论变成可以复查的静态观察，再由课程的实际验证环节回答程序是否满足要求。