版本控制与协作 / 系统课时

版本控制解决什么问题

版本控制解决什么问题

多人修改同一个项目时,仅靠“最终版”“最终版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 身份配置。

bash
# 创建独立测试仓库
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

预期输出

text
<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 检查文件状态,避免遗漏必要文件或误提交敏感信息。

可以在示例仓库中继续做两个小练习:

  1. 将 app.conf 修改为 version=3 并创建第三次提交,再使用 git show HEAD~1:app.conf 读取第二个版本,确认结果为 version=2。
  2. 假设一次开发同时修复了登录接口,并修改了与接口无关的 README 排版,判断是否应拆成两个提交,分别为它们编写清晰的提交说明。

完成这两个练习后,应能区分当前文件、暂存内容和历史版本,并知道何时需要创建独立提交。Git 提供的是经过提交确认的可追踪历史,日常使用时仍需主动检查变化、合理划分提交,并妥善保存重要数据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

版本控制解决什么问题

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通