Git 本地工作流：提交前看清自己改了什么

刚学 Git 时，我更关注“每次提交能否说清改了什么”，而不是记住最多命令。以下流程适合在自己的练习仓库里反复做。

改动前后先看状态

git status
git diff

status 区分未跟踪、已修改和已暂存文件；diff 默认展示工作区尚未暂存的改动。若当前目录不是仓库，先进入正确目录，不要在未知目录盲目执行 git init。

只暂存打算提交的文件

git add README.md
git diff --cached
git status

git add 后再用 git diff --cached 审核已暂存内容。尽量按一个主题组织一次提交。配置文件里可能有密钥或令牌；提交前检查差异，别把它们带进历史记录。

提交并回看

git commit -m "docs: clarify setup steps"
git log --oneline -5

提交信息说明改动目的即可。git log 用来确认提交确实生成。想取消某个文件的暂存，可用 git restore --staged README.md；它不会丢掉工作区改动。git restore README.md 则会覆盖未提交修改，使用前一定要确认。

参考：git status · git restore

封面插画：unDraw（https://undraw.co/license）。

第一次提交的前提

在独立实验目录初始化仓库，先准备 README.md，再配置当前仓库的 user.name 与 user.email，才能完成首次提交；这些是提交身份元数据，不等于托管平台登录凭据。先 git diff --cached 核对暂存内容。若秘密已经提交，仅删除工作区文件或加入 .gitignore 不会清除历史，应立即撤销或轮换凭据，再安排历史清理。

内容复核与修订：2026-10-29。实验示例与本站运行记录分别说明；原始归档日期保留。