版本控制与协作 / 系统课时
版本控制解决什么问题
版本控制解决什么问题
多人修改同一个项目时,仅靠“最终版”“最终版2”等文件名,既难以追踪变化,也无法可靠地恢复旧内容。版本控制将确认过的项目状态保存为可查询的历史,让开发者能够比较差异、定位修改来源、恢复旧版本,并在多人协作时管理各自的工作。
学习目标
- 理解版本控制要解决的核心问题,以及 Git 如何保存提交历史。
- 掌握提交历史、协作与恢复能力的实际用途。
- 判断哪些项目文件应该纳入版本控制,以及版本控制的能力边界。
Git 如何记录项目历史
版本控制系统维护一组有顺序、可追踪的项目状态。每次提交包含项目快照、作者、时间、说明及父提交信息,历史因此形成一条可遍历的演进路径。Git 让每位开发者拥有完整的本地仓库历史,即使暂时离线,也能提交、比较和查看版本。
日常流程可归纳为四步:修改文件 → 检查变化 → 暂存选定内容 → 创建提交。
其中,工作区保存当前正在编辑的文件;暂存区保存准备进入下一次提交的内容;本地仓库保存已经创建的提交。执行 git add 选择内容,再执行 git commit 将暂存内容记录为新版本。

一个提交应表达一个清晰目的,例如“修复登录校验”,而不是将接口修复、界面调整和依赖升级等无关修改全部混在一起。这样才能在排查问题时准确定位某一次变化。
提交历史能解决哪些实际问题
版本控制主要解决三个日常问题。
- 追踪变化:当某个功能突然出错时,可以查看最近的提交及文件差异,确定哪些内容发生过修改。例如使用
git log查看提交记录,使用git show检查某次提交。 - 多人协作:不同开发者可以在各自的分支上修改代码,再通过合并整合成果。Git 保存修改来源和历史,但不能保证所有并行修改自动合并成功;冲突仍需人工解决。
- 恢复旧内容:误删代码或错误修改已经提交的文件后,可以从历史提交读取或恢复旧版本,不必依赖手动复制的备份文件。
例如,配置文件 app.conf 从 version=1 改成 version=2 后,历史中仍然保留第一个版本。即使当前工作区只显示 version=2,也能通过指定提交读取原来的内容。
需要区分查看与恢复:git show 可以只读取历史内容,不改变当前工作区;真正将旧内容恢复到工作区时,则需要选择适当的恢复命令,并提前检查是否存在尚未保存的修改。
创建两次提交并验证历史
下面使用 Bash 和已安装的 Git,在独立测试目录中创建两个提交。请先进入一个允许创建新目录的位置,并确认当前不存在 git-value-demo 目录。示例不会修改全局 Git 身份配置。
# 创建独立测试仓库
mkdir git-value-demo
cd git-value-demo
git init -q
# 提交身份仅对当前仓库生效
git config user.name "Anystack Student"
git config user.email "student@example.com"
# 保存第一个版本
printf 'version=1\n' > app.conf
git add app.conf
git commit -q -m "chore: add initial configuration"
# 保存第二个版本
printf 'version=2\n' > app.conf
git add app.conf
git commit -q -m "chore: upgrade configuration"
# 按时间顺序查看两次提交
git log --oneline --reverse --no-decorate
printf 'current: '
cat app.conf
# 只读取上一个提交的文件,不覆盖当前工作区
printf 'first version: '
git show HEAD~1:app.conf预期输出
<COMMIT_ID_1> chore: add initial configuration
<COMMIT_ID_2> chore: upgrade configuration
current: version=2
first version: version=1其中,<COMMIT_ID_1> 和 <COMMIT_ID_2> 代表实际提交哈希的缩写,每次创建仓库时可能不同。
从输出可以确认三件事:仓库保存了两次独立提交;当前文件内容为 version=2;使用 HEAD~1:app.conf 能读取上一个提交中的 version=1,而不必修改当前文件。
HEAD 表示当前检出的提交,HEAD~1 表示沿第一个父提交关系向前回溯一次。这个例子只有线性历史,因此对应第一次提交。
还可以使用 git diff HEAD~1 HEAD -- app.conf 比较两个提交中的文件差异。预期会看到旧行 -version=1 和新行 +version=2,表示第二次提交替换了配置值。
哪些文件应该纳入版本控制
版本控制适用于需要长期维护、协作或追踪变化的项目,包括源代码、配置模板、技术文档、自动化脚本和测试用例。
判断文件是否应该提交,可以参考以下分类。
| 文件类型 | 建议 | 原因 |
|---|---|---|
| 源代码、测试代码 | 提交 | 需要审查、比较和追踪变更 |
| README、部署脚本 | 提交 | 与项目实现共同演进 |
| 配置模板 | 提交 | 帮助团队复现所需配置 |
| 运行日志、临时缓存 | 通常忽略 | 可重新产生,且变化频繁 |
| 构建产物 | 通常忽略 | 多数情况下可由源码重新构建 |
| 密钥、真实密码、本地凭据 | 不提交 | 泄露后可能造成安全风险 |
可以在 .gitignore 中配置忽略规则,例如 *.log、dist/ 和 .env。不过,忽略规则主要影响尚未被跟踪的文件:已经纳入 Git 跟踪的文件,不会因为后来添加忽略规则而自动停止跟踪。
对于设计稿、二进制素材等文件,也可以根据项目需要使用 Git,但大型二进制文件频繁变化会增大仓库体积,必要时应评估 Git LFS 等专门方案。
避免两个常见误解
误解一:Git 提交就是云端备份。 实际上,git commit 默认只在本地仓库创建提交。要让其他开发者取得这些记录,通常还需要配置远程仓库并执行 git push。即使配置了远程仓库,Git 也不能替代覆盖所有重要文件的完整备份方案。
误解二:所有修改都能从 Git 恢复。 只有已经进入提交历史的内容,才能可靠地从对应提交读取。未跟踪文件、尚未提交的修改以及仓库外文件,不会仅因为使用了 Git 就自动获得历史保护。
长期不提交也会增加排查难度。建议完成一个可验证的小目标后,创建一次逻辑完整的提交。提交前使用 git status 检查文件状态,避免遗漏必要文件或误提交敏感信息。
可以在示例仓库中继续做两个小练习:
- 将
app.conf修改为version=3并创建第三次提交,再使用git show HEAD~1:app.conf读取第二个版本,确认结果为version=2。 - 假设一次开发同时修复了登录接口,并修改了与接口无关的 README 排版,判断是否应拆成两个提交,分别为它们编写清晰的提交说明。
完成这两个练习后,应能区分当前文件、暂存内容和历史版本,并知道何时需要创建独立提交。Git 提供的是经过提交确认的可追踪历史,日常使用时仍需主动检查变化、合理划分提交,并妥善保存重要数据。