geek/blog
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: 移除标题伪元素#前缀并修正目录层级

Browse Source 
- 删除 custom.css 中给 h1/h2/h3 强加 # 前缀的 ::before 规则
- 将 X.Y 子节标题由 ## 提升为 ###，使 TOC 正确嵌套
- 新增 tools/fix-headings.js 用于批量调整标题层级
This commit is contained in:
geek
2026-07-08 22:03:01 +08:00
parent b3f44d235a
commit e7de4af00b
3 changed files with 66 additions and 52 deletions
Download Patch File Download Diff File Expand all files Collapse all files
source/_posts/Git使用教学.md
+52 -48
View File
@@ -1,4 +1,14 @@
## 01、认识一下Git！—简介
---
title: Git使用教学
date: 2026-07-08 10:00:00
tags: [编程, 教学]
categories: 教学
cover: /img/cover.jpg
top_img: /img/top.jpg
description: 认识一下Git！
---
## 认识一下Git！—简介
Git是当前最先进、最主流的**分布式**版本控制系统，免费、开源！核心能力就是版本控制。再具体一点，就是面向代码文件的版本控制，代码的任何修改历史都会被记录管理起来，意味着可以恢复到到以前的任意时刻状态。支持跨区域多人协作编辑，是团队项目开发的必备基础，所以Git也就成了程序员的必备技能。
@@ -12,11 +22,11 @@ Git是Linux之父被迫开发的，为了解决Linux混乱的代码管理而开
---
## 02、Git是干什么的？—基础概念
## Git是干什么的？—基础概念
先了解下Git的基本概念，及基本框架、工作流程。
## 2.1、Git概念汇总🔥
### Git概念汇总🔥
| **概念名称** | **描述** |
| --- | --- |
@@ -38,7 +48,7 @@ Git是Linux之父被迫开发的，为了解决Linux混乱的代码管理而开
| **origin/master** | 表示远程仓库（`origin`）的“`master`”分支 |
| **origin/HEAD** | 表示远程仓库（`origin`）的最新提交的位置，一般情况等于“`origin/master`” |
## 2.2、工作区/暂存区/仓库
### 工作区/暂存区/仓库
![image.png](/images/091ebdafedb746d98b5340fa107c8d1b.webp)
@@ -56,13 +66,13 @@ Git是Linux之父被迫开发的，为了解决Linux混乱的代码管理而开
如上图，为对应本地仓库目录的结构关系。
## 2.3、Git基本流程（图）
### Git基本流程（图）
Git的工作流程核心就下面几个步骤，掌握了就可以开始写Bug了。
![image](/images/666f0c95490744bbafe060f5d44c22b0.webp)
## 2.4、Git状态（图）
### Git状态（图）
Git在执行提交的时候，不是直接将工作区的修改保存到仓库，而是将暂存区域的修改保存到仓库。要提交文件，首先需要把文件加入到暂存区域中。因此，Git管理的文件有三（+2）种状态：
@@ -70,7 +80,7 @@ Git在执行提交的时候，不是直接将工作区的修改保存到仓库
---
## 03、起步：Git安装配置
## 起步：Git安装配置
Git官网：[www.git-scm.com/](https://www.git-scm.com/ "https://www.git-scm.com/") 下载安装包进行安装。Git的使用有两种方式：
@@ -83,7 +93,7 @@ git version 2.33.0.windows.2
> 📢 本文是在Windows 平台上完成的，不过这个对学习Git没什么影响。
## 3.1、Git的配置文件
### Git的配置文件
Git有三个主要的配置文件：三个配置文件的优先级是**① < ② < ③**
@@ -123,7 +133,7 @@ user.name=Kanding
user.email=123anding@163.com
```
## 3.2、配置-初始化用户
### 3.2、配置-初始化用户
当安装Git后首先要做的事情是配置你的用户信息—— 告诉Git你是谁？配置 **用户名**、**邮箱地址**，每次提交文件时都会带上这个用户信息，查看历史记录时就知道是谁干的了。
@@ -139,7 +149,7 @@ $ cat 'C:\Users\Kwongad\.gitconfig'
email = 123anding@163.com
```
## 3.3、配置-忽略.gitignore
### 配置-忽略.gitignore
工作目录中的文件并不是全都需要纳入版本管理，如日志、临时文件、私有配置文件等不需要也不能纳入版本管理，那该怎么办呢？
@@ -160,13 +170,13 @@ doc/*.txt #会忽略 doc/notes.txt 但不包括 doc/server/arch.txt
---
## 04、Git的GUI工具们
## Git的GUI工具们
如果不想用命令行工具，完全可以安装一个Git的GUI工具，用的更简单、更舒服。不用记那么多命令了，极易上手，不过Git基础还是需要学习了解一下的。
> ❓对于Git，建议用命令行，这样你才能真的理解Git的思想？ ✔️其实都只是工具而已，适合自己的就是最好的，没必要纠结，多写点Bug更重要！
## 4.1、SourceTree
### SourceTree
SourceTree的[官网](https://www.sourcetreeapp.com/ "https://www.sourcetreeapp.com/") 下载安装包，支持Window、Mac系统，按照提示完成安装。
@@ -174,7 +184,7 @@ SourceTree的[官网](https://www.sourcetreeapp.com/ "https://www.sourcetreeapp.
![image](/images/1384a781a80042faaf754c0de52b8d6d.webp)
## 4.2、TortoiseGit
### TortoiseGit
![image.png](/images/8165d603319245278464511ad2cc71cb.webp)
@@ -186,7 +196,7 @@ SourceTree的[官网](https://www.sourcetreeapp.com/ "https://www.sourcetreeapp.
![image.png](/images/7494f0ff8dae4e1c8029fc1640938229.webp)
## 4.3、VSCode中的Git
### VSCode中的Git
VSCode自带的Git工具基本已经可以满足日常使用了，既有可视化功能，也能敲命令，习惯了不就不用安装其他GUI工具了。不过还是可以再安装一些VSCode插件，来增强Git功能。
@@ -194,9 +204,9 @@ VSCode自带的Git工具基本已经可以满足日常使用了，既有可视
---
## 05、Git使用入门
## Git使用入门
## 5.1、创建仓库
### 创建仓库
创建本地仓库的方法有两种：
@@ -238,7 +248,7 @@ Resolving deltas: 100% (48/48), done.
![image.png](/images/377739fca6a740819ce778c705e9cd22.webp)
## 5.2、暂存区add
### 暂存区add
可以简单理解为，`git add`命令就是把要提交的所有修改放到暂存区（Stage），然后，执行`git commit`就可以一次性把暂存区的所有修改提交到仓库。
@@ -271,7 +281,7 @@ $ git mv [file-original] [file-renamed]
![image.png](/images/7c5ebb71c0bb4bec9a5fa9284c70e8f7.webp)
## 5.3、提交commit-记录
### 提交commit-记录
`git commit`提交是以时间顺序排列被保存到数据库中的，就如游戏关卡一样，每一次提交（commit）就会产生一条记录：`id + 描述 + 快照内容`。
@@ -333,7 +343,7 @@ $ git log -n2 --oneline
228362e Merge branch 'main' of github.com:kwonganding/KWebNote
```
## 5.4、Git的“指针”引用们
### Git的“指针”引用们
Git中最重要的就是提交记录了，其他如**标签**、**分支**、**HEAD** 都对提交记录的“指针”引用，指向这些提交记录，理解这一点很重要。
@@ -368,7 +378,7 @@ ref: refs/heads/dev
> **📢“指针”引用**：之所以用引号的“指针”，是为了便于统一和理解。和指针原理类似，都是一个指向，只是实际上可能更复杂一点，且不同的“指针”引用会有区别。
## 5.5、提交的唯一标识id，HEAD~n是什么意思？
### 提交的唯一标识id，HEAD~n是什么意思？
每一个提交都有一个唯一标识，主要就是提交的`hash`值`commit id`，在很多指令中会用到，如版本回退、拣选提交等，需要指定一个提交。那标识唯一提交有两种方式：
@@ -388,7 +398,7 @@ d3e15f9 HEAD@{6}: reset: moving to d3e15f9
d3e15f9 HEAD@{9}: reset: moving to HEAD~
```
## 5.6、比较diff
### 比较diff
`git diff`用来比较不同文件版本之间的差异。
@@ -421,7 +431,7 @@ $ git diff --shortstat "@{0 day ago}"
---
## 06、远程仓库
## 远程仓库
Git作为分布式的版本管理系统，每个终端都有自己的Git仓库。但团队协作还需一个中间仓库，作为中心，同步各个仓库。于是服务端（远程）仓库就来承担这个职责，服务端不仅有仓库，还配套相关管理功能。
@@ -429,7 +439,7 @@ Git作为分布式的版本管理系统，每个终端都有自己的Git仓库
可以用公共的Git服务器，也可以自己搭建一套Git服务器。
## 6.1、远程用户登录
### 远程用户登录
Git服务器一般提供两种登录验证方式：
@@ -504,7 +514,7 @@ $ ssh -T git@github.com
Hi kwonganding! You've successfully authenticated, but GitHub does not provide shell access.
```
## 6.2、远程仓库指令🔥
### 远程仓库指令🔥
| **指令** | **描述** |
| --- | --- |
@@ -524,7 +534,7 @@ Hi kwonganding! You've successfully authenticated, but GitHub does not provide s
| git remote rm \[remote-name\] | 删除远程仓库 |
| git pull --rebase | 使用rebase的模式进行合并 |
## 6.3、推送push/拉取pull
### 推送push/拉取pull
`git push`、`git pull`是团队协作中最常用的指令，用于同步本地、服务端的更新，与他人协作。
@@ -534,7 +544,7 @@ Hi kwonganding! You've successfully authenticated, but GitHub does not provide s
![image](/images/365395e73a254ef6abfd5a99e78992b0.webp)
## 6.4、fetch与pull有什么不同？
### fetch与pull有什么不同？
两者都是从服务端获取更新，主要区别是`fetch`不会自动合并，不会影响当前工作区内容。
@@ -563,13 +573,13 @@ Fast-forward
---
## 07、Git利器-分支
## Git利器-分支
分支是从主线分离出去的“副本”，分支就像是平行宇宙，可独立发展，独立编辑、提交，也可以和其他分支合并。分支是Git的核心必杀利器之一，分支创建、切换、删除都非常快，他非常的轻量。所以，早建分支！多用分支！
![image.png](/images/4b9ab3c40bcf47858c8ee108ab35ff91.webp)
## 7.1、分支Branch
### 分支Branch
比如有一个项目团队，准备10月份发布新版本，要新开发一堆黑科技功能，占领市场。你和小伙伴“小美”一起负责开发一个新功能A，开发周期2周，在这两周你们的代码不能影响其他人，不影响主分支。这个时候就可以为这个新功能创建一个分支，你们两在这个分支上干活，2周后代码开发完了、测试通过，就可以合并进要发版的开发分支了。安全、高效，不影响其他人工作，完美！
@@ -585,7 +595,7 @@ $ cat .git/refs/heads/dev
ca88989e7c286fb4ba56785c2cd8727ea1a07b97
```
## 7.2、分支指令🔥
### 分支指令🔥
| **指令** | **描述** |
| --- | --- |
@@ -621,7 +631,7 @@ $ git branch
# 列出了当前的所有分支，星号“*”开头的“main”为当前活动分支。
```
## 7.3、分支的切换checkout
### 分支的切换checkout
代码仓库可以有多个分支，`master`为默认的主分支，但只有一个分支在工作状态。所以要操作不同分支，需要切换到该分支，`HEAD`就是指向当前正在活动的分支。
@@ -642,7 +652,7 @@ ref: refs/heads/dev
**❓切换时还没提交的代码怎么办？**
## 7.4、合并merge&冲突
### 合并merge&冲突
把两个分支的修改内容合并到一起，常用的合并指令`git merge [branch]`，将分支`[branch]`合并到当前分支。根据要合并的内容的不同，具体合并过程就会有多种情况。
@@ -670,7 +680,7 @@ ref: refs/heads/dev
![image.png](/images/790e17969958424c992eaf7a204641eb.webp)
## 7.5、变基rebase
### 变基rebase
把两个分支的修改内容合并到一起的办法有两种：`merge` 和 `rebase`，作用都是一样的，区别是`rebase`的提交历史更简洁，干掉了分叉，merge的提交历史更完整。
@@ -684,7 +694,7 @@ $ git merge dev
---
## 08、标签管理
## 标签管理
**标签**（Tags）指的是某个分支某个特定时间点的状态，是对某一个提交记录的的**固定**“指针”引用。一经创建，不可移动，存储在工作区根目录下`.git\refs\tags`。可以理解为某一次提交（编号）的别名，常用来标记版本。所以发布时，一般都会打一个版本标签，作为该版本的快照，指向对应提交`commit`。
@@ -724,13 +734,13 @@ v1
---
## 09、后悔药-怎么撤销变更？
## 后悔药-怎么撤销变更？
发现写错了要回退怎么办？看看下面几种后悔指令吧！
![image](/images/79de5cfe72814bca8d97411d49e59977.webp)
## 9.1、后悔指令🔥
### 后悔指令🔥
| **指令** | **描述** |
| --- | --- |
@@ -759,7 +769,7 @@ $ git checkout HEAD .
Updated 1 path from f951a96
```
## 9.2、回退版本reset
### 回退版本reset
`reset`是专门用来撤销修改、回退版本的指令，支持的场景比较多，多种撤销姿势，所以参数组合也比较多。简单理解就是移动`master`分支、`HEAD`的“指针”地址，理解这一点就基本掌握`reset`了。
@@ -804,7 +814,7 @@ ccb9937 (HEAD -> main, origin/main, origin/HEAD) HEAD@{0}: commit: 报表新增
4b1028c HEAD@{3}: commit: 财务报表模块开发完成
```
## 9.3、撤销提交revert
### 撤销提交revert
安全的撤销某一个提交记录，基本原理就是生产一个新的提交，用原提交的逆向操作来完成撤销操作。注意，这不同于`reset`，`reset`是回退版本，revert只是用于撤销某一次历史提交，操作是比较安全的。
@@ -819,7 +829,7 @@ $ git revert 41ea42 -m'撤销对***的修改'
1 file changed, 1 deletion(-)
```
## 9.4、checkout/reset/revert总结
### checkout/reset/revert总结
| **标题 \\ 指令** | **checkout** | **reset** | **revert** |
| --- | --- | --- | --- |
@@ -833,9 +843,9 @@ $ git revert 41ea42 -m'撤销对***的修改'
---
## 10、工作中的Git实践
## 工作中的Git实践
## 10.1、Git flow
### Git flow
Git flow（Git工作流程）是指软件项目中的一种Git分支管理模型，经过了大量的实践和优化，被认为是现代敏捷软件开发和DevOps（开发、技术运营和质量保障三者的交集）的最佳实践。Git flow主要流程及关键分支：[原图地址-processon](https://www.processon.com/view/59ec836de4b0c86d400e99f1?fromnew=1 "https://www.processon.com/view/59ec836de4b0c86d400e99f1?fromnew=1")
@@ -855,7 +865,7 @@ Git flow（Git工作流程）是指软件项目中的一种Git分支管理模型
**✅其他开发分支：dev-xxx**，开发人员可以针对模块自己创建本地分支，开发完成后合并到dev开发分支，然后删除本地分支。
## 10.2、金屋藏娇stash
### 10.2、金屋藏娇stash
当你正在`dev`分支开发一个功能时，代码写了一半，突然有一个线上的bug急需要马上修改。`dev`分支Bug没写完，不方便提交，就不能切换到主分支去修复线上bug。Git提供一个`stash`功能，可以把当前**工作区、暂存区** 未提交的内容“隐藏”起来，就像什么都没发生一样。
@@ -897,7 +907,7 @@ $ git stash pop
> 🪧当然这里先提交到本地也是可以的，只是提交不是一个完整的功能代码，而是残缺的一部分，影响也不大。
## 拣选提交cherry-pick
### 拣选提交cherry-pick
当有一个紧急bug，在`dev`上修复完，我们需要把`dev`上的这个bug修复所做的修改“复制”到`master`分支，但不想把整个dev合并过去。为了方便操作，Git专门提供了一个`cherry-pick`命令，让我们能复制一个特定的提交到当前分支，而不管这个提交在哪个分支。
@@ -911,9 +921,3 @@ $ git cherry-pick [commit]
```
---
## 参考资料
---
> **©️版权申明**：版权所有@安木夕，本文内容仅供学习，欢迎指正、交流，转载请注明出处！[*原文编辑地址-语雀*](https://www.yuque.com/kanding/ktech/ccgylqhnb94ug4bu "https://www.yuque.com/kanding/ktech/ccgylqhnb94ug4bu")