乱七八糟:Git使用简明手册

前言 Git，作为现代软件开发中不可或缺的版本控制工具，常常让初学者感到困惑。本文旨在介绍 Git 的全流程安装和基本使用，希望能够帮助新手更轻松地理解和掌握 Git 的基本概念和操作。

安装git

Windows：https://git-scm.com/download/

Archlinux：sudo pacman -S git

安装完成后检查版本：git --version

创建新仓库

如果你的目录不是一个 Git 仓库，你需要先初始化。

创建新文件夹，在你的项目目录中运行以下命令：
git init

设置默认仓库为 main,避免因为 main/master 名称不同的牛马问题：

git init --initial-branch=main

克隆仓库

执行如下命令以创建一个本地仓库的克隆版本：
git clone /path/to/repository
如果是远端服务器上的仓库，你的命令会是这个样子：
git clone username@host:/path/to/repository

连接远程仓库

生成密钥：

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

可以生成多个不同名字的密钥：

ssh-keygen -t rsa -b 4096 -C "your_email@example.com" -f ~/.ssh/github_key1

ssh-keygen -t rsa -b 4096 -C "your_email@example.com" -f ~/.ssh/github_key2

使用 ssh-add 命令将生成的密钥添加到 SSH 代理中。

ssh-add ~/.ssh/github_key1

ssh-add ~/.ssh/github_key2

在 ~/.ssh/config 文件中配置不同的主机别名以及相应的密钥文件。编辑该文件并添加以下内容：

# GitHub repository 1

Host github1

HostName github.com

User git

IdentityFile ~/.ssh/github_key1

# GitHub repository 2

Host github2

HostName github.com

User git

IdentityFile ~/.ssh/github_key2

随后将cat ~/.ssh/id_rsa.pub,将其添加至 Github的Deploy密钥中，勾选write权限；

连接到github：

ssh -T git@github.com

添加远程仓库：

git remote add origin <remote_repository_url>

比如我已经在 GitHub 上创建了一个名为 dichos 的仓库，你可以使用以下命令将其添加为远程仓库：

git remote add origin git@github.com:Dichgrem/dichos.git

设置远程仓库

git remote set-url origin git@github.com:Dichgrem/dichos.git

工作流

本地仓库由 git 维护的三棵“树”组成。第一个是你的 工作目录，它持有实际文件；第二个是 暂存区（Index），它像个缓存区域，临时保存你的改动；最后是 HEAD，它指向你最后一次提交的结果。

创建一个分支

git branch main

这将创建一个名为 main 的分支。

删除分支

git branch -d master

使用大写强制删除

git branch -D master

添加和提交

你可以提出更改（把它们添加到暂存区），使用如下命令：
git add <filename>
git add *
这是 git 基本工作流程的第一步；使用如下命令以实际提交改动：
git commit -m "代码提交信息"如：

git commit -m "Initial commit"
现在，你的改动已经提交到了 HEAD，但是还没到你的远端仓库。

推送改动

你的改动现在已经在本地仓库的 HEAD 中了。执行如下命令以将这些改动提交到远端仓库：
git push origin master
可以把 master 换成你想要推送的任何分支。

如果你还没有克隆现有仓库，并欲将你的仓库连接到某个远程服务器，你可以使用如下命令添加：
git remote add origin <server>
如此你就能够将你的改动推送到所添加的服务器上去了。

合并分支

分支是用来将特性开发绝缘开来的。在你创建仓库的时候，master 是“默认的”分支。在其他分支上进行开发，完成后再将它们合并到主分支上。

创建一个叫做“feature_x”的分支，并切换过去：
git checkout -b feature_x
切换回主分支：
git checkout master
再把新建的分支删掉：
git branch -d feature_x
除非你将分支推送到远端仓库，不然该分支就是 不为他人所见的：
git push origin <branch>

更新与合并

要更新你的本地仓库至最新改动，执行：
git pull
以在你的工作目录中 获取（fetch） 并 合并（merge） 远端的改动。
要合并其他分支到你的当前分支（例如 master），执行：
git merge <branch>
在这两种情况下，git 都会尝试去自动合并改动。遗憾的是，这可能并非每次都成功，并可能出现_冲突（conflicts）。 这时候就需要你修改这些文件来手动合并这些_冲突（conflicts）。改完之后，你需要执行如下命令以将它们标记为合并成功：
git add <filename>
在合并改动之前，你可以使用如下命令预览差异：
git diff <source_branch> <target_branch>

标签

为软件发布创建标签是推荐的。这个概念早已存在，在 SVN 中也有。你可以执行如下命令创建一个叫做 1.0.0 的标签：
git tag 1.0.0 1b2e1d63ff
1b2e1d63ff 是你想要标记的提交 ID 的前 10 位字符。可以使用下列命令获取提交 ID：
git log
你也可以使用少一点的提交 ID 前几位，只要它的指向具有唯一性。

日志

如果你想了解本地仓库的历史记录，最简单的命令就是使用:
git log
你可以添加一些参数来修改他的输出，从而得到自己想要的结果。 只看某一个人的提交记录:
git log --author=bob
一个压缩后的每一条提交记录只占一行的输出:
git log --pretty=oneline
或者你想通过 ASCII 艺术的树形结构来展示所有的分支, 每个分支都标示了他的名字和标签:
git log --graph --oneline --decorate --all
看看哪些文件改变了:
git log --name-status
这些只是你可以使用的参数中很小的一部分。更多的信息，参考：
git log --help

替换本地改动

假如你操作失误（当然，这最好永远不要发生），你可以使用如下命令替换掉本地改动：
git checkout -- <filename>
此命令会使用 HEAD 中的最新内容替换掉你的工作目录中的文件。已添加到暂存区的改动以及新文件都不会受到影响。

假如你想丢弃你在本地的所有改动与提交，可以到服务器上获取最新的版本历史，并将你本地主分支指向它：
git fetch origin
git reset --hard origin/master

修改默认分支

git目前默认的主分支为 master，和 github 默认分支 main 不同，这使得默认配置下 git 往往连接失败。可以通过下两种方法改变默认分支。在本地 git init 时将默认分支修改成main

1. git --version  //查看版本
2. git config --global init.defaultBranch main  //将默认分支修改成main
3. git init //本地项目文件夹内创建.git文件夹
4. git add . //添加到暂存区
5. git commit -a [描述的内容]  //记录修改行为
6. git pull --rebase origin main  //拉github上的readme.md
7. git push origin main   //上传代码

也可以不修改git上的默认分支，而是修改github上库的默认分支。

Windows下git使用代理

由于网络环境的差异，Git连接github需要代理，或者全局模式。Git支持四种协议，而除本地传输外，还有：git://, ssh://, 基于HTTP协议，这些协议又被分为哑协议（HTTP协议）和智能传输协议。对于这些协议，要使用代理的设置也有些差异：

• 使用 git协议 时，设置代理需要配置 core.gitproxy

• 使用 HTTP协议 时，设置代理需要配置 http.proxy

• 而使用 ssh协议 时，代理需要配置ssh的 ProxyCommand 参数

由于个人需求仅仅是 HTTP 的代理（相对来说，HTTP 有比较好的通适性，Windows 配置git/ssh比较棘手），设置的时候，只需要针对单个设置 http.proxy 即可，在需要使用代理的项目下面使用 git bash 如下命令进行设置（你的Uri和port可能和我的不同）：

git config http.proxy http://127.0.0.1:2080 # 也可以是uri:port形式

这个是不需要鉴权的代理设置，如果需要鉴权，可能需要添加用户名密码信息：

git config http.proxy http://username:password@127.0.0.1:2080

如果git的所有项目都需要启用代理，那么可以直接启用全局设置：

git config --global http.proxy http://127.0.0.1:2080

为了确认是否已经设置成功，可以使用 --get 来获取：

git config --get --global http.proxy

这样可以看到你设置在global的 http.proxy 值。 

需要修改的时候，再次按照上面的方法设置即可，git 默认会覆盖原有的配置值。

当我们的网络出现变更时，可能需要删除掉原有的代理配置，此时需要使用 --unset 来进行配置：

git config --global --unset http.proxy

在命令之后，指定位置的设置值将会被清空，你可以再次使用 --get 来查看具体的设置情况。

如果使用了 HTTPS，肯呢个会碰到 HTTPS 证书错误的情况，比如提示： SSL certificate problem ，此时，可以尝试将 sslVerify 设置为 false ：

git config --global http.sslVerify false

恩，到此，可以试试 git 来获取/更改项目了，此时，项目应该是使用代理来进行通讯的。

注意

• 不要多次使用不同的参数来设置代理，一般使用文中两种方式酌情选用即可， --global ， --system ， --local 各级设置后，可能会给自己带来不必要的麻烦。git默认是先到 git Repository 的配置文件中查找配置文件，如果没有才会到 --global 设置的文件中查找，因此，单个项目文件中的设置会覆盖 --global 的设置。
• 使用 --global 来配置的信息保存在当前用户的根目录下的 .config 文件中，而仓库中的配置保存在项目仓库的根目录下的 .git/config 文件中。
• 如果是 Linux 的用户，建议全局代理。

20240501更新完系统出现以下报错:

sign_and_send_pubkey: signing failed for RSA "/home/dich/.ssh/id_rsa" from agent: agent refused operation
git@github.com: Permission denied (publickey).
致命错误：无法读取远程仓库。

请确认您有正确的访问权限并且仓库存在。

解决方法是使用 ssh-add 命令重新添加你的密钥。

ssh-add ~/.ssh/id_rsa