git commit 是 Git 版本控制系统中核心的提交命令，用于将暂存区（Stage/Index）中的修改（或新增/删除的文件）永久记录到本地仓库（Repository），生成一个新的提交记录（Commit）。提交记录会包含修改的具体内容、作者信息、时间戳，以及关联的提交哈希值（用于唯一标识此次变更）。

一、核心作用

• 固化变更：将暂存区的修改（通过 git add 或 git rm 等操作标记的文件）保存到本地仓库。

• 生成提交历史：每次 commit 都会生成一个唯一的提交哈希（如 a1b2c3d），构成项目的版本演进历史。

• 记录上下文：通过提交信息（Message）描述此次变更的目的，方便后续追溯和协作。

二、基础语法

git commit [选项] [文件路径]

若不指定文件路径，默认提交暂存区中所有已标记的文件。

三、常用选项与场景

1. -m <提交信息>：直接指定提交信息（最常用）

无需进入编辑器输入信息，直接通过 -m 参数附加简短说明。

示例：

# 提交暂存区的所有文件，并附带信息 "修复登录接口超时问题"

git commit -m "修复登录接口超时问题"

git commit -m "第一行" -m “第二行” -m "第三行"

输入注释时，直接回车即可换行，在输入结束双引号后，再回车提交注释。

也可以提交一个文件作为注释：

git commit -F comments.txt

2. -a：自动暂存并提交已跟踪文件的修改（跳过 git add）

-a 选项会自动将已跟踪（Tracked）文件（即之前提交过的文件）的修改（包括内容变更和删除）添加到暂存区，并直接提交。

注意：新文件（未被跟踪的文件，Untracked）不会被 -a 处理，需先用 git add 标记。

示例：

# 修改了已存在的文件 README.md，无需 git add，直接提交

git commit -a -m "更新 README 文档"

3. -am：组合 -a 和 -m（快速提交已跟踪文件）

等价于先执行 git add 所有已跟踪文件，再执行 git commit -m，适合快速提交小修改。

示例：

# 快速提交所有已跟踪文件的修改（含删除），信息为 "优化搜索逻辑"

git commit -am "优化搜索逻辑"

4. -v（--verbose）：显示提交详情（含 diff）

提交时同时显示本次修改的详细差异（Diff），方便确认提交内容是否正确。

示例：

# 提交并显示修改的详细内容

git commit -v -m "修复支付接口异常"

5. --amend：修正最后一次提交（覆盖历史）

用于修改最近一次提交（Last Commit）的信息或内容（如提交信息写错、遗漏文件等）。

注意：若提交已被推送到远程仓库，强制修改会导致协作问题（需谨慎使用）。

常见场景：

• 修改提交信息：

  # 直接进入编辑器修改最后一次提交的信息

  git commit --amend

  # 直接指定新信息（覆盖原信息）

  git commit --amend -m "修正后的提交信息"

• 补充遗漏文件：

  若提交后发现漏掉了某个已跟踪文件，可先 git add 该文件，再用 --amend 追加到上次提交：

  git add missed-file.txt

  git commit --amend --no-edit # --no-edit 表示不修改提交信息

6. -e（--edit）：强制进入编辑器修改提交信息

即使已通过 -m 指定了信息，-e 仍会强制打开默认编辑器（如 Vim）让你重新编辑提交信息。
直接使用git commit命令，会打开编辑器，提示输入注释。

7. --author：指定提交作者（高级场景）

覆盖默认的提交作者信息（姓名和邮箱），适用于协作时临时修改作者（如他人代提交）。

格式：--author="姓名 <邮箱>"

示例：

# 以其他作者身份提交（仅本次有效）

git commit --author="张三 <zhangsan@example.com>" -m "临时提交"

8. -n（--no-verify）：跳过钩子（Hooks）

Git 支持提交前钩子（如 pre-commit），用于代码检查、测试等。-n 可跳过这些钩子，直接提交（慎用，可能导致不符合规范的代码入库）。

四、关键注意事项

1. 暂存区（Stage）的概念：

   git commit 仅提交暂存区的内容，而非工作区（Working Directory）的所有修改。若想提交所有修改（包括未 add 的），需结合 -a 选项（但仅限已跟踪文件）。

2. 提交信息的规范：

   提交信息应清晰描述变更内容（如“修复登录接口超时”比“更新代码”更明确）。推荐格式：

   • 首行：简短总结（不超过 50 字符）。

   • 空一行后：详细描述（可选，说明背景、原因或影响）。

3. 提交的原子性：

   每个提交应代表单一逻辑变更（如一个 Bug 修复、一个功能实现），避免“大而全”的提交，方便后续追溯和回滚。

4. 远程仓库同步：

   git commit 仅影响本地仓库，若需同步到远程（如 GitHub），需额外执行 git push。

五、示例流程

假设你修改了 src/app.js 和 README.md，并想提交这两个文件的修改：

# 1. 查看当前状态（确认修改的文件）

git status

# 2. 将需要提交的文件添加到暂存区（可选，若用 -a 可跳过）

git add src/app.js README.md

# 3. 提交暂存区的文件，并附带信息

git commit -m "优化首页加载逻辑，更新文档说明"

# 4. （可选）查看提交记录

git log

总结

git commit 是 Git 工作流中记录变更的核心命令，通过合理使用其选项（如 -m、-a、--amend），可以高效管理代码版本。关键是理解暂存区的作用，并养成清晰提交信息和原子化提交的习惯，这对团队协作和项目维护至关重要。