8.2 用Git保存个人文档的第一版

本节介绍用Git保存个人文档的第一版，并说明需要关注的操作、边界和验收方法。

这一节使用配套案例仓库中已经准备好的practice/08-git-personal-docs/，跟着Codex完整走一遍第一次保存版本的全流程。你不需要新建文件夹，也不用切换项目。

准备练习用的个人文档

practice/08-git-personal-docs/中已经放好学习计划.md和复盘记录.md两份简单文本。后面的Git操作只针对这个子目录，不会把其他案例一起存进版本记录。

选择适合用Git记录的个人文档

Git几乎可以管理所有文件，但对不同格式的效果不太一样：

文件类型	Git能做到什么	说明
Markdown、TXT、CSV等纯文本文件	每次保存不仅能留底，还能看清具体改了哪一行、哪几个字	最适合用Git管理，也是本章练习的主要对象
Word、Excel、PPT等办公文件	每次保存整份文件，需要时可以找回旧文件	能找回旧版本，但无法直接看到具体哪一行被改动了
图片、音频、视频等大文件	每次保存整份文件	文件较大、修改频繁时，会比较占用电脑存储空间

术语解释｜纯文本文件

纯文本文件只保存文字、标点和换行，不依赖Word这类特定软件。Git可以逐行比较其中的变化，因此Markdown、TXT和CSV特别适合保存版本。

安装或更新Git并完成第一次设置

保持配套案例仓库项目处于打开状态，发送：

请检查这台电脑是否已经安装了Git。如果没有，请帮我安装；如果已安装，请显示当前版本。然后帮我设置提交时使用的名字和邮箱：名字用“你的名字”，邮箱用“你的邮箱”。不要修改配套案例仓库中的文件。

Git每次保存版本时，都会记下是谁保存的，所以需要填一个名字和邮箱（填你自己常用的即可，不需要去网站注册）。

初始化文件夹并保存第一版

在日常操作中，你不需要自己去终端敲命令，直接告诉Codex你的意图即可。

术语解释｜终端

就是电脑里输入纯文本命令的窗口（Mac上叫“终端”，Windows上叫“命令提示符”或PowerShell）。通常由程序员敲代码使用。在本手册中，复杂操作直接告诉Codex即可，不需要自己打开它。

第一步：让Git开始接管这个文件夹

告诉Codex：

请帮我检查practice/08-git-personal-docs/是否已经由Git单独管理。如果没有，请只在这个子目录初始化Git。不要修改里面的文档，也不要把其他案例加入这个版本记录。

初始化后，这个文件夹就正式由Git接管了。

第二步：选出要保存的文件并存下第一版

接下来，把准备好的两份文档正式存下第一版。告诉Codex：

请查看practice/08-git-personal-docs/的文件状态，把学习计划.md和复盘记录.md存为第一版，说明写“保存个人文档第一版”。完成后告诉我结果。

Codex会自动帮我们完成“查看文件、选定文件、存下版本”的过程。

第三步：确认第一版已经保存成功

保存完成后，怎么知道有没有存好？直接问Codex：

请帮我查看practice/08-git-personal-docs/刚刚保存的版本记录，并确认这个子目录是否还有未保存的文件。

如果Codex回复显示有一条“保存个人文档第一版”的记录，并且没有其他未保存的文件，就说明你的第一个版本已经稳稳地存好了！