1 设置用户名和邮箱

git config --global user.name "your name"
git config --global user.email "your email"

--global 表示全局设置，如果只想对当前仓库生效，去掉 --global 即可。

GitHub 等代码托管平台会为用户提供一个匿名邮箱地址。就 GitHub 来说，在 Settings -> Emails 中勾选 Keep my email addresses private，然后就可以看到 GitHub 分配的类似于 123456+user@users.noreply.github.com 的匿名邮箱地址。匿名邮箱地址可以保护个人隐私，同时也能将提交与平台账户关联起来，方便在平台上查看提交历史和贡献记录。

如果不需要关联账户，或代码托管于多个平台，可以使用一个虚假的邮箱地址。

2 初始化本地仓库和远程仓库

1. 初始化本地仓库

   bash

   git init

2. 创建远程空仓库 (如果没有)

   登录 GitHub，点击右上角 +，选择 New repository，填写信息，点击 Create repository。输入仓库名，其余保持默认即可，点击 Create repository。

3. 关联本地仓库和远程仓库

   bash

   git remote add origin <远程仓库地址>

4. 暂存并创建 commit

   bash

   git add .
   git commit -m "message"

5. 将本地仓库内容推送到远程仓库

   bash

   git push --set-upstream origin master

   或

   bash

   git push -u origin master

3 撤销已 commit 的更改

1. 保留更改到暂存区

   bash

   git reset --soft HEAD~1

2. 删除更改

   bash

   git reset --hard HEAD~1

fatal: ambiguous argument 'HEAD~1': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'

4 修改某个 commit 的 message

假设修改第 n 个 (以最近的 commit 为 1) commit 的 message：

git rebase -i HEAD~n

在弹出的编辑器中，将需要修改的 commit 前的 pick 改为 reword，保存并关闭编辑器。接着会弹出一个新的编辑器，修改 message 后保存并关闭编辑器。

5 合并多个 commit

假设合并最近的 n 个 commit：

方法一：

git rebase -i HEAD~n

在弹出的编辑器中，将需要合并的 commit 前的 pick 改为 squash，保存并关闭编辑器。接着会弹出一个新的编辑器，修改 message 后保存并关闭编辑器。

方法二：

git reset --soft HEAD~n
git commit -m "new message"

6 强制推送

git push --force

多人协作时不建议使用，必要时可以使用 git push --force-with-lease。它会检查远程仓库是否有新的更改，如果有则拒绝推送。

7 批量修改提交者信息

新建一个.mailmap 文件，格式为以下之一：

Correct Name <correct@email.com> Wrong Name <wrong@email.com>
Correct Name <correct@email.com> <wrong@email.com>
<correct@email.com> <wrong@email.com>

例如：

user1 <1@1.com> user2 <2@2.com>

再执行：

git filter-repo --mailmap .mailmap --force
git push --force

.mailmap 代表该文件的路径，可以手动指定。

8 将原仓库的更改同步到 fork 的仓库

1. 添加上游远程仓库

   bash

   git remote add upstream <原仓库地址>

2. 获取上游远程仓库的更改

   bash

   git fetch upstream

3. 切换到本地的主分支

   bash

   git checkout <主分支名称>

4. 将上游远程仓库的更改应用到本地分支

   • 使用 merge 方法

     bash

     git merge upstream/<主分支名称>

     如果有冲突，你会看到类似如下的信息：

     text

     CONFLICT (content): Merge conflict in <冲突文件路径>

     打开冲突的文件，你会看到类似如下的标记：

     text

     <<<<<<< HEAD
     你的代码
     =======
     上游的代码
     >>>>>>> upstream/main

     你需要手动编辑冲突的文件，并删除所有标记 (<<<<<<<, =======, >>>>>>>)，然后保存文件。

     解决所有冲突后执行：

     bash

     git add .
     git commit -m "Merge upstream changes"

   • 使用 rebase 方法

     bash

     git rebase upstream/<主分支名称>

     冲突处理同上。

     解决冲突后执行：

     bash

     git add <冲突文件路径>
     git rebase --continue

5. 将本地分支的更改推送到 fork 的远程仓库

   bash

   git push origin <主分支名称> --force

9 浅克隆

当只需要获取仓库的最新状态，而不需要完整的提交历史时，可以使用浅克隆来节省时间和存储空间。

git clone --depth 1 <仓库地址>

--depth 1 表示只克隆最近的一次提交，可以根据需要调整深度。

如果需要在浅克隆的基础上获取更多的提交，可以使用以下命令：

git fetch --deepen <深度>

该命令会在当前的基础上再获取更多的提交，<深度> 表示要获取的提交数量。比如原来克隆了最近的 1 次提交，执行 git fetch --deepen 4 后会获取最近的 4 次提交，使本地仓库总共包含最近的 5 次提交。

或者使用以下命令：

git fetch --depth <深度>

该命令会将修改克隆深度。比如原来克隆了最近的 1 次提交，执行 git fetch --depth 4 后就会获取最近的 3 次提交，使本地仓库总共包含最近的 4 次提交。

使用以下命令将浅克隆转换为完整克隆：

git fetch --unshallow

如果要针对特定分支，可以使用以下命令：

git fetch <远程名称> <分支名称> --deepen <深度>
git fetch <远程名称> <分支名称> --depth <深度>
git fetch <远程名称> <分支名称> --unshallow

如果需要设置某个子模块为浅克隆，在 .gitmodules 文件中的对应条目添加 shallow = true 配置即可。