git commit 命令|极客笔记

git commit 命令

1. 简介

在使用 Git 进行版本控制时，git commit 命令用于将已暂存（git add）的修改记录提交到本地仓库。每次 git commit 都会创建一个新的提交对象，并将其添加到 Git 仓库的提交历史中。

2. 基本语法

git commit [选项] [-m <提交信息>]

3. 开始一个 commit

在使用 git commit 命令之前，需要确保已经将修改的文件添加到 Git 的暂存区中。可以使用如下命令来将文件添加到暂存区：

git add <文件名>

或者使用 -A 选项将所有修改过的文件都添加到暂存区，例如：

git add -A

4. 提交修改

一般来说，我们会在执行 git commit 命令时提供一个必要的提交信息，来描述本次提交所做的修改。可以通过 -m 选项直接在命令行中添加提交信息，例如：

git commit -m "Fix bug in login feature"

也可以通过省略 -m 选项，在提交时在编辑器中填写提交信息，例如：

git commit

执行后会自动启动默认的文本编辑器来撰写提交信息。一般情况下，建议使用第一种方式直接在命令行中提供提交信息，以免进入文本编辑器操作导致流程中断。

5. 提交信息的编写规范

良好的提交信息能够提高代码版本的可读性和可维护性，因此建议按照一定的编写规范来书写提交信息。下面是一种常用的格式：

<type>(<scope>): <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>

其中，type 代表本次提交的类型，常见的类型包括：

feat: 新增的功能
fix: 修复 bug
docs: 文档的修改
style: 代码格式（不影响功能的修改）
refactor: 重构代码
test: 添加或修改测试用例
chore: 杂项（构建流程、辅助工具等的修改）

scope 是本次提交影响的范围，可以是某个模块或者功能点的名称。

subject 是本次提交的简要描述，需要注意以下几点：

使用动词的现在时，例如 “改变” 而不是 “改变”。
首字母不要大写。
结尾不要添加句号。

body 是对本次提交的详细描述，可以提供一些额外的上下文信息。

footer 一般用来关联相关 issue，例如 “Closes #123” 即关闭相关的 issue 编号为 123 的问题。

一个符合规范的提交信息示例如下：

feat(user): add user authentication feature

- Add user login and registration endpoints
- Implement token-based authentication
- Update user model to include additional fields

Closes #123

6. 使用 git commit –amend 修改提交信息

如果在提交后发现提交信息有误或者遗漏了一些修改，并且还没有将修改推送到远程仓库，可以使用 git commit --amend 命令来修改最近一次的提交信息，并将遗漏的修改添加到该提交中。

使用方式如下：

git commit --amend

执行该命令后，会进入编辑模式，可以对最近一次的提交信息进行修改。修改完成后，保存并关闭编辑器即可。

7. 示例

以下是一个使用 git commit 命令的示例：

$ git add file1.py
$ git add file2.py
$ git commit -m "Add two new files"

[master cf77963] Add two new files
 2 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 file1.py
 create mode 100644 file2.py