痞子衡嵌入式:第一本Git命令教程(5)- 提交(commit/format-patch/am)
今天是Git系列课程第五课,上一课我们做了Git本地提交前的准备工作,今天痞子衡要讲的是Git本地提交操作。
当我们在仓库工作区下完成了文件增删改操作之后,并且使用git add将文件改动记录在暂存区之后,便可以开始将其提交到Git本地仓库。
1.本地文件改动提交git commit
Git空间本地的改动完成之后可以直接提交,有如下三种提交命令选项:
1.1将暂存区内容提交git commit -m ["description"]
暂存区里目前只有app/app.c文件,我们先将其提交至仓库。
// 将暂存区里所有改动提交到本地仓库,提交标题为"Initial application"
jay@pc MINGW64 /d/my_project/gittest (master)
$ git commit -m "Initial application"[master 0a0c0fc] Initial application 1 file changed, 7 insertions(+) create mode 100644 app/app.c
// 查看本地提交日志,确认提交是否已记录在仓库中
jay@pc MINGW64 /d/my_project/gittest (master)
$ git logcommit 0a0c0fcec8a1ef56bfc6a24e68bbf1436b2ef2cf (HEAD -> master) Author: Jay Heng <hengjie1989@foxmail.com> Date: Sat Mar 10 21:58:36 2018 +0800 Initial application commit 867df08b4e13649e30926b483279dddce32750c2 (origin/master, origin/HEAD) Author: Jay Heng <hengjie1989@foxmail.com> Date: Sat Mar 10 20:11:04 2018 +0800 second commit
1.2追加提交git commit --amend -m ["description"]
工作区里面还有app/test.c文件处于Untracked状态,我们想将其也加到1.1的提交里合并成一个提交。
// 将Untracked状态的test.c文件添加到暂存区,用于新提交
jay@pc MINGW64 /d/my_project/gittest (master)
$ git add app/test.c// 将暂存区里新改动追加提交到本地仓库,与上一次提交进行合并,并修改提交标题为"Initial application and test"
jay@pc MINGW64 /d/my_project/gittest (master)
$ git commit --amend -m "Initial application and test"[master 589f65b] Initial application and test Date: Sat Mar 10 21:58:36 2018 +0800 2 files changed, 7 insertions(+) create mode 100644 app/app.c create mode 100644 app/test.c
// 查看本地提交日志,确实两次提交被合并成了一个
jay@pc MINGW64 /d/my_project/gittest (master)
$ git logcommit 589f65b386dd4475bb884c40ea1441d8449fdcd1 (HEAD -> master) Author: Jay Heng <hengjie1989@foxmail.com> Date: Sat Mar 10 21:58:36 2018 +0800 Initial application and test commit 867df08b4e13649e30926b483279dddce32750c2 (origin/master, origin/HEAD) Author: Jay Heng <hengjie1989@foxmail.com> Date: Sat Mar 10 20:11:04 2018 +0800 second commit
1.3非Untracked文件的改动全部提交git commit -a -m ["description"]
我们新增一个名叫platform.c空白文件,并将其git add到暂存区;且对已提交的空白test.c文件修改恢复其一开始的内容。此时我们工作区(test.c)和暂存区(platform.c)均存在文件改动。有没有可能一次性将test.c和platform.c改动提交上去,答案当然是有。
// 将platform.c改动添加到暂存区
jay@pc MINGW64 /d/my_project/gittest (master)
$ git add app/platform.c// 查看Git空间当前状态,test.c改动在工作区,platform.c改动在暂存区
jay@pc MINGW64 /d/my_project/gittest (master)
$ git statusOn branch master Your branch is ahead of 'origin/master' by 1 commit. (use "git push" to publish your local commits) Changes to be committed: (use "git reset HEAD <file>..." to unstage) new file: app/platform.c Changes not staged for commit: (use "git add <file>..." to update what will be committed) (use "git checkout -- <file>..." to discard changes in working directory) modified: app/test.c
// 将Git空间内非Untracked改动之外的所有改动(无论是工作区/暂存区)一次性提交到本地仓库,此处为test.c和platform.c
jay@pc MINGW64 /d/my_project/gittest (master)
$ git commit -a -m "Add initial platform and update test"[master 610feaf] Add initial platform and update test 2 files changed, 6 insertions(+) create mode 100644 app/platform.c
// 查看Git空间当前状态,没有任何改动记录,说明test.c和platform.c改动已被提交到仓库
jay@pc MINGW64 /d/my_project/gittest (master)
$ git statusOn branch master Your branch is ahead of 'origin/master' by 2 commits. (use "git push" to publish your local commits) nothing to commit, working tree clean
// 查看本地提交日志,又多了一次名为"Add initial platform and update test"的新提交
jay@pc MINGW64 /d/my_project/gittest (master)
$ git logcommit 610feafbf5264b66dd0515f90cce79169aebd995 (HEAD -> master) Author: Jay Heng <hengjie1989@foxmail.com> Date: Sun Mar 11 07:46:16 2018 +0800 Add initial platform and update test commit 589f65b386dd4475bb884c40ea1441d8449fdcd1 Author: Jay Heng <hengjie1989@foxmail.com> Date: Sat Mar 10 21:58:36 2018 +0800 Initial application and test
需要注意的是git commit -a虽然是-all的简写,但其并不是将Git空间内所有改动全部提交,其不会提交工作区里新建的文件(Untracked状态)。
2.补丁包方式提交
Git是分布式版本控制系统,一个项目常常由多个人一起开发,有时候我们想把本地的改动交给别人去完成提交,传统的做法是把你改动的所有文件全部提取出来打包发送给对方,但显然这样做比较繁琐,而且你的提交描述也容易丢失。Git提供了一种很好方式解决这个需求,即生成一个patch,这个patch就是你本地的一次提交的所有信息,你只需要把这个patch发给别人就可以了。
2.1生成补丁包git format-patch
git format-patch命令是以本地提交为基础的,让我们先看看目前本地有多少提交:
// 图形化方式查看本地仓库里的历史提交,共记录4个提交
jay@pc MINGW64 /d/my_project/gittest (master)
$ gitk
由上图可知,仓库里一共有4次提交,其中两次已推送到远程,还有两次在本地未推送:
2.1.1指定任意单个提交git format-patch -1 [commit]
让我们试着将"Initial application and test"这个提交生成patch:
// 将SHA-1号前7位为589f65b的提交生成一个patch
jay@pc MINGW64 /d/my_project/gittest (master)
$ git format-patch -1 589f65b
0001-Initial-application-and-test.patch
此时在gittest仓库目录下便可以看到生成的.patch文件,让我们用文本编辑器打开它看一看,确实包含了这个提交的所有改动。
From 589f65b386dd4475bb884c40ea1441d8449fdcd1 Mon Sep 17 00:00:00 2001
From: Jay Heng <hengjie1989@foxmail.com>
Date: Sat, 10 Mar 2018 21:58:36 +0800
Subject: [PATCH] Initial application and test
---
app/app.c | 7 +++++++
app/test.c | 0
2 files changed, 7 insertions(+)
create mode 100644 app/app.c
create mode 100644 app/test.c
diff --git a/app/app.c b/app/app.c
new file mode 100644
index 0000000..20fe868
--- /dev/null
+++ b/app/app.c
@@ -0,0 +1,7 @@
+#include <stdio.h>
+#include <stdlib.h>
+int main(void)
+{
+ printf("hello world\n");
+ return 0;
+}
\ No newline at end of file
diff --git a/app/test.c b/app/test.c
new file mode 100644
index 0000000..e69de29
--
2.16.2.windows.1
2.1.2当前提交之前n个提交git format-patch -n
如果一次想把本地未推送的提交全部生成patch,也可以试试-n参数,-1代表生成最近的一次提交的patch,-2代表生成最近两次提交的patch,以此类推。这个参数也可以用HEAD替换,HEAD^ 等效于-1,HEAD^^等效于-2,HEAD~n等效于-n。
// 将最近3次提交全部生成patch
jay@pc MINGW64 /d/my_project/gittest (master)
$ git format-patch HEAD~30001-second-commit.patch 0002-Initial-application-and-test.patch 0003-Add-initial-platform-and-update-test.patch
// 依然是将最近3次提交全部生成patch
jay@pc MINGW64 /d/my_project/gittest (master)
$ git format-patch -30001-second-commit.patch 0002-Initial-application-and-test.patch 0003-Add-initial-platform-and-update-test.patch
2.1.3某个提交之后的所有提交git format-patch [commit]
如果你觉得用-n参数显得有点繁琐,比如本地有很多个提交,你需要先往回数一共有多少个。还有一个方法是直接指定某个提交,以某个提交为基准往后的所有提交全部生成patch,比如我们以"second commit"为基准:
// 将SHA-1号前7位为867df08的提交之后的所有提交全部生成patch
jay@pc MINGW64 /d/my_project/gittest (master)
$ git format-patch 867df080001-Initial-application-and-test.patch 0002-Add-initial-platform-and-update-test.patch
2.2应用补丁包git am
2.1.3节生成了2个补丁包,让我们试着用一下这两个补丁包,在用之前我们需要先把本地仓库中这两次提交撤销并且也不保留在工作区(即完全删除)。
// 将最近两次提交在仓库里直接删除,不留痕迹
jay@pc MINGW64 /d/my_project/gittest (master)
$ git reset --hard HEAD~2HEAD is now at 867df08 second commit
// 查看本地提交日志,确实最近两次提交已被删除
jay@pc MINGW64 /d/my_project/gittest (master)
$ gitk
jay@pc MINGW64 /d/my_project/gittest (master)
$ git statusOn branch master Your branch is up to date with 'origin/master'. Untracked files: (use "git add <file>..." to include in what will be committed) 0001-Initial-application-and-test.patch 0002-Add-initial-platform-and-update-test.patch nothing added to commit but untracked files present (use "git add" to track)
2.2.1指定单个补丁包git am [patch path]
让我们试着将0001-Initial-application-and-test.patch打入我们的仓库。
// 将名为0001-Initial-application-and-test的patch文件打入仓库
jay@pc MINGW64 /d/my_project/gittest (master)
$ git am 0001-Initial-application-and-test.patchApplying: Initial application and test
// 查看本地提交日志,确实patch已经进入仓库
jay@pc MINGW64 /d/my_project/gittest (master)
$ gitk
细心的朋友可能会注意到,同一个patch在生成和打入的时候SHA-1号是不一样的,是的,Git会保证任何时候任何人在任何本地仓库生成的任何提交都是唯一的。
2.2.2指定目录下所有补丁包git am [patch dir/*.patch]
让我们试着将gittest目录下的所有patch全部打入我们的仓库,需要注意的是由于2.2.1中已经将编号为0001 patch打入了仓库,所有我们需要先将这个patch文件删除,否则在打入的时候会报错。
// 将gittest目录下的所有patch文件全部打入仓库
jay@pc MINGW64 /d/my_project/gittest (master)
$ git am *.patchApplying: Add initial platform and update test
// 查看本地提交日志,确实patch已经都进入仓库
jay@pc MINGW64 /d/my_project/gittest (master)
$ gitk
最后欢迎关注痞子衡个人微信公众号【痞子衡嵌入式】,一个专注嵌入式技术的公众号,跟着痞子衡一起玩转嵌入式。



衡杰(痞子衡),目前就职于某全球顶级半导体原厂MCU系统部门,担任高级嵌入式系统应用工程师。
专栏内所有文章的转载请注明出处:http://www.cnblogs.com/henjay724/
与痞子衡进一步交流或咨询业务合作请发邮件至 hengjie1989@foxmail.com
可以关注痞子衡的Github主页 https://github.com/JayHeng,有很多好玩的嵌入式项目。
关于专栏文章有任何疑问请直接在博客下面留言,痞子衡会及时回复免费(划重点)答疑。
痞子衡邮箱已被私信挤爆,技术问题不推荐私信,坚持私信请先扫码付款(5元起步)再发。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 浏览器原生「磁吸」效果!Anchor Positioning 锚点定位神器解析
· 没有源码,如何修改代码逻辑?
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· 百万级群聊的设计实践
· WPF到Web的无缝过渡:英雄联盟客户端的OpenSilver迁移实战
· 永远不要相信用户的输入:从 SQL 注入攻防看输入验证的重要性
· 全网最简单!3分钟用满血DeepSeek R1开发一款AI智能客服,零代码轻松接入微信、公众号、小程
· .NET 10 首个预览版发布,跨平台开发与性能全面提升