Git 完全入门指南 2026：从零开始掌握版本控制 / GitHub 协作 / 分支管理

1
# 场景1：个人项目管理
2
git init                    # 初始化仓库
3
git add .                   # 追踪所有文件
4
git commit -m "first commit" # 提交快照
5
# 即使误删文件，也能用 git checkout -- file 恢复
6

7
# 场景2：团队协作开发
8
git clone git@github.com:team/project.git  # 克隆项目
9
git checkout -b feature/login              # 创建功能分支
10
# ... 开发新功能 ...
11
git push origin feature/login              # 推送分支
12
# 在 GitHub 上创建 Pull Request 进行代码评审
13

14
# 场景3：开源项目贡献
15
git clone git@github.com:popular/oss.git   # 克隆开源项目
16
git checkout -b fix-bug                    # 创建修复分支
17
# ... 修复 Bug ...
18
git push origin fix-bug                    # 推送
19
# 创建 Pull Request 贡献代码

1
# macOS（推荐 Homebrew）
2
brew install git
3

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

7
# CentOS / RHEL
8
sudo yum install git -y
9

10
# Windows
11
# 下载安装包：https://git-scm.com/download/win
12
# 安装时选择 "Git Bash Here" 添加到右键菜单
13

14
# 验证安装
15
git --version
16
# git version 2.47.0

1
# 设置用户名和邮箱（会出现在每次提交记录中）
2
git config --global user.name "你的名字"
3
git config --global user.email "your_email@example.com"
4

5
# 设置默认分支名为 main（代替 master）
6
git config --global init.defaultBranch main
7

8
# 设置默认编辑器（可选）
9
git config --global core.editor "code --wait"  # VS Code
10
# 或
11
git config --global core.editor "vim"
12

13
# 查看所有配置
14
git config --global --list
15

16
# 配置文件位置
17
# macOS/Linux: ~/.gitconfig
18
# Windows: C:\Users\用户名\.gitconfig

1
# 自动转换换行符（Windows 用户必配）
2
git config --global core.autocrlf true
3

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

7
# 设置常用别名（提高效率）
8
git config --global alias.st status
9
git config --global alias.co checkout
10
git config --global alias.br branch
11
git config --global alias.ci commit
12
git config --global alias.lg "log --oneline --graph --all"
13

14
# 使用别名后：
15
# git st  等同于  git status
16
# git lg  等同于  git log --oneline --graph --all

1
# 每次提交生成一个唯一的 SHA-1 哈希值
2
git log --oneline -5
3
# a1b2c3d (HEAD -> main) 添加用户登录功能
4
# e4f5g6h 修复首页样式问题
5
# i7j8k9l 初始化项目
6

7
# 哈希值可用于：
8
# - 回退版本：git reset --hard a1b2c3d
9
# - 查看差异：git diff e4f5g6h a1b2c3d
10
# - 摘取提交：git cherry-pick a1b2c3d
11

12
# 提交信息规范（推荐）
13
# 格式：<type>: <subject>
14
# type: feat(新功能) / fix(修复) / docs(文档) / style(格式) / refactor(重构) / test(测试) / chore(构建)
15

16
git commit -m "feat: 添加用户登录功能"
17
git commit -m "fix: 修复首页样式问题"
18
git commit -m "docs: 更新 README 安装说明"

1
# 方式1：在现有目录初始化
2
mkdir my-project
3
cd my-project
4
git init
5
# Initialized empty Git repository in /path/my-project/.git/
6

7
# 方式2：克隆已有仓库
8
git clone https://github.com/user/repo.git
9
# 或使用 SSH（推荐）
10
git clone git@github.com:user/repo.git
11

12
# 克隆到指定目录
13
git clone git@github.com:user/repo.git my-folder
14

15
# 克隆指定分支
16
git clone -b dev git@github.com:user/repo.git

1
# 1. 查看当前状态（最重要！养成习惯）
2
git status
3
# On branch main
4
# Changes not staged for commit:
5
#   modified:   src/index.js
6
# Untracked files:
7
#   src/utils.js
8

9
# 2. 添加到暂存区
10
git add src/index.js      # 添加单个文件
11
git add src/              # 添加整个目录
12
git add .                 # 添加所有更改
13

14
# 3. 再次查看状态确认
15
git status
16
# Changes to be committed:
17
#   modified:   src/index.js
18

19
# 4. 提交到仓库
20
git commit -m "feat: 添加工具函数"
21

22
# 5. 查看提交历史
23
git log
24
# 或简洁模式
25
git log --oneline -5

1
# 查看提交历史
2
git log                      # 详细历史
3
git log --oneline            # 简洁模式
4
git log --oneline --graph    # 分支图形
5
git log --oneline -10        # 最近10条
6

7
# 查看某次提交的详情
8
git show a1b2c3d
9

10
# 查看文件的修改历史
11
git log --follow -- path/to/file
12

13
# 查看差异
14
git diff                    # 工作区 vs 暂存区
15
git diff --staged           # 暂存区 vs 最新提交
16
git diff HEAD~1 HEAD        # 对比两次提交
17
git diff main..dev          # 对比两个分支
18

19
# 查看谁修改了某行（追责）
20
git blame src/index.js

1
# 撤销工作区修改（未 add）
2
git checkout -- filename
3
# 或（新语法）
4
git restore filename
5

6
# 撤销暂存（已 add，未 commit）
7
git reset HEAD filename
8
# 或
9
git restore --staged filename
10

11
# 修改最后一次提交信息
12
git commit --amend -m "新的提交信息"
13

14
# 撤销提交（保留修改）
15
git reset --soft HEAD~1     # 回退到上一次提交，修改在暂存区
16

17
# 撤销提交（丢弃修改）⚠️ 危险
18
git reset --hard HEAD~1     # 完全回退，丢失所有修改
19

20
# 已推送的提交撤销（创建新提交来撤销）
21
git revert a1b2c3d          # 安全，不改写历史

1
# 创建 .gitignore 文件
2
# 内容示例：
3

4
# 依赖目录
5
node_modules/
6
vendor/
7

8
# 构建产物
9
dist/
10
build/
11
*.min.js
12

13
# IDE 配置
14
.idea/
15
.vscode/
16
*.swp
17

18
# 系统文件
19
.DS_Store
20
Thumbs.db
21

22
# 环境配置（含敏感信息）
23
.env
24
.env.local
25
config/local.json
26

27
# 日志和临时文件
28
*.log
29
*.tmp
30
tmp/
31

32
# 强制追踪某个文件（即使目录被忽略）
33
!important/
34
!important/config.json

1
# 查看分支
2
git branch              # 本地分支
3
git branch -a           # 所有分支（含远程）
4
git branch -r           # 仅远程分支
5

6
# 创建分支
7
git branch feature/login          # 创建
8
git checkout -b feature/login    # 创建并切换
9
git switch -c feature/login      # 新语法（推荐）
10

11
# 切换分支
12
git checkout main
13
git switch main          # 新语法（推荐）
14

15
# 合并分支
16
git checkout main
17
git merge feature/login
18

19
# 删除分支
20
git branch -d feature/login      # 已合并的分支
21
git branch -D feature/login      # 强制删除（未合并也删）
22

23
# 查看分支图
24
git log --oneline --graph --all

1
# 冲突场景：两个分支修改了同一文件的同一位置
2

3
# 步骤1：尝试合并
4
git merge feature/login
5
# CONFLICT (content): Merge conflict in src/index.js
6
# Automatic merge failed; fix conflicts and then commit.
7

8
# 步骤2：查看冲突文件
9
git status
10
# Unmerged paths:
11
#   both modified: src/index.js
12

13
# 步骤3：手动编辑冲突文件
14
# 文件内容：
15
<<<<<<< HEAD
16
const version = "1.0.0";    # 当前分支的内容
17
=======
18
const version = "2.0.0";    # 要合并分支的内容
19
>>>>>>> feature/login
20

21
# 修改为：
22
const version = "2.0.0";    # 选择保留的内容
23

24
# 步骤4：标记冲突已解决
25
git add src/index.js
26

27
# 步骤5：完成合并
28
git commit -m "merge: 解决版本号冲突"

1
# 查看远程仓库
2
git remote -v
3
# origin  git@github.com:user/repo.git (fetch)
4
# origin  git@github.com:user/repo.git (push)
5

6
# 添加远程仓库
7
git remote add origin git@github.com:user/repo.git
8
git remote add upstream git@github.com:original/repo.git  # Fork 的上游仓库
9

10
# 修改远程地址
11
git remote set-url origin git@github.com:user/new-repo.git
12

13
# 删除远程仓库
14
git remote remove origin
15

16
# 查看远程仓库详情
17
git remote show origin

1
# 首次推送（设置上游分支）
2
git push -u origin main
3
# 之后可以直接
4
git push
5

6
# 推送所有分支
7
git push --all origin
8

9
# 推送标签
10
git push --tags
11

12
# 拉取更新
13
git pull origin main
14
# 等同于
15
git fetch origin main
16
git merge origin/main
17

18
# 仅获取不合并（安全）
19
git fetch origin
20
git log origin/main  # 先查看变更
21
git merge origin/main  # 确认后再合并
22

23
# 强制拉取远程覆盖本地（谨慎）
24
git fetch origin
25
git reset --hard origin/main

1
# 场景：为开源项目贡献代码
2

3
# 1. Fork 项目到自己的账号（在 GitHub 网页操作）
4

5
# 2. 克隆自己的 Fork
6
git clone git@github.com:yourname/oss-project.git
7
cd oss-project
8

9
# 3. 添加上游仓库
10
git remote add upstream git@github.com:original/oss-project.git
11

12
# 4. 创建功能分支
13
git checkout -b fix-security-issue
14

15
# 5. 开发并提交
16
# ... 修改代码 ...
17
git add .
18
git commit -m "fix: 修复安全漏洞"
19

20
# 6. 同步上游最新代码
21
git fetch upstream
22
git rebase upstream/main  # 或 merge
23

24
# 7. 推送到自己的 Fork
25
git push origin fix-security-issue
26

27
# 8. 在 GitHub 创建 Pull Request
28

29
# 9. PR 合并后，更新本地 main
30
git checkout main
31
git pull upstream main
32
git push origin main

1
# 创建 PR 的标准流程：
2

3
# 1. 确保分支是最新的
4
git checkout main
5
git pull origin main
6

7
# 2. 创建功能分支
8
git checkout -b feature/new-feature
9

10
# 3. 开发并提交
11
# ... 编写代码 ...
12
git add .
13
git commit -m "feat: 新功能描述"
14
git push origin feature/new-feature
15

16
# 4. 在 GitHub 网页创建 Pull Request
17
#    - 选择 base: main ← compare: feature/new-feature
18
#    - 填写 PR 标题和描述
19
#    - 添加 Reviewer（评审人）
20
#    - 关联相关 Issue（如 #123）
21

22
# 5. 根据 Review 反馈修改
23
# ... 修改代码 ...
24
git add .
25
git commit -m "fix: 根据 Review 反馈修改"
26
git push origin feature/new-feature
27

28
# 6. PR 合并后删除分支
29
git checkout main
30
git pull origin main
31
git branch -d feature/new-feature
32
git push origin --delete feature/new-feature

1
# 生成 Ed25519 密钥（推荐）
2
ssh-keygen -t ed25519 -C "your_email@example.com"
3
# 或 RSA（兼容性更好）
4
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
5

6
# 按提示操作：
7
# Enter file to save the key: ~/.ssh/id_ed25519  # 默认路径
8
# Enter passphrase: ******                         # 可选密码保护
9

10
# 查看公钥
11
cat ~/.ssh/id_ed25519.pub
12
# ssh-ed25519 AAAAC3Nza... your_email@example.com

1
# 场景：同时使用 GitHub 和 GitLab
2

3
# 生成不同密钥
4
ssh-keygen -t ed25519 -C "work@company.com" -f ~/.ssh/id_ed25519_work
5
ssh-keygen -t ed25519 -C "personal@gmail.com" -f ~/.ssh/id_ed25519_personal
6

7
# 配置 ~/.ssh/config
8
cat > ~/.ssh/config << 'EOF'
9
Host github.com
10
    HostName github.com
11
    User git
12
    IdentityFile ~/.ssh/id_ed25519_personal
13

14
Host gitlab.company.com
15
    HostName gitlab.company.com
16
    User git
17
    IdentityFile ~/.ssh/id_ed25519_work
18
EOF
19

20
# 测试
21
ssh -T git@github.com
22
ssh -T git@gitlab.company.com

1
# 方式1：git revert（推荐，不改写历史）
2
git revert a1b2c3d
3
git push origin main
4

5
# 方式2：git reset（危险，仅限自己独用的分支）
6
git reset --hard HEAD~1
7
git push --force origin main  # ⚠️ 会覆盖远程历史

1
# 策略1：接受他们的版本
2
git checkout --theirs conflict-file.js
3
git add conflict-file.js
4

5
# 策略2：接受我们的版本
6
git checkout --ours conflict-file.js
7
git add conflict-file.js
8

9
# 策略3：使用合并工具
10
git mergetool
11

12
# 策略4：取消合并
13
git merge --abort

1
# 问题：不小心提交了大文件，仓库变得很臃肿
2

3
# 使用 git filter-branch（传统方法）
4
git filter-branch --force --index-filter \
5
  'git rm --cached --ignore-unmatch path/to/large-file' \
6
  --prune-empty --tag-name-filter cat -- --all
7

8
# 使用 BFG Repo-Cleaner（推荐，更快）
9
# 下载：https://rtyley.github.io/bfg-repo-cleaner/
10
java -jar bfg.jar --strip-blobs-bigger-than 50M
11
git reflog expire --expire=now --all
12
git gc --prune=now --aggressive
13
git push --force

1
# 使用 reflog 找回
2
git reflog
3
# a1b2c3d HEAD@{1}: checkout: moving from feature to main
4
# e4f5g6h HEAD@{2}: commit: 重要的提交  ← 找到这个
5

6
# 恢复提交
7
git checkout -b recovered-branch e4f5g6h
8

9
# 恢复已删除的分支
10
git checkout -b recovered-branch HEAD@{2}

1
# 删除未跟踪的文件（预览）
2
git clean -n
3

4
# 删除未跟踪的文件
5
git clean -f
6

7
# 删除未跟踪的文件和目录
8
git clean -fd
9

10
# 删除被忽略的文件（谨慎）
11
git clean -fX