1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# Debian / Ubuntu
sudo apt update && sudo apt install -y git

# RHEL 8+ / CentOS Stream / Rocky / AlmaLinux / Fedora
sudo dnf install -y git

# 老旧的 RHEL 7 / CentOS 7（已停止维护，只作了解）
sudo yum install -y git

# macOS：Homebrew 版本通常比系统自带的新
brew install git
# 或者安装 Xcode 命令行工具（自带 git，版本偏老）
xcode-select --install

# Windows：官网安装包最省事
# https://git-scm.com/download/win

1
2

git --version
# git version 2.43.0   （具体版本号取决于发行版，能跑就行）

1
2
3
4
5
6
7
8
9

git config --global user.name "你的名字"
git config --global user.email "your.email@example.com"

# 查看当前生效的值
git config user.name
git config user.email

# 查看所有配置及来源
git config --list --show-origin

1
2

cd ~/work/company-project
git config --local user.email "you@company.com"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

# 新仓库的默认分支名（Git 2.28+ 才支持，不设的话可能是 master）
git config --global init.defaultBranch main

# 中文文件名不再被显示成 "\344\275\240" 这种八进制转义
git config --global core.quotepath false

# 换行符处理：防止 Windows 同事提交的 CRLF 把整个文件标成"全改了"
#   Linux/macOS 用 input，Windows 用 true
git config --global core.autocrlf input

# 让 git pull 更规范：只做快进合并，必要时明确报错
git config --global pull.rebase false      # 或者 true，看团队约定

# 记住 HTTPS 密码（Linux 上需要 libsecret；macOS 自带钥匙串）
git config --global credential.helper store   # 明文保存，谨慎使用
# macOS 推荐：git config --global credential.helper osxkeychain

# 彩色输出
git config --global color.ui auto

# 常用别名
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.lg "log --oneline --graph --decorate --all"

# 设置默认编辑器
git config --global core.editor vim

# 让 git 记住你解决过的冲突方式
git config --global rerere.enabled true

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 写入文件
cat > ~/.gitmessage.txt << 'EOF'
# ---- 第一行：<类型>(<范围>): <简短描述>，不超过 50 字符 ----
#
# 详细说明（可选，每行不超过 72 字符）：为什么改，而不是改了什么
#
# 关联 issue: Closes #123
#
# ---- 类型 ----
# feat:     新功能
# fix:      修复缺陷
# docs:     文档
# style:    格式（不影响代码运行）
# refactor: 重构（既非新功能也非修复）
# perf:     性能优化
# test:     测试
# build:    构建系统或依赖
# ci:       CI 配置
# chore:    杂项
# ---- 以 # 开头的行不会进入提交信息 ----
EOF

git config --global commit.template ~/.gitmessage.txt

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 方式一：先把已有目录变成仓库
cd my-project
git init
# Initialized empty Git repository in /path/to/my-project/.git/

# 方式二：新建目录并初始化
git init my-new-project
cd my-new-project

# 方式三：从远程克隆（最常用）
git clone https://github.com/user/repo.git
git clone https://github.com/user/repo.git my-folder   # 指定本地目录名
git clone -b develop --single-branch https://github.com/user/repo.git   # 只要一个分支
git clone --depth 1 https://github.com/user/repo.git   # 浅克隆，只要最新一次提交

1
2
3
4
5
6
7
8
9

ls -a .git/
# HEAD          当前指向哪个分支（如 ref: refs/heads/main）
# config        本仓库的配置（就是 git config --local 改的那个文件）
# index         暂存区的实际存储
# objects/      所有数据对象（提交、目录树、文件内容），Git 的核心
# refs/         分支、标签的引用（refs/heads/、refs/tags/）
# logs/         引用变更日志，git reflog 的数据来源
# hooks/        钩子脚本示例（默认都是 .sample，不生效）
# info/exclude  本仓库的忽略规则（.gitignore 的补充）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 1. 先看有没有现成的密钥
ls -l ~/.ssh/id_*

# 2. 没有就生成一对（ed25519 比 RSA 更短更安全）
ssh-keygen -t ed25519 -C "your.email@example.com"
# 提示保存位置时直接回车；提示设置口令(passphrase)时。
#   留空 = 使用方便但安全性低；设置口令 = 更安全，配合 ssh-agent 也不麻烦

# 3. 查看公钥内容（.pub 是公钥，可以随便给；没有 .pub 的是私钥，绝不能外传）
cat ~/.ssh/id_ed25519.pub

# 4. 复制公钥内容，粘贴到：
#    GitHub → Settings → SSH and GPG keys → New SSH key
#    GitLab → Preferences → SSH Keys

# 5. 测试连接
ssh -T git@github.com
# 成功会看到：Hi 用户名! You've successfully authenticated, but GitHub does not provide shell access.

# 6. 把已有的 HTTPS 仓库换成 SSH
git remote -v
git remote set-url origin git@github.com:user/repo.git

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

git status

# On branch main
# Your branch is up to date with 'origin/main'.
#
# Changes to be committed:            ← 已暂存，将被提交
#   (use "git restore --staged <file>..." to unstage)
#         modified:   readme.md
#         new file:   newfile.txt
#
# Changes not staged for commit:      ← 已修改但没暂存
#   (use "git add <file>..." to update what will be committed)
#   (use "git restore <file>..." to discard changes in working directory)
#         modified:   app.py
#
# Untracked files:                    ← Git 还不认识的文件
#   (use "git add <file>..." to include in what will be committed)
#         notes.txt

1
2

X = 暂存区相对上次提交的状态
Y = 工作区相对暂存区的状态

1
2
3
4
5
6
7
8
9

git status -s

#  M app.py            ← 注意：M 前面有一个空格
# M  readme.md
# A  newfile.txt
# D  deleted.txt
# R  old.txt -> new.txt
# ?? untracked.txt
# !! ignored.log       ← 需要加 --ignored 才会显示

1
2
3
4
5

# 想只提交已暂存的内容，先看清哪些是第一列有字
git status -s

# 只显示已暂存的改动（相当于旧版 git diff --cached）
git diff --staged --name-only

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 1. .gitignore 只管"未被跟踪"的文件。
#    已经提交过的文件，后加 .gitignore 也不生效，必须先取消跟踪：
git rm --cached config.local.yml     # 保留本地文件，只从版本库移除
git commit -m "chore: 停止跟踪本地配置"

# 2. 想排查"为什么这个文件被忽略了"，用 check-ignore 问 Git 本人
git check-ignore -v logs/app.log
# .gitignore:12:*.log    logs/app.log

# 3. 设置全局忽略文件（比如所有项目都忽略 .DS_Store）
git config --global core.excludesfile ~/.gitignore_global

# 4. 模板仓库：用 GitHub 的 gitignore 模板挑一份现成的
#    https://github.com/github/gitignore

1
2
3
4
5
6
7
8
9

git add readme.txt                # 单个文件
git add readme.txt app.py         # 多个文件
git add src/                      # 整个目录
git add '*.py'                    # 只添加匹配的（引号防止 Shell 先展开）
git add .                         # 当前目录下的所有变化（含新增、修改、删除）
git add -A                        # 整个仓库的所有变化（在仓库根目录执行时和上面等价）
git add -u                        # 只处理【已跟踪】文件的修改和删除，不含新增文件
git add -f ignored-file.txt       # 强制添加被 .gitignore 忽略的文件
git add -n .                      # 演练：只显示会被添加什么，不真的添加

1
2

git add -A                # 会把所有未跟踪文件加进来，包括你不想要的
git add -n -A | head      # 先看一眼再说！

1
2
3
4
5
6
7

git add -p app.py
# 交互选项：
#   y  暂存这一块
#   n  跳过这一块
#   s  把这块拆得更细
#   e  手工编辑要暂存的内容
#   q  退出

1
2
3
4
5
6
7
8

git commit                        # 打开编辑器写提交信息
git commit -m "fix: 修复登录失败的问题"
git commit -am "fix: 快速提交"    # 只对【已跟踪】文件生效：自动 add + commit
git commit -v                     # 在编辑器里同时显示 diff，方便对照着写
git commit --amend                # 修改【上一次】提交（信息或内容）
git commit --amend --no-edit      # 只补内容，不改提交信息
git commit --allow-empty -m "ci: 触发流水线"   # 空提交
git commit -S -m "..."            # GPG 签名提交

1
2
3
4

# -a 只把【已跟踪文件】的改动加进来，新建的文件仍然需要 git add
touch brand-new.js
git commit -am "feat: 加个文件"    # brand-new.js 不会被提交！
git status                        # 你会看到它还是 Untracked

1
2
3
4
5
6
7

# 场景：提交信息写错、或者忘了加一个文件
git add forgotten.js
git commit --amend --no-edit      # 把这个文件并进上一次提交

# ⚠️ amend 会生成一个新的提交（新的哈希），
#    如果那次提交已经 push 到共享分支，别人拉下来的历史会和你的对不上。
#    只对"还没推送的提交"用 amend。

1
2
3
4
5
6
7
8
9

# 第一行（主题行）：<类型>(<范围>): <做了什么>，50 字符以内，不要句号
fix(auth): 修复 token 过期后无法自动刷新

# 空一行，然后写"为什么"，而不是"改了什么"（改了什么看 diff 就知道了）
# 原来的判断只看 exp 字段，忽略了服务器时钟偏慢的情况，
# 导致用户偶发地被要求重新登录。改成预留 30 秒的宽限时间。

# 最后关联 issue
Closes #142

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 删除文件：从工作区和暂存区一起删，并记入版本库
git rm old.txt

# 只从版本库移除，保留本地文件（.gitignore 之后的标配动作）
git rm --cached config.local.yml

# 删除整个目录（-r）
git rm -r old-dir/

# 重命名：等价于 mv + git rm + git add
git mv old-name.txt new-name.txt

# 如果已经用普通 mv 改过名了，也可以补一次 add
mv a.txt b.txt
git add -A

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 1. 撤销【工作区】的修改（回到暂存区里的版本）—— 未提交的改动会永久丢失！
git restore app.py
git restore .                       # 撤销当前目录所有工作区改动

# 2. 撤销【暂存】（把文件从暂存区拿出来，工作区不动）
git restore --staged app.py
git restore --staged .              # 全部取消暂存

# 3. 同时撤销暂存和工作区（恢复到上次提交的样子）
git restore --source=HEAD --staged --worktree app.py

# 4. 老写法（旧教程里到处都是，现在仍能用）
git checkout -- app.py              # 等价于 git restore app.py
git reset HEAD app.py               # 等价于 git restore --staged app.py

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

git log                              # 完整历史（在 pager 里，按 q 退出）
git log --oneline                    # 一行一条，最常用
git log -n 5                         # 只看最近 5 条
git log --oneline -5 --no-merges      # 最近 5 条，跳过合并提交

# 看图形化分支结构（建议存成别名 lg）
git log --oneline --graph --decorate --all

git log --stat                       # 每次提交动了哪些文件、增删多少行
git log -p                           # 每次提交的完整 diff
git log --name-status                # 只列文件名和状态（A/M/D）

1
2
3
4
5
6
7
8
9

git log --author="John"                          # 按作者
git log --grep="fix"                             # 按提交信息（正则）
git log --grep="fix" --grep="bug" --all-match    # 同时满足多个关键词
git log --since="2 weeks ago" --until="yesterday"
git log -- path/to/file.txt                      # 只看某个文件的历史
git log --follow -- old-name.txt                 # 跨重命名追踪（能看到改名前的历史）
git log -S "some_function"                       # 搜索"增删过这段代码"的提交（pickaxe）
git log -G "regex"                               # 同上，但按正则匹配改动内容
git log --merges                                 # 只看合并提交

1
2
3

git shortlog                 # 按作者分组，列出各自的提交主题
git shortlog -sn             # 只显示每个作者的提交数（-s 汇总，-n 按数量排序）
git shortlog -sn --no-merges # 排除合并提交，数字更真实

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

git log --pretty=format:"%h %an %s"

# 常用占位符：
# %H 完整哈希    %h 短哈希
# %an 作者名     %ae 作者邮箱
# %ad 作者日期   %ar 相对时间（"3 days ago"）
# %s 主题行      %b 正文
# %d 引用（分支、标签）

# 一份好用的"一屏看全"格式
git log --graph --pretty=format:'%C(yellow)%h%Creset %C(cyan)%ad%Creset %C(bold)%s%Creset %C(green)(%an)%Creset' --date=short

1
2
3
4
5

git show                       # 显示最新提交的详情 + diff
git show abc1234               # 指定的提交
git show abc1234:src/app.js    # 某个提交时，某个文件的内容
git show v1.0.0                # 标签（下一章会讲）
git show --stat HEAD           # 只看这次提交动了哪些文件

1
2
3
4

git blame app.py                          # 每行前面标出提交、作者、时间
git blame -L 20,40 app.py                 # 只看第 20-40 行
git blame -w app.py                       # 忽略纯空白改动
git log -L 20,40:app.py                   # 查看这段代码的演变历史

1
2
3
4
5
6
7
8
9

git diff                            # 提交前看一眼，好习惯
git diff --stat                     # 只看统计
git diff --shortstat                # 一行统计：X files changed, Y insertions(+), Z deletions(-)
git diff -- app.py                  # 只看某个文件（-- 用来把文件名和选项分开）
git diff -w                         # 忽略空白差异
git diff --word-diff                # 按词而不是按行展示（改文档时很好用）
git diff -U5                        # 上下文显示 5 行（默认 3 行）
git diff -W                         # 上下文扩到"整个函数"（--function-context）
git diff --color-words              # 彩色按词高亮

1
2
3

git difftool                        # 用配置好的图形工具逐文件查看
git config --global diff.tool vimdiff
git config --global difftool.prompt false