1966 字

10 分钟

git备忘

2025-10-16

git

git配置#

基础信息#

1
git config --global user.email "you@example.com"
2
git config --global user.name "Your Name"

HTTP代理#

1
#端口不定看你设置
2
git config --global http.proxy "http://127.0.0.1:<7890>"
3
git config --global https.proxy "http://127.0.0.1:<7890>"
4

5
git config --global http.proxy "socks5://127.0.0.1:<1080>"
6
git config --global https.proxy "socks5://127.0.0.1:<1080>"
7
#取消设置
8
git config --global --unset http.proxy
9
git config --global --unset https.proxy

SSH#

ssh来鉴权最好，比http协议安全的多密钥也方便管理

1
Host github.com
2
    HostName ssh.github.com
3
    Port 443
4
    User git

git使用#

git工作流程

1
工作区 (修改文件)
2
    → git add →
3
暂存区 (准备提交)
4
    → git commit →
5
版本库 (永久保存)

基本命令#

1
#git初始化，在当前文件中添加一个.git目录，里面存着所有与git有关的东西
2
#如果fork过来的项目不让你设置成私有仓库可以考虑把这个目录删了然后再重新git init
3
git init
4

5
#查看git的状态
6
git status
7

8
#添加某个或者某个路径下的所有文件到暂存区
9
git add <path>
10
#交互式添加到暂存区
11
git add -p
12
#删除.env的git监控，但不删除本地文件
13
git rm --cached .env
14

15
#提交至版本库
16
git commit [-m] ["description"]
17

18
#回退版本默认是mixed模式，工作区保留，暂存区不保留
19
git reset HEAD^
20
# 从暂存区移除filename.txt,工作区保留
21
git reset filename.txt
22

23
#查看暂存区和工作区的不同
24
git diff
25
#比较工作区和版本库的区别
26
git diff HEAD^
27
#比较暂存区和版本库的区别
28
git diff --cached
29
#比较两个版本之间的区别
30
git diff <版本1的id> <版本2的id>
31
#可以比较文件的变化
32
git diff <文件名>
33
# 查看提交历史
34
git log
35
# 查看简洁版的提交历史
36
git log --oneline
37

38
#查看当前版本库中的所有文件
39
git ls-files
40

41
#删除path对应的文件从工作区，并把这个改动添加至暂存区
42
git rm <path>
43

44
#用http的方式的话要输用户名密码，但密码是GitHub的Personal access tokens
45
git push [origin] [分支名]
46

47
git pull

git分支控制#

创建分支#

1
# 创建分支
2
git branch feature/new-feature
3

4
# 切换到新分支
5
git checkout feature/new-feature
6

7
# 或者使用 switch
8
git switch feature/new-feature

查看分支#

1
# 查看本地分支（当前分支前会有 * 标记）
2
git branch
3

4
# 查看所有分支（包括远程）
5
git branch -a
6

7
# 查看分支及其最近提交
8
git branch -v

合并分支#

方式一：快速合并（Fast-forward Merge）#

适用于要合并的分支是当前分支的直接下游：

1
# 1. 切换到要合并的目标分支（通常是主分支）
2
git checkout main
3

4
# 2. 确保工作目录是干净的
5
git status
6

7
# 3. 合并分支
8
git merge feature/new-feature
9

10
# 4. 删除已合并的分支（可选）
11
git branch -d feature/new-feature

方式二：普通合并（创建合并提交）#

1
# 禁用快速合并，总是创建合并提交
2
git merge --no-ff feature/new-feature

方式三：压缩合并（Squash Merge）#

1
# 将分支的所有提交压缩成一个提交再合并
2
git merge --squash feature/new-feature
3
git commit -m "合并 feature/new-feature 的功能"

解决合并冲突#

当合并时出现冲突：

1
# 1. 查看冲突文件
2
git status
3

4
# 2. 打开冲突文件，手动解决冲突
5
# 冲突标记示例：
6
<<<<<<< HEAD
7
当前分支的内容
8
=======
9
要合并的分支的内容
10
>>>>>>> feature/new-feature
11

12
# 3. 标记冲突已解决
13
git add 文件名
14

15
# 4. 完成合并
16
git commit

完整的工作流程：#

1
# 1. 基于主分支创建功能分支
2
git checkout main
3
git pull origin main
4
git checkout -b feature/user-authentication
5

6
# 2. 在新分支上开发
7
git add .
8
git commit -m "添加用户登录功能"
9

10
# 3. 切换回主分支并拉取最新代码
11
git checkout main
12
git pull origin main
13

14
# 4. 合并功能分支
15
git merge feature/user-authentication
16

17
# 5. 推送合并后的代码
18
git push origin main
19

20
# 6. 删除本地功能分支
21
git branch -d feature/user-authentication
22

23
# 7. 删除远程功能分支（如果存在）
24
git push origin --delete feature/user-authentication

.gitignore#

直接就把路径一行行写进去就行#是注释比如:

1
# build output
2
dist/
3

4
# generated types
5
.astro/
6

7
# dependencies
8
node_modules/

git的其他小知识#

问AI的

HEAD#

基本概念#

HEAD#

当前所在的分支的最新提交
是一个指针，指向你当前的工作位置
可以理解为”你正在哪里工作”

1
# 查看HEAD指向的提交
2
git show HEAD
3
cat .git/HEAD

区别对比#

HEAD^ (插入符)#

指向父提交
主要用于合并提交的场景

1
HEAD^    # 第一个父提交
2
HEAD^2   # 第二个父提交（合并提交时）

HEAD~ (波浪符)#

向上回溯指定代数的提交
主要用于线性历史

1
HEAD~    # 向上回溯1代（等同于HEAD^）
2
HEAD~2   # 向上回溯2代
3
HEAD~3   # 向上回溯3代

实际示例#

假设提交历史如下：

1
A - B - C - D (HEAD)

1
HEAD    # 指向提交 D
2
HEAD^   # 指向提交 C (D的父提交)
3
HEAD~   # 指向提交 C (等同于HEAD^)
4
HEAD~2  # 指向提交 B
5
HEAD~3  # 指向提交 A

合并提交的特殊情况#

对于合并提交：

1
    B - C (feature)
2
   /      \
3
A - D - E - M (HEAD, 合并提交)

1
HEAD    # 指向合并提交 M
2
HEAD^   # 指向 E (第一个父提交)
3
HEAD^2  # 指向 C (第二个父提交)
4
HEAD~   # 指向 E (等同于HEAD^)
5
HEAD~2  # 指向 D

常用命令示例#

1
# 查看上一个提交
2
git show HEAD^
3
git show HEAD~
4

5
# 查看上上个提交
6
git show HEAD^^
7
git show HEAD~2
8

9
# 重置到上一个提交（保留工作区）
10
git reset HEAD^
11

12
# 重置到上上个提交（保留工作区）
13
git reset HEAD~2
14

15
# 比较当前与上一个提交的差异
16
git diff HEAD^ HEAD

记忆技巧#

^ - 像分支一样”分叉”，用于处理多个父提交
~ - 像直线一样”回溯”，用于线性历史
数字 - ^后面的数字表示第几个父提交，~后面的数字表示回溯几代

等价关系#

1
HEAD     = HEAD~0
2
HEAD^    = HEAD~1
3
HEAD^^   = HEAD~2
4
HEAD^^^  = HEAD~3
5
HEAD^2   # 没有等价的~表示法（特殊场景）

教学视频#

git remote#

远程仓库位置#

在仓库的code那里点进去可以取到http、ssh的仓库位置，示例： HTTP：https://github.com/saicaca/fuwari.git SSH：git@github.com:saicaca/fuwari.git

SSH鉴权#

就和你连接别的服务器的ssh一样，在github用户设置那里放个公钥，需要权限的电脑的~/.ssh/config里配置一下github的连接用对应的私钥就可以了生成密钥对的方法可以看ssh的文章，那里config也有例子

1
Host github.com
2
    HostName github.com
3
    User git
4
    IdentityFile ~/.ssh/github_id_ed25519

建立与远程仓库的连接#

git remote -v: 列出所有连接的远程仓库及 URL（最常用）。
git remote add <名字> <地址>: 添加一个新的连接（如 git remote add upstream ...）。
git remote remove <名字>: 删除连接。
git remote rename <旧名> <新名>: 改个名字。
git remote set-url <名字> <新地址>: 修改仓库地址（比如从 HTTPS 改成 SSH）。

拉取和推送代码#

git fetch <远程名>: 最安全的同步方式。它把远程仓库的最新内容下载到你本地的 .git 隐藏文件夹里，但不会动你的代码文件。
git push <远程名> <分支名>: 把你本地的 commit 传给远程仓库，并更新该分支。
git pull <远程名> <分支名>: 等于 git fetch + git merge。它直接下载并把改动“合并”进你当前打开的分支。拉取完了就可以合并了

git提交记录#

前缀	全称	使用场景
`feat`	Feature	新功能
`fix`	Fix	修 Bug
`docs`	Documentation	文档更新
`style`	Style	格式调整。不影响代码逻辑的改动
`refactor`	Refactor	重构
`perf`	Performance	性能优化
`chore`	Chore	杂事。改 `.gitignore`、配置 Docker、改依赖包版本。
可以在前缀的后面加个()，里面写更改的模块名，可以在github上观察一下大型开源项目的提交记录如何编写的，不过也说不准，其实最终还是全看你自己