引用站外链接
Git
fast-version-control
引用站外链接
Git
廖雪峰 Git 教程
引用站外链接
Git
教程
引用站外链接
learn Git
Git 闯关
引用站外链接
learn Git
Git 沙盒

配置相关

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 基础身份配置
git config --global user.name "Your Name"       # 设置全局用户名
git config --global user.email "your@email.com" # 设置全局邮箱

# 查看配置
git config --list                   # 查看所有配置项
git config user.name                # 查看当前用户名

# 系统级配置（跨平台开发常用）
git config --global core.autocrlf input      # Mac/Linux：换行符转换为LF
git config --global core.autocrlf true       # Windows：换行符转换为CRLF
git config --global core.fileMode false      # 忽略文件权限变更
git config core.ignorecase false             # 打开文件大小写敏感

# 编辑器与别名
git config --global core.editor "vim"        # 设置默认编辑器（vim）
git config --global alias.co checkout        # 创建别名（co 代替 checkout）
git config --global alias.br branch          # br 代替 branch
git config --global alias.st status          # st 代替 status

初始化本地仓库（如果项目未初始化）

1
2
3
git init                            # 初始化新仓库
git clone <远程仓库URL>             # 克隆远程仓库（含完整历史）
git clone --depth 1 <仓库URL>       # 浅克隆（仅最新版本，节省空间）

文件操作

1
2
3
4
5
6
7
8
9
# 添加文件到暂存区
git add .                          # 添加所有变化（包括新建/修改/删除）
git add -A                         # 同上，更明确的语法
git add -u                         # 仅添加已跟踪文件的修改（不包含新建）
git add -p                         # 交互式选择修改片段添加到暂存区

# 文件状态管理
git rm [file-name]                 # 删除文件并暂存删除操作
git mv [old-name] [new-name]       # 重命名文件并暂存操作

提交管理

1
2
3
4
5
6
7
8
9
10
11
12
git commit -m "提交描述"            # 标准提交
git commit --amend                 # 修改最后一次提交（可修改描述/追加文件）
git commit --allow-empty -m "描述"  # 创建空提交（用于触发CI等场景）

# 提交规范建议
# feat: 添加新功能
# fix: 修复bug
# docs: 文档变更
# style: 代码格式调整（不影响逻辑）
# refactor: 代码重构
# test: 添加/修改测试用例
# chore: 构建过程或辅助工具的变动

远程仓库管理

1
2
3
4
5
6
git remote add origin [URL]          # 添加远程仓库（命名为origin）
git remote -v                        # 查看远程仓库地址
git remote rename origin [new-name]  # 重命名远程仓库
git remote remove origin             # 删除远程仓库关联
git remote clear                     # 清除所有远程关联
git push -u origin main              # 首次推送并建立跟踪关系

分支操作

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 基础分支操作
git branch                                  # 查看本地分支
git branch -r                               # 查看远程分支
git branch -a                               # 查看所有分支（本地+远程）
git checkout -b [new-branch]                # 创建并切换到新分支
git switch dev                              # 更直观的分支切换（Git 2.23+）
git branch -m [old-branch] [new-branch]     # 本地分支重命名
git push origin --delete [old-branch]       # 删除远程分支

# 分支关系管理
git branch -vv                            # 查看分支跟踪关系
git branch --set-upstream-to=origin/main  # 修改当前分支的上游分支
git push -u origin dev                    # 推送并设置上游分支

# 分支合并策略
git merge dev                      # 普通合并（保留合并提交记录）
git merge --squash dev             # 压缩合并（将多个提交合并为单个新提交）
git rebase main                    # 变基操作（整理提交历史，保持线性）

代码同步

1
2
3
4
5
git pull                          # 拉取并合并（= git fetch + git merge）
git pull --rebase                 # 拉取并使用变基合并（保持提交历史线性）
git fetch --prune                 # 同步远程分支（自动清理已删除的远程分支）
git push                          # 推送到跟踪的远程分支
git push -f                       # 强制推送（覆盖远程历史，慎用！）

撤销与恢复

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 工作区撤销
git restore [file]                # 撤销工作区修改（Git 2.23+）
git checkout -- [file]            # 传统撤销方式（效果同上）

# 暂存区撤销
git restore --staged [file]       # 将文件移出暂存区（Git 2.23+）
git reset HEAD [file]             # 传统方式（效果同上）

# 提交历史操作
git reset --soft HEAD~1           # 回退提交但保留修改在暂存区
git reset --hard HEAD~1           # 彻底回退提交（慎用！）
git revert [commit-hash]          # 创建反向提交撤销指定修改

# 应急恢复
git reflog                        # 查看所有操作记录（找回丢失的提交）
git cherry-pick [commit-hash]     # 复制指定提交到当前分支
git stash                         # 临时保存工作进度
git stash pop                     # 恢复最近暂存的工作进度

差异与日志

1
2
3
4
5
6
7
git status                        # 查看当前仓库状态
git diff                          # 工作区与暂存区差异
git diff --staged                 # 暂存区与最新提交的差异
git diff commit1 commit2          # 两个提交之间的差异
git log --oneline --graph         # 图形化简洁日志
git log -p                        # 显示详细修改内容
git blame [file]                  # 逐行查看文件修改历史

标签管理

1
2
3
4
5
6
git tag v1.0                      # 创建轻量标签
git tag -a v1.0 -m "版本说明"      # 创建带注释的标签
git push origin v1.0              # 推送单个标签
git push --tags                   # 推送所有本地标签
git tag -d v1.0                   # 删除本地标签
git push origin --delete v1.0     # 删除远程标签

场景：

  • 更改仓库分支名称

    1. 本地分支重命名
      1
      git branch -m [old-branch] [new-branch]
    2. 删除远程旧分支
      1
      git push origin --delete [old-branch]
    3. 推送新分支到远程并绑定
      1
      git push -u origin [new-branch]

  • 追加小修小补的修改到上一次提交

    1. 添加新修改到暂存区：
      1
      git add .
    2. 修改上一次提交：
      1
      2
      git commit --amend -m "新的提交信息"
      git commit --amend --no-edit         #不用修改提交信息
    3. 强制推送：
      1
      git push -f

  • 删除远程 [branch] 分支，保留本地

    1. 在删除远程分支前，先确认本地分支是最新的：
      1
      2
      git checkout [branch]          # 切换到 [branch] 分支
      git pull origin [branch]       # 拉取远程最新更改（确保本地与远程同步）
    2. 使用 Git 命令删除远程分支
      1
      git push origin --delete [branch]   # 删除远程 [branch] 分支
      或（等效命令）：
      1
      git push origin :[branch]          # 推送“空内容”到 [branch] 分支，相当于删除

当删除的分支与其他分支存在关联（如合并或衍合）时，其提交历史仍会保留在相关分支中。

补救措施

  • 备份 .git 文件夹：如果误操作，可尝试恢复原有 .git 文件夹。

实现快捷操作

  • 在 Windows 或 MacOS 命令行中，可以直接将文件或者文件夹拖入窗口，实现快速输入路径