diff --git a/content/about-git.md b/content/about-git.md index e9bb9c8..7b2b83e 100644 --- a/content/about-git.md +++ b/content/about-git.md @@ -12,11 +12,9 @@ tags = ["乱七八糟"] ## 安装git -Windows：[https://git-scm.com/download/](https://git-scm.com/download/) +- Windows：[Git-download](https://git-scm.com/download/) -Archlinux：`sudo pacman -S git` - -安装完成后检查版本：`git --version` +- Archlinux：`sudo pacman -S git` ## 原理 @@ -37,6 +35,10 @@ git init --initial-branch=main ``` 这里设置默认仓库主分支名称为 main,避免因为 main/master 名称不同导致的推送问题。 +> Git目前默认的主分支为 master，和 github 默认分支 main 不同，这使得默认配置下 git 往往连接失败。除了创建的时候设定外还可以通过以下方法改变默认分支。 +``` +git config --global init.defaultBranch main //将默认分支修改成main +``` **方法二** 克隆远端服务器上的仓库，例如: @@ -48,23 +50,21 @@ git clone https://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" -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 代理中。 ``` ssh-add ~/.ssh/github_key1 ssh-add ~/.ssh/github_key2 ``` -在 `~/.ssh/config` 文件中配置不同的主机别名以及相应的密钥文件。编辑该文件并添加以下内容： +- 在 `~/.ssh/config` 文件中配置不同的主机别名以及相应的密钥文件。编辑该文件并添加以下内容： ``` # GitHub repository 1 @@ -86,29 +86,24 @@ Host github2 IdentityFile ~/.ssh/github_key2 ``` -随后将cat ~/.ssh/id_rsa.pub,将其添加至 Github的Deploy密钥中，勾选write权限； +- -随后将cat ~/.ssh/id_rsa.pub,将其添加至 Github的Deploy密钥中，勾选write权限； -连接到github： +- 连接到github： ``` ssh -T git@github.com ``` -添加远程仓库： +- 添加远程仓库： ``` git remote add origin + +# 例如：git remote add origin git@github.com:Dichgrem/dichos.git ``` -比如我已经在 GitHub 上创建了一个名为 `dichos` 的仓库，你可以使用以下命令将其添加为远程仓库： -``` -git remote add origin git@github.com:Dichgrem/dichos.git -``` -设置远程仓库 +- 设置远程仓库 ``` git remote set-url origin git@github.com:Dichgrem/dichos.git ``` - -## 工作流 - -### 创建一个分支 +## 创建分支 ``` git branch main ``` @@ -124,7 +119,7 @@ git branch -D master ``` -### 添加和提交 +## 添加和提交 你可以提出更改（把它们添加到暂存区），使用如下命令： ``` @@ -142,218 +137,140 @@ git commit -m "代码提交信息" 你的改动现在已经在本地仓库的 **HEAD** 中了。执行如下命令以将这些改动提交到远端仓库： ``` -git push origin master +git push origin main ``` -可以把 *master* 换成你想要推送的任何分支。 +可以把 **main** 换成你想要推送的任何分支,如**master**或者**test** -如果你还没有克隆现有仓库，并欲将你的仓库连接到某个远程服务器，你可以使用如下命令添加： -``` -git remote add origin -``` -如此你就能够将你的改动推送到所添加的服务器上去了。 - -## 合并分支 - -分支是用来将特性开发绝缘开来的。在你创建仓库的时候，*master* 是“默认的”分支。在其他分支上进行开发，完成后再将它们合并到主分支上。 - -创建一个叫做“feature_x”的分支，并切换过去： -``` -git checkout -b feature_x -``` -切换回主分支： -``` -git checkout master -``` -再把新建的分支删掉： -``` -git branch -d feature_x -``` -除非你将分支推送到远端仓库，不然该分支就是 *不为他人所见的*： -``` -git push origin -``` -## 更新与合并 - -要更新你的本地仓库至最新改动，执行： +如果你的远程仓库是最新的，可以使用以下命令更新本地仓库： ``` git pull ``` -以在你的工作目录中 ***获取**（fetch）* 并 ***合并**（merge）* 远端的改动。 -要合并其他分支到你的当前分支（例如 master），执行： +## 合并分支 + +分支是用来将特性开发绝缘开来的。比如你在本地的test分支新增了一个功能，想要合并到主分支中。 + +创建一个叫做“test”的分支，并切换过去： +``` +git checkout -b test +``` +新增某些功能后切换回主分支： +``` +git checkout master +``` +在主分支上执行合并操作，将 test 分支的改动合并到主分支： +``` +git merge test +``` +推送完成后可以把新建的分支删掉： ``` -git merge -``` -在这两种情况下，git 都会尝试去自动合并改动。遗憾的是，这可能并非每次都成功，并可能出现_冲突（conflicts）*。 这时候就需要你修改这些文件来手动合并这些_冲突（conflicts）*。改完之后，你需要执行如下命令以将它们标记为合并成功： -``` -git add -在合并改动之前，你可以使用如下命令预览差异： -git diff +git branch -d test ``` + ## 标签 -为软件发布创建标签是推荐的。这个概念早已存在，在 SVN 中也有。你可以执行如下命令创建一个叫做 *1.0.0* 的标签： -``` -git tag 1.0.0 1b2e1d63ff -``` -*1b2e1d63ff* 是你想要标记的提交 ID 的前 10 位字符。可以使用下列命令获取提交 ID： -``` -git log -``` -你也可以使用少一点的提交 ID 前几位，只要它的指向具有唯一性。 +Git 的 tag 功能主要用于``给仓库历史中的某个特定提交打上“标签”``，通常用于标记版本发布点（例如 v1.0、v2.0 等），以``便于后续的版本定位、回溯和发布管理``。 +### 标签类型 + +Git 提供两种类型的标签： + +- 附注标签（Annotated Tag）会创建成一个完整的 Git 对象，存储打标签者的名字、邮箱、日期和标签说明，还可采用 GPG 进行签名。推荐用于正式发布，因为包含更多元数据和安全信息。 + +- 轻量标签（Lightweight Tag）实际上只是对某个提交的引用，不保存额外信息，类似一个固定的分支。适用于临时标记或非正式用途。 + +### 创建标签 + +- 创建附注标签 + +使用 -a 参数表示“annotated”，并用 -m 提供标签说明。例如，给当前提交创建一个名为 v1.0 的附注标签： +``` +git tag -a v1.0 -m "发布版本 v1.0" +``` +这会在 Git 数据库中生成一个完整的标签对象，可通过 git show v1.0 查看标签信息和对应的提交详情。 + +如果需要给旧提交贴标签，可以在命令末尾指定提交的 SHA 值（部分 SHA 也可）： +``` +git tag -a v1.0 -m "发布版本 v1.0" +``` + +- 创建轻量标签 + +直接指定标签名即可，不加任何参数： +``` +git tag v1.0-light +``` +轻量标签仅仅是一个提交引用，因此查看时不会显示附加信息。 + +### 列出标签 +- 列出所有标签 +``` +git tag +``` +- 还可以使用通配符过滤： +``` +git tag -l "v1.*" +``` +这样便于管理和筛选大量标签。 +- 查看标签详细信息 +``` +git show v1.0 +``` +这会显示标签对象的元数据以及对应的提交记录。 + +### 推送标签 +``默认情况下，git push 不会将本地标签推送到远程仓库。推送标签有两种方式：`` +- 推送单个标签 +``` +git push origin v1.0 +``` +- 一次性推送所有标签 +``` +git push origin --tags +``` +### 删除标签 +- 删除本地标签 +``` +git tag -d v1.0 +``` +- 删除远程标签 +``` +git push origin --delete v1.0 +``` ## 日志 如果你想了解本地仓库的历史记录，最简单的命令就是使用: ``` 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 -- -``` -此命令会使用 HEAD 中的最新内容替换掉你的工作目录中的文件。已添加到暂存区的改动以及新文件都不会受到影响。 - -假如你想丢弃你在本地的所有改动与提交，可以到服务器上获取最新的版本历史，并将你本地主分支指向它： -``` -git fetch origin -git reset --hard origin/master -``` -## 合并commit记录 - -``` -git rebase -i HEAD~3 -``` - -将第二行的 pick 改为 squash (s)： -``` -pick abc123 First commit message -squash def456 Second commit message -``` - - -``` -git push origin main --force -``` - -## 修改默认分支 - -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上库的默认分支。 - -## 删除前一个提交（commit）记录 - +## 删除前一个提交记录 +有时候手滑或者不想使用一个commit说明，可以用以下命令撤销上一个 commit： ``` git reset --soft HEAD~1 ``` -这个命令会 撤销上一个 commit，但保留文件修改（代码仍然在工作区）。适用于 想要重新提交（amend）或调整 commit 的情况。 +这个命令会撤销上一个 commit，但保留文件修改（代码仍然在工作区）。适用于 想要重新提交（amend）或调整 commit 的情况。 如果你想彻底删除更改（不保留代码修改），可以使用： ``` git reset --hard HEAD~1 ``` -注意：--hard 会清除未提交的更改，无法恢复。 +> 注意：--hard 会清除未提交的更改，无法恢复。 - -## 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](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的所有项目都需要启用代理，那么可以直接启用全局设置： -``` -git config --global http.proxy [http://127.0.0.1:2080](http://127.0.0.1:8088) -``` -为了确认是否已经设置成功，可以使用 `--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 -``` ## Commit规范 -1. 提交信息的基本格式 +### 提交信息的基本格式 - Header（头部） 格式： @@ -376,7 +293,7 @@ Fixes #123 ``` 这可以在提交后自动关闭相关问题。 -2. 常见的 Commit 类型 +### 常见的 Commit 类型 ``` feat：新功能的添加 示例：feat(user): 添加用户注册功能 @@ -410,4 +327,6 @@ chore：其他杂项维护，不涉及源代码或测试文件的修改 revert：回滚到上一个版本的提交 示例：revert: 撤销上次提交 -``` \ No newline at end of file +``` +--- +**Done.** \ No newline at end of file