企业🤖AI Agent构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
## git commit 记录缓存内容的快照 现在你使用 `git add` 命令将想要快照的内容写入了缓存, 执行 `git commit` 就将它实际存储快照了。 Git 为你的每一个提交都记录你的名字与电子邮箱地址,所以第一步是告诉 Git 这些都是啥。 ~~~ $ git config --global user.name 'Your Name' $ git config --global user.email you@somedomain.com ~~~ 让我们写入缓存,并提交对 `hello.rb` 的所有改动。在首个例子中,我们使用 `-m` 选项以在命令行中提供提交注释。 ~~~ $ git add hello.rb $ git status -s M hello.rb $ git commit -m 'my hola mundo changes' [master 68aa034] my hola mundo changes 1 files changed, 2 insertions(+), 1 deletions(-) ~~~ 现在我们已经记录了快照。如果我们再执行 `git status`,会看到我们有一个“干净的工作目录”。 这意味着我们在最近一次提交之后,没有做任何改动 —— 在我们的项目中没有未快照的工作。 ~~~ $ git status # On branch master nothing to commit (working directory clean) ~~~ 如果你漏掉了 `-m` 选项,Git 会尝试为你打开一个编辑器以填写提交信息。 如果 Git 在你对它的配置中找不到相关信息,默认会打开 `vim`。屏幕会像这样: ~~~ # Please enter the commit message for your changes. Lines starting # with '#' will be ignored, and an empty message aborts the commit. # On branch master # Changes to be committed: # (use "git reset HEAD ..." to unstage) # # modified: hello.rb # ~ ~ ".git/COMMIT_EDITMSG" 9L, 257C ~~~ 在此,你在文件头部添加实际的提交信息。以“#”开头的行都会被无视 ——Git 将 `git status` 的输出结果放在那儿以提示你都改了、缓存了啥。 通常,撰写良好的提交信息是很重要的。以开放源代码项目为例,多多少少以以下格式写你的提示消息是个不成文的规定: 简短的关于改动的总结(25个字或者更少) 如果有必要,更详细的解释文字。约 36 字时换行。在某些情况下, 第一行会被作为电子邮件的开头,而剩余的则会作为邮件内容。 将小结从内容隔开的空行是至关重要的(除非你没有内容); 如果这两个待在一起,有些 git 工具会犯迷糊。 空行之后是更多的段落。 - 列表也可以 - 通常使用连字符(-)或者星号(*)来标记列表,前面有个空格, 在列表项之间有空行,不过这些约定也会有些变化。 ~~~ # Please enter the commit message for your changes. Lines starting # with '#' will be ignored, and an empty message aborts the commit. # On branch master # Changes to be committed: # (use "git reset HEAD ..." to unstage) # # modified: hello.rb # ~ ~ ~ ".git/COMMIT_EDITMSG" 25L, 884C written ~~~ 提交注解是很重要的。因为 Git 很大一部分能耐就是它在组织本地提交和与他人分享的弹性, 它很给力地能够让你为逻辑独立的改变写三到四条提交注解,以便你的工作被同仁审阅。因为提交与推送改动是有区别的, 请务必花时间将各个逻辑独立的改动放到另外一个提交,并附上一份良好的提交注解, 以使与你合作的人能够方便地了解你所做的,以及你为何要这么做。 ### git commit -a 自动将在提交前将已记录、修改的文件放入缓存区 如果你觉得 `git add` 提交缓存的流程太过繁琐,Git 也允许你用 `-a` 选项跳过这一步。 基本上这句话的意思就是,为任何已有记录的文件执行 `git add` —— 也就是说,任何在你最近的提交中已经存在,并且之后被修改的文件。 这让你能够用更 Subversion 方式的流程,修改些文件,然后想要快照所有所做的改动的时候执行 `git commit -a`。 不过你仍然需要执行 `git add` 来添加新文件,就像 Subversion 一样。 ~~~ $ vim hello.rb $ git status -s M hello.rb $ git commit -m 'changes to hello file' # On branch master # Changed but not updated: # (use "git add ..." to update what will be committed) # (use "git checkout -- ..." to discard changes in working directory) # # modified: hello.rb # no changes added to commit (use "git add" and/or "git commit -a") $ git commit -am 'changes to hello file' [master 78b2670] changes to hello file 1 files changed, 2 insertions(+), 1 deletions(-) ~~~ 注意,如果你不缓存改动,直接执行 `git commit`,Git 会直接给出 `git status` 命令的输出,提醒你啥也没缓存。我已将该消息中的重要部分高亮,它说没有添加需要提交的缓存。 如果你使用 `-a`,它会缓存并提交每个改动(不含新文件)。 现在你就完成了整个快照的流程 ——改些文件,然后用 `git add` 将要提交的改动提交到缓存, 用 `git status` 和 `git diff` 看看你都改了啥,最后 `git commit` 永久地保存快照。 > **简而言之**,执行 `git commit` 记录缓存区的快照。如果需要的话,这个快照可以用来做比较、共享以及恢复。