diff --git a/content/about-git.md b/content/about-git.md index 55dd03f..e9bb9c8 100644 --- a/content/about-git.md +++ b/content/about-git.md @@ -18,47 +18,57 @@ Archlinux：`sudo pacman -S git` 安装完成后检查版本：`git --version` +## 原理 + +一个Git仓库的目录里面包括``工作目录``（即我们要追踪的代码）以及``.git``目录（Git 在这里存储自己的数据）。Git 维护了三棵“树”:第一个是你的 `工作目录`，它持有实际文件；第二个是 `暂存区（Index）`，它像个缓存区域，临时保存你的改动；最后是 `HEAD`，它指向你最后一次提交的结果。 + + ## 创建新仓库 -如果你的目录不是一个 Git 仓库，你需要先初始化。 +首先我们需要得到一个Git仓库，一般有两种方法： -创建新文件夹，在你的项目目录中运行以下命令： -`git init` +- 在本地初始化之后连接到远程； +- 在远程创建后”下载“到本地。 -设置默认仓库为 main,避免因为 main/master 名称不同的牛马问题： +**方法一** +创建新文件夹，在你的项目目录中运行以下命令： +``` +git init --initial-branch=main +``` +这里设置默认仓库主分支名称为 main,避免因为 main/master 名称不同导致的推送问题。 -`git init --initial-branch=main` +**方法二** -## 克隆仓库 - -执行如下命令以创建一个本地仓库的克隆版本： -`git clone /path/to/repository` -如果是远端服务器上的仓库，你的命令会是这个样子： -`git clone username@host:/path/to/repository` +克隆远端服务器上的仓库，例如: +``` +git clone https://github.com/Dichgrem/script.git +# 这是HTTPS方法 +``` +或者使用SSH方法：`` git clone git@github.com:Dichgrem/script.git`` ## 连接远程仓库 生成密钥： - -`ssh-keygen -t rsa -b 4096 -C "your_email@example.com"` - +``` +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_key1` - -`ssh-keygen -t rsa -b 4096 -C "your_email@example.com" -f ~/.ssh/github_key2` - +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_key1` - -`ssh-add ~/.ssh/github_key2` - +ssh-add ~/.ssh/github_key2 +``` 在 `~/.ssh/config` 文件中配置不同的主机别名以及相应的密钥文件。编辑该文件并添加以下内容： +``` +# GitHub repository 1 -`# GitHub repository 1` - -`Host github1` +Host github1 HostName github.com @@ -66,135 +76,170 @@ Archlinux：`sudo pacman -S git` IdentityFile ~/.ssh/github_key1 -`# GitHub repository 2` +# GitHub repository 2 -`Host github2` +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` - +``` +ssh -T git@github.com +``` 添加远程仓库： - -`git remote add origin ` - +``` +git remote add origin +``` 比如我已经在 GitHub 上创建了一个名为 `dichos` 的仓库，你可以使用以下命令将其添加为远程仓库： - -`git remote add origin git@github.com:Dichgrem/dichos.git` - +``` +git remote add origin git@github.com:Dichgrem/dichos.git +``` 设置远程仓库 - -`git remote set-url origin git@github.com:Dichgrem/dichos.git` - +``` +git remote set-url origin git@github.com:Dichgrem/dichos.git +``` ## 工作流 -本地仓库由 git 维护的三棵“树”组成。第一个是你的 `工作目录`，它持有实际文件；第二个是 `暂存区（Index）`，它像个缓存区域，临时保存你的改动；最后是 `HEAD`，它指向你最后一次提交的结果。 - -## 创建一个分支 - -`git branch main` - +### 创建一个分支 +``` +git branch main +``` 这将创建一个名为 main 的分支。 -## 删除分支 - -`git branch -d master` - -使用大写强制删除 - -`git branch -D master` +- 删除分支 +``` +git branch -d master +``` +- 使用大写强制删除 +``` +git branch -D master +``` +### 添加和提交 -## 添加和提交 - -你可以提出更改（把它们添加到暂存区），使用如下命令： -`git add ` -`git add *` -这是 git 基本工作流程的第一步；使用如下命令以实际提交改动： -`git commit -m "代码提交信息"`如： - -`git commit -m "Initial commit"` +你可以提出更改（把它们添加到暂存区），使用如下命令： +``` +git add +git add * +``` +这是 git 基本工作流程的第一步；使用如下命令以实际提交改动： +``` +git commit -m "代码提交信息" +# 例如：git commit -m "Initial commit" +``` 现在，你的改动已经提交到了 **HEAD**，但是还没到你的远端仓库。 ## 推送改动 -你的改动现在已经在本地仓库的 **HEAD** 中了。执行如下命令以将这些改动提交到远端仓库： -`git push origin master` +你的改动现在已经在本地仓库的 **HEAD** 中了。执行如下命令以将这些改动提交到远端仓库： +``` +git push origin master +``` 可以把 *master* 换成你想要推送的任何分支。 -如果你还没有克隆现有仓库，并欲将你的仓库连接到某个远程服务器，你可以使用如下命令添加： -`git remote add origin ` +如果你还没有克隆现有仓库，并欲将你的仓库连接到某个远程服务器，你可以使用如下命令添加： +``` +git remote add origin +``` 如此你就能够将你的改动推送到所添加的服务器上去了。 ## 合并分支 分支是用来将特性开发绝缘开来的。在你创建仓库的时候，*master* 是“默认的”分支。在其他分支上进行开发，完成后再将它们合并到主分支上。 -创建一个叫做“feature_x”的分支，并切换过去： -`git checkout -b feature_x` -切换回主分支： -`git checkout master` -再把新建的分支删掉： -`git branch -d feature_x` -除非你将分支推送到远端仓库，不然该分支就是 *不为他人所见的*： -`git push origin ` - +创建一个叫做“feature_x”的分支，并切换过去： +``` +git checkout -b feature_x +``` +切换回主分支： +``` +git checkout master +``` +再把新建的分支删掉： +``` +git branch -d feature_x +``` +除非你将分支推送到远端仓库，不然该分支就是 *不为他人所见的*： +``` +git push origin +``` ## 更新与合并 -要更新你的本地仓库至最新改动，执行： -`git pull` +要更新你的本地仓库至最新改动，执行： +``` +git pull +``` 以在你的工作目录中 ***获取**（fetch）* 并 ***合并**（merge）* 远端的改动。 -要合并其他分支到你的当前分支（例如 master），执行： -`git merge ` -在这两种情况下，git 都会尝试去自动合并改动。遗憾的是，这可能并非每次都成功，并可能出现_冲突（conflicts）*。 这时候就需要你修改这些文件来手动合并这些_冲突（conflicts）*。改完之后，你需要执行如下命令以将它们标记为合并成功： -`git add ` +要合并其他分支到你的当前分支（例如 master），执行： +``` +git merge +``` +在这两种情况下，git 都会尝试去自动合并改动。遗憾的是，这可能并非每次都成功，并可能出现_冲突（conflicts）*。 这时候就需要你修改这些文件来手动合并这些_冲突（conflicts）*。改完之后，你需要执行如下命令以将它们标记为合并成功： +``` +git add 在合并改动之前，你可以使用如下命令预览差异： -`git diff ` - +git diff +``` ## 标签 -为软件发布创建标签是推荐的。这个概念早已存在，在 SVN 中也有。你可以执行如下命令创建一个叫做 *1.0.0* 的标签： -`git tag 1.0.0 1b2e1d63ff` -*1b2e1d63ff* 是你想要标记的提交 ID 的前 10 位字符。可以使用下列命令获取提交 ID： -`git log` +为软件发布创建标签是推荐的。这个概念早已存在，在 SVN 中也有。你可以执行如下命令创建一个叫做 *1.0.0* 的标签： +``` +git tag 1.0.0 1b2e1d63ff +``` +*1b2e1d63ff* 是你想要标记的提交 ID 的前 10 位字符。可以使用下列命令获取提交 ID： +``` +git log +``` 你也可以使用少一点的提交 ID 前几位，只要它的指向具有唯一性。 ## 日志 如果你想了解本地仓库的历史记录，最简单的命令就是使用: -`git log` +``` +git log +``` 你可以添加一些参数来修改他的输出，从而得到自己想要的结果。 只看某一个人的提交记录: -`git log --author=bob` -一个压缩后的每一条提交记录只占一行的输出: -`git log --pretty=oneline` +``` +git log --author=bob +``` +一个压缩后的每一条提交记录只占一行的输出: +``` +git log --pretty=oneline +``` 或者你想通过 ASCII 艺术的树形结构来展示所有的分支, 每个分支都标示了他的名字和标签: -`git log --graph --oneline --decorate --all` -看看哪些文件改变了: -`git log --name-status` -这些只是你可以使用的参数中很小的一部分。更多的信息，参考： -`git log --help` - +``` +git log --graph --oneline --decorate --all +``` +看看哪些文件改变了: +``` +git log --name-status +``` +这些只是你可以使用的参数中很小的一部分。更多的信息，参考： +``` +git log --help +``` ## 替换本地改动 假如你操作失误（当然，这最好永远不要发生），你可以使用如下命令替换掉本地改动： -`git checkout -- ` +``` +git checkout -- +``` 此命令会使用 HEAD 中的最新内容替换掉你的工作目录中的文件。已添加到暂存区的改动以及新文件都不会受到影响。 假如你想丢弃你在本地的所有改动与提交，可以到服务器上获取最新的版本历史，并将你本地主分支指向它： -`git fetch origin` -`git reset --hard origin/master` - +``` +git fetch origin +git reset --hard origin/master +``` ## 合并commit记录 ``` @@ -254,35 +299,35 @@ git reset --hard HEAD~1 - 而使用 `ssh协议` 时，代理需要配置ssh的 `ProxyCommand` 参数 由于个人需求仅仅是 HTTP 的代理（相对来说，HTTP 有比较好的通适性，Windows 配置git/ssh比较棘手），设置的时候，只需要针对单个设置 `http.proxy` 即可，在需要使用代理的项目下面使用 `git bash` 如下命令进行设置（你的Uri和port可能和我的不同）： - -`git config http.proxy` [http://127.0.0.1:2080](http://127.0.0.1:8088) `# 也可以是uri:port形式` - +``` +git config http.proxy [http://127.0.0.1:2080](http://127.0.0.1:8088) # 也可以是uri:port形式 +``` 这个是不需要鉴权的代理设置，如果需要鉴权，可能需要添加用户名密码信息： - -`git config http.proxy` [http://username:password@127.0.0.1:2080](http://username:password@127.0.0.1:8088) - +``` +git config http.proxy[http://username:password@127.0.0.1:2080](http://username:password@127.0.0.1:8088) +``` 如果git的所有项目都需要启用代理，那么可以直接启用全局设置： - -`git config --global http.proxy` [http://127.0.0.1:2080](http://127.0.0.1:8088) - +``` +git config --global http.proxy [http://127.0.0.1:2080](http://127.0.0.1:8088) +``` 为了确认是否已经设置成功，可以使用 `--get` 来获取： - -`git config --get --global http.proxy` - +``` +git config --get --global http.proxy +``` 这样可以看到你设置在global的 `http.proxy` 值。  需要修改的时候，再次按照上面的方法设置即可，git 默认会覆盖原有的配置值。 当我们的网络出现变更时，可能需要删除掉原有的代理配置，此时需要使用 `--unset` 来进行配置： - -`git config --global --unset http.proxy` - +``` +git config --global --unset http.proxy +``` 在命令之后，指定位置的设置值将会被清空，你可以再次使用 `--get` 来查看具体的设置情况。 如果使用了 HTTPS，肯呢个会碰到 HTTPS 证书错误的情况，比如提示： `SSL certificate problem` ，此时，可以尝试将 `sslVerify` 设置为 `false` ： - -`git config --global http.sslVerify false` - +``` +git config --global http.sslVerify false +``` 恩，到此，可以试试 git 来获取/更改项目了，此时，项目应该是使用代理来进行通讯的。 ## 注意 @@ -306,7 +351,7 @@ git@github.com: Permission denied (publickey). ``` ssh-add ~/.ssh/id_rsa ``` -## commit规范 +## Commit规范 1. 提交信息的基本格式