一文教你成为git老手

常用命令

git init

用途：初始化一个新的Git仓库。
示例：

git init

git clone [url]

用途：克隆一个远程仓库到本地。
示例：

git clone https://github.com/username/repository.git

git status

用途：查看当前工作目录的状态，显示有哪些改动（包括未跟踪、修改、暂存的文件）。
示例：

git status

git add [file]

用途：将文件的改动添加到暂存区（stage）。
示例：

git add README.md

git commit -m “commit message”

用途：将暂存区的改动提交到仓库的历史记录中。
示例：

git commit -m "Add README file"

git push [remote-name] [branch-name]

用途：将本地仓库的提交推送到远程仓库。
示例：

git push origin main

git pull [remote-name] [branch-name]

用途：从远程仓库拉取最新的内容并自动合并到本地仓库。
示例：

git pull origin main

git branch

用途：列出、创建或删除分支。
示例：

列出所有分支：

git branch

创建新分支：

git branch new-feature

git checkout [branch-name]

用途：切换到指定的分支。
示例：

git checkout new-feature

git merge [branch-name]

用途：将指定分支的历史合并到当前分支。
示例：

git merge new-feature

git log

用途：查看提交历史记录。
示例：

git log

git diff

用途：查看未暂存的文件更新了哪些内容。
示例：

git diff

git reset [file]

用途：从暂存区移除文件，但不影响文件当前的内容。
示例：

git reset README.md

git revert [commit]

用途：撤销指定的提交。
示例：

git revert a867b4af

git fetch [remote-name]

用途：从远程仓库获取最新的变更，但不自动合并到本地任何分支。
示例：

git fetch origin

进阶

git remote set-url 如何修改本地仓库指向的url

如果需要修改本地Git仓库指向的远程仓库URL，你可以使用git remote命令。这通常在迁移远程仓库或更改远程仓库的地址时需要做。以下是具体操作步骤：

查看当前远程仓库配置
首先，你可以使用以下命令查看当前的远程仓库配置：

git remote -v

这将显示远程仓库的名称及其对应的URL，通常默认远程仓库名称为origin。

修改远程仓库URL
可以使用git remote set-url命令来修改远程仓库的URL。例如，如果你想要修改名为origin的远程仓库地址，你可以这样做：

git remote set-url origin 新的远程仓库URL
例如：

git remote set-url origin https://github.com/username/new-repository.git

验证URL是否修改成功
修改完成后，你可以再次使用git remote -v命令来确认远程仓库URL是否已经更新。

git remote -v

输出应该显示新的URL。

如果你有多个远程仓库，你需要指定你想要修改的远程仓库名字。如果你只是想要临时更换远程仓库地址，可以使用带URL的git push或git fetch命令，但这不会改变配置文件中的URL。

使用git remote set-url命令是一种直接且永久性的方法，它会更改.git/config文件中的对应条目。

git cherry-pick

如果你想要合并多个连续的提交（commit），可以使用git rebase命令进行交互式变基（interactive rebase）。下面的步骤和示例将指导你如何合并多个提交：

启动交互式变基
假设你要合并最近的几个提交，你可以这样做：

git rebase -i HEAD~N

其中N是你想要查看和可能合并的提交数量。例如，如果你想要处理最近的3个提交：

git rebase -i HEAD~3

选择要合并的提交
这将打开一个文本编辑器，列出了你选择查看的最近的提交。

pick 1a2b3c4 第一个提交信息
pick 4d5e6f7 第二个提交信息
pick 7g8h9i0 第三个提交信息

为了合并这些提交，你需要将除了第一个提交外的其他提交前面的pick命令改为squash或者s. 这表示你想将这些提交合并到它们之前的提交中。

pick 1a2b3c4 第一个提交信息
squash 4d5e6f7 第二个提交信息
squash 7g8h9i0 第三个提交信息

合并提交信息
保存并关闭编辑器后，Git将开始合并这些提交。如果有多个提交被合并，Git将提示你将多个提交信息合并为一个。

解决可能出现的冲突
如果在合并过程中出现冲突，Git会暂停并允许你手动解决这些冲突。解决冲突后，使用以下命令继续变基过程：

git rebase --continue

如果你想要取消变基并回到变基之前的状态，可以使用：

git rebase --abort

完成变基
一旦所有的冲突都解决了，并且你完成了提交信息的编辑，变基操作就完成了。此时，你的提交历史将被重写，多个提交被合并为一个新的提交。

请注意，变基会改变历史，如果你正在变基已经推送到远程仓库的提交，并且其他人可能基于这些提交进行了工作，这可能会导致问题。在对公共历史进行变基之前，确保这是团队协商好的操作，并且所有团队成员都了解如何处理变基后的历史。

git tag

git tag 命令在Git中用于创建一个标签（tag），这个标签可以作为代码库中特定点的引用。标签通常用于发布版本（如v1.0, v2.0等）的标记，以便快速访问特定的历史版本。

Git中有两种类型的标签：轻量级标签（lightweight）和附注标签（annotated）。

轻量级标签（Lightweight）: 轻量级标签类似于一个不会改变的分支，它只是一个特定提交的引用，不包含其他信息。

创建轻量级标签

命令格式如下：

git tag <tagname>

示例：

git tag v1.0

这样会在当前的HEAD位置创建一个轻量级标签v1.0。

附注标签（Annotated）: 附注标签是存储在Git数据库中的一个完整对象，它包含着标签创建者的名字、电子邮件、日期，并附有一个信息说明，可以通过GPG进行签名和验证。

创建附注标签

命令格式如下（通常使用-a选项）：

git tag -a <tagname> -m "message"

其中-a选项意味着创建一个附注标签，-m后面跟随标签的说明信息。

示例：

git tag -a v1.0 -m "Release version 1.0"

这样会在当前的HEAD位置创建一个附注标签v1.0，并附上消息"Release version 1.0"。

附注标签包含了更多的元数据信息，这些信息有助于其他开发者了解这个标签的创建背景，因此被认为是一种更加正式的标签创建方式。轻量级标签更多地作为临时的标记使用，因为它不包含这些额外信息。

在项目中需要创建具有重要历史意义的标签时（如版本发布），推荐使用附注标签。轻量级标签则适合用于个人的临时标记，因为其创建速度更快，且不包含额外信息。

最后，与任何类型的Git对象一样，标签在创建后不应更改其指向的提交。如果需要指向新的提交，应创建新的标签。

删除一个tag

要删除一个Git标签，你可以使用以下命令：

删除本地标签

git tag -d <tagname>

这条命令会从本地仓库中删除指定的标签。例如：

git tag -d v1.0

这条命令会删除本地仓库中名为v1.0的标签。

删除远程标签
首先，你需要删除本地的标签，然后你可以使用git push命令将这个删除操作推送到远程仓库：

git push --delete <remote> <tagname>

或者使用冒号（:）语法：

git push <remote> :refs/tags/<tagname>

这里，是远程仓库的名称（通常是origin），是要删除的标签名称。例如：

git push --delete origin v1.0

或者：

git push origin :refs/tags/v1.0

这两条命令都会删除远程仓库中名为v1.0的标签。

请注意，在推送删除远程仓库的标签之前，确保没有其他的分支或工作依赖于这个标签，因为一旦删除，其他人将无法再使用这个标签来检出代码。

git log的进阶使用

基本使用

在最简单的形式中，git log 会按照提交时间的逆序列出提交历史，显示每个提交的SHA-1检验和、作者的名字和邮箱、提交时间以及提交信息。

git log

1. 常用选项
   git log 提供了许多选项来定制输出的信息：

• -n : 限制输出的提交数量。例如，git log -n 3 会显示最近的三次提交。
• –since=, --after=: 只显示指定日期之后的提交。
• –until=, --before=: 只显示指定日期之前的提交。
• –author=: 只显示作者匹配指定模式的提交。
• –grep=: 只显示提交信息中匹配指定模式的提交。
• –no-merges: 不显示合并提交。
• –stat: 显示每次提交的文件更改统计信息。
• –pretty=<style> 或 --format=: 指定输出格式样式或自定义格式。
• -p 或 --patch: 显示每次提交的差异（即补丁内容）。

2. 格式化输出
   git log 的 --pretty 和 --format 选项可以用来定制化输出。–pretty 提供了一些内置的格式：

oneline: 将每个提交显示在单独一行上，通常会显示提交的SHA-1的前几个字符和提交信息。
short, medium, full, fuller: 这些都是不同的详细程度的输出格式，具体显示的信息量不同。
自定义格式可以使用 --format 选项指定，其中可以使用特定的占位符来表示各种提交信息：

• %H: 提交的完整SHA-1哈希值。
• %h: 提交的SHA-1哈希值的简短版本。
• %an: 作者的名字。
• %ae: 作者的邮箱。
• %ad: 作者的提交日期（可以用 --date 选项进行格式化）。
• %cn: 提交者的名字（一个人可能代表另一个人提交）。
• %ce: 提交者的邮箱。
• %cd: 提交者的提交日期。
• %s: 提交信息的标题。
• %b: 提交信息的正文。
• %p: 父提交的SHA-1哈希值。
• %d: 引用名称（例如，分支名、标签名）。
  例如：

git log --pretty=format:"%h - %an, %ar : %s"

这个命令会输出类似下面的格式化信息：

a1b2c3d - John Doe, 3 days ago : Fix bug #42
d4e5f6g - Jane Smith, 5 days ago : Add new feature

这里 %h 是提交哈希值的简短版本，%an 是作者名字，%ar 是相对提交日期，%s 是提交信息标题。

复杂的示例：

git log --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit

该 git log 命令使用了几个选项来生成一个装饰和格式化的提交历史图。以下是命令的详细解释：

• –graph：这个选项添加了一个文本模式的图形表示在左侧，用来展示分支、合并历史。
• –pretty=format:‘…’：这个选项用于自定义日志信息的格式。每个 % 后面的字符指代了git log中的特定占位符。
• %Cred, %Creset, %C(yellow), %Cgreen, %C(bold blue)：这些是颜色占位符。%C 打开颜色显示，后面紧跟着颜色名（如red、yellow、green、blue）。%Creset 用来重置文字颜色回到默认值。这样可以让日志输出带有颜色，便于区分不同的信息部分。
• %h：提交的简短哈希值，这是完整哈希的缩写。
• %d：装饰字符串，包括分支名、标签名等。
• %s：提交信息的标题。
• %cr：相对日期（比如，“3 days ago”）。
• %an：作者名字。
• –abbrev-commit：这个选项缩短SHA-1哈希值的长度，使得输出更为紧凑。

整个格式化字符串 '… 定义了每次提交的日志格式，结合了颜色和占位符。这些颜色和格式设置使得输出的日志易于阅读和区分。

参考文档

• git 中文官方文档