cd ~

, with read , about 55min.

Git Tips

#Git #版本控制 #Cheat_Sheet

Hot Tips

说明 命令 示例
从本地推送并创建远程分支 git push <远程主机名> <本地分支名>:<远程分支名>
如果远程主机中没有对应的分支,则会新建该分支。		 git push sunzy dev:dev
也可以通过-u或--set-upstream选项设置关联关系,这样以后就可以直接使用git push来推送本地分支了:
git push -u origin dev
此外,也可以使用git push origin :dev的方式删除远程的分支。
--no-ff 合并 git merge 和 git merge --no-ff 都是用来合并 branch 的命令，在使用上存在一些差异。
1.git merge：在默认情况下，Git执行"Fast-forward"模式，如果被合并的 branch 比当前的 branch 更新（在提交历史上在前），那么 Git 只会简单地把 HEAD 指针指向被合并的 branch，这就是快进（fast-forward）合并。这种方式下，合并的信息并不会体现在commit历史中。
2.git merge --no-ff：--no-ff参数意味着"no fast forward"，禁用"Fast-forward"模式。即使被合并的 branch 比当前的 branch 更新，Git 在合并时也会创建一个新的 commit 对象，并把两个 branch 的最新 commit 作为这个新 commit 的 parents。这样可以在历史记录中明确地看到分支与合并的情况，更清晰的保留项目历史和合并信息。在团队协作中，git merge --no-ff 更为推荐，因为这样可以清楚地看到项目的分支和合并历史。		 git merge <target branch> --no-ff -m "为合并这个操作附加一段commit msg"
临时bug修复 有时候，突然接到一个紧急修复线上bug的任务， 这时候肯定需要新建一个专用于修复bug的分支， 但是当前分支上的工作还没有完成，或者不便于立即提交当前工作以保持工作的连续性。 这时候我们可以使用 git 提供的 暂存工作区的功能。
1. git stash 暂存当前工作区
2. git stash list 查看当前暂存的工作区
3.恢复工作区有两种方式， 第一种是 git stash apply恢复，然后删除 stash，git stash drop; 另一种是直接恢复并删除stash, git stash pop
4. git stash list 是查看所有stash 的列表， 意味着 git stash 可以多次执行， 想要恢复到指定版本的stash , 可以这样 git stash apply stash@{stash序号}
cherry-pick 有时候，在某个分支上做了某些细微改动，但是当前在另一个分支上，例如我在主分支上提交了bug修复，当我当前在dev分支上， 这个分支上也有这个bug没修复， 这时候，可以直接把那个修复bug的commit复制过来， 这个行为称为 cherry-pick git cherry-pick 4c805e2, 后面的编号就是commit id
修改默认分支master为 main 1. 修改本地分支： git branch -m master main
2. 创建远程新分支main: git push -u origin main
3. 删除远程 master 分支：git push origin --delete master

其他人：
1. 切换到master 分支： git checkout master
2. 重命名为 main: git branch -m master main
3. 拉取最新commits和分支：git fetch
4. 移除远程追踪分支：git branch --unset-upstream
5. 创建新的对远程main分支的追踪： git branch -u origin/main

版本管理

说明 命令 示例
查看历史提交记录 git log
查看历史提交记录，单行显示 git log --pretty=oneline
将当前仓库回退到上个版本 git reset --hard HEAD^
将当前仓库回退到上上个版本 git reset --hard HEAD^^
将当前仓库回退到上 N 个版本 git reset --hard HEAD~n
将当前仓库指向到特定版本 git reset --hard <commitId>
如果回退到某个历史版本后，那么自该历史版本之后的新版本，通过 git log 命令就看不见了，这时候如果需要重新回到某个新的版本，需要知道对应的 commit id, 可以通过 git reflog 命令查找所有的版本变更记录，从而找到 commit id，然后使用 reset 命令就可以切换到指定版本 git reflog

撤销修改

说明 命令 示例
撤销当前工作区单文件修改 git checkout -- <file>
撤销删除，如果意外删除了某个文件，也可以用checkout -- 命令恢复 rm -f <file>
git checkout -- <file>
撤销当前工作区所有修改 git checkout -- .
撤销暂存区单文件修改, 注意撤销后的文件修改不会丢失，而是回到工作区，变成modified 状态 git restore --staged <file>
或者
git reset HEAD <file>

二者主要区别在于主要的区别在于git restore --staged <file>会恢复暂存区中的更改到工作目录中，而git reset HEAD <file>则是将暂存区中的文件状态重置为与最新提交相同，但不会影响工作目录中的文件。
撤销暂存区所有文件修改，注意撤销后的文件修改不会丢失，而是回到工作区，变成modified 状态 git restore --staged .

当确定删除某个文件后， 需要 git add <file> 以暂存这个 “删除操作”， 然后才能 commit, 这个操作等同于直接使用git rm 删除文件。

分支管理

说明 命令 示例
查看分支 git branch仅查看本地分支, git branch -a查看所有分支，包括远程分支
创建并切换分支 git checkout -b <new branch name>, 或者 git switch -c <new branch name>
切换分支 git checkout <branch>， 或者 git switch <branch>
合并分支 git merge <target branch>, 将目标分支合并到当前分支
删除分支 git branch -d <target branch>
变基 git rebase
分支临时切换，工作区域暂存 主要通过 git stash 命令，将所有修改（包括已暂存和未暂存的内容）保存到暂存区，并清理当前工作目录。
注意⚠️：该命令默认情况下，git stash 只保存已跟踪文件（tracked files）的修改， 如果需要保存 untracked 文件的修改，需要加上 --include-untracked 或 -u 选项。
git stash show 命令可以查看当前保存的文件
git stash pop 将保存的文件弹出到当前工作区。

最简单的操作流程是：

当前分支在 feature-branch
git stash --include-untracked：保存所有修改。
git checkout hotfix-branch：切换分支。
处理完需求后，git checkout feature-branch。
git stash pop：恢复修改。

冲突管理

冲突发生在分支合并时， 例如a,b 两个分支同时修改了同一个文件， 在合并的时候就会产生冲突， 冲突发生时，该目标文件会被修改。 例如：

1 <<<<<<< HEAD
2 hello file02 world
3 =======
4 hello world file02
5 >>>>>>> newbranch
6 asdas

copy success

这时候，需要手动去修正这个文件，然后提交，就可以修复冲突。 如果不修改， 直接git add . 然后 commit, 那么这份冲突的文件就会被直接提交， 包含这些 <<<<....,=== 表示冲突的标记。各类编辑器携带的冲突编辑器只是帮我们便捷处理这个过程。

说明 命令 示例
查看分支图 git log --graph
单行格式化查看分支图 git log --graph --pretty=oneline

仓库管理

说明 命令 示例 备注
查看当前仓库的远程列表 git remote -v

远程仓库管理

说明 命令 示例 备注
拉取远程仓库信息，同步到本地 git fetch origin 同步远程信息：它确保你本地的远程跟踪分支（如 origin/main）与远程仓库的实际状态保持一致
不影响本地工作：它不会修改你当前的工作目录、本地分支或暂存区。你需要后续手动合并或检出这些更改。
git pull：相当于 git fetch + git merge。它不仅下载远程数据，还会尝试将这些更改合并到当前本地分支。
添加新的远程仓库 git remote add <Origin_Name> <Git_Url> git remote add gitee git@gitee.com:jaycesun/example.git
推送当前分支到新的仓库 确保当前分支已经切换，后直接执行git push <Origin_Name>
推送本地分支到某个远程仓库特定分支 git remote add <Origin_Name> <Git_Url>
git push <Origin_Name> <Local_BranchX>:<Remove_BranchX>		 git push gitee main:main
推送所有当前本地仓库分支到新的远程仓库 git remote add <Origin_Name> <Git_Url>
git push <Origin_Name> --all
推送所有远程分支到新的远程仓库 git remote add <Origin_Name> <Git_Url>
git fetch origin
git push <new-origin> "refs/remotes/origin/*:refs/heads/*"		 注意⚠️： 这不等同于完全仓库同步，仓库同步详见下面的专项说明内容。
查看远程仓库 git remote -v
修改远程仓库地址 git remote set-url <Origin_Name> <Git_Url> git remote set-url origin https://github.com/OWNER/REPOSITORY.git
修改远程仓库名称 git remote rename <Origin_Name> <New_Origin_Name> git remote rename origin destination
删除远程仓库配置· git remote rm <Origin_Name> git remote rm gitee
查看仓库的引用列表 git ls-remote <Origin_Name>

关于仓库同步

有的时候，我们需要将一个仓库完全同步到一个新的仓库。

git remote add <new-origin> <url> #用于将新的远程仓库 <new-origin> 添加到本地仓库的远程列表中
git fetch origin # 更新本地的 远程分支状态 refs/remotes/origin/* 和 标签refs/tags/*
git push <new-origin> --mirror # 将本地仓库的所有引用（refs/*）镜像推送至 <new-origin>
git push <new-origin> "refs/remotes/origin/*:refs/heads/*" # 本地 refs/remotes/origin/*（从 origin 获取的远程跟踪分支）推送为 <new-origin> 的 refs/heads/*，即将 origin 的分支（如 refs/remotes/origin/dev）转换为 <new-origin> 的分支（如 refs/heads/dev）
copy success

其中，如果要知道一些步骤具体做了什么，下面是详细说明：

  1. git push <new-origin> --mirror
    1. 作用：将本地仓库的整个引用空间（refs/*）镜像到 <new-origin>, 包括本地分支(refs/heads/*)、远程跟踪分支(refs/remotes/*)、标签（refs/tags/*） 等。
    2. 依赖：这个操作只依赖本地仓库当前的引用状态，不和远程仓库 origin 交互，这也是为什么在这之前需要 git fetch origin 的原因，如果 origin 自上次 git fetch 后有新分支或更新，而你希望这些最新内容也镜像到 <new-origin>。否则，<new-origin> 只会收到你本地当前的（可能过时的）引用。
  2. git push <new-origin> "refs/remotes/origin/*:refs/heads/*"
    1. 作用： 将本地仓库的 refs/remotes/origin/*（远程跟踪分支，例如 refs/remotes/origin/feature/ack-test）推送为 <new-origin> 的 refs/heads/*（分支，例如 refsHeaders/feature/ack-test）。如果不执行这个操作，那么远程仓库上不会展示这些远程分支，不过有隐藏的refs/remotes/* 信息，分支指的是refs/heads/*, refs/remotes/* 值得是远程分支的引用。
    2. 依赖：直接依赖本地 refs/remotes/origin/* 的内容，这同样也是为什么需要在这之前需要 git fetch origin 的原因,因为如果 origin 有新分支或提交，我们也希望这些最新内容也被推送为 <new-origin> 的分支

所以，如果我们其实不需要非常完全的仓库复制，只推送必要引用，保持新仓库干净，我们可以通过下面这种方式同步仓库：

git remote add new-origin <url>
git fetch origin
git push new-origin --all             # 同步所有本地分支
git push new-origin "refs/remotes/origin/*:refs/heads/*"  # 同步 origin 分支
git push new-origin --tags            # 同步所有标签
copy success

Git 极速指北 - @joisun

Git 的核心概念

理解 Git 的几个关键概念，能让你在操作时事半功倍。

引用（Reference）

引用是指向提交（commit）的指针，是 Git 管理历史的基础。类型包括：

实践意义：知道引用类型，就能明白 git push 或 git fetch 在操作什么。例如，推送分支是操作 refs/heads/*，而 origin/master 是远程的影子。

工作区、暂存区和仓库

实践意义：这三个区域是操作的基础。例如，忘了 git add，提交就不会包含更改；用 git restore 可以撤销工作区修改。

提交（Commit）

提交是 Git 的最小历史单位，包含：

实践意义：提交是回滚和协作的基石，写好提交信息（如 fix: resolve login bug）能让历史更清晰。

“更新远程跟踪”是什么意思？

在 Git 中，“远程跟踪”（upstream）是指本地分支与远程分支之间的关联关系。具体来说：

“更新远程跟踪”是指调整或重新建立本地分支与远程分支的这种关联关系，尤其是在远程分支名称发生变化时（例如重命名后），确保本地分支仍然正确指向新的远程分支。

Git 常规工作流

以下是一个典型的单人或团队工作流，假设你在 my-project 仓库中。

初始化与首次提交

git init
echo "Hello" > README.md
git add README.md
git commit -m "Initial commit"
copy success

分支开发

  1. 创建并切换分支：
    git checkout -b feature/add-login
    copy success
  2. 修改代码，提交：
    git add .
git commit -m "Add login page"
    copy success

同步远程

  1. 添加远程仓库：
    git remote add origin <url>
    copy success
  2. 推送分支：
    git push origin feature/add-login
    copy success

合并到主分支

  1. 切换回主分支：
    git checkout master
    copy success
  2. 获取远程更新：
    git pull origin master
    copy success
  3. 合并分支：
    git merge feature/add-login
    copy success
  4. 推送主分支：
    git push origin master
    copy success

实践贴士：

常见操作详解

以下是开发中高频使用的操作，带你理解用法和场景。

Merge vs Rebase：合并还是变基？

Cherry-pick：挑拣提交

实践贴士：用 git log 找哈希，冲突时手动解决后 git cherry-pick --continue。

撤销与修复

分支操作

删除分支

  1. 删除本地分支

    git branch -d feature/login  # 删除已合并分支
git branch -D feature/login  # 强制删除未合并分支
    copy success

  2. 删除远程分支

    git push origin --delete feature/login
# 或
git push origin :feature/login
    copy success

实践：确认分支无用后再删

修改分支名称

  1. 修改本地分支

    git branch -m old-name new-name  # 重命名当前分支
git branch -m feature/old feature/new  # 重命名其他分支
    copy success

  2. 修改远程分支

    git branch -m feature/old feature/new #重命名本地分支
git push origin feature/new #推送新分支
git push origin --delete feature/old #删除旧分支

    copy success

更新远程跟踪

git fetch origin
git branch --unset-upstream feature/new
git branch --set-upstream-to=origin/feature/new feature/new
copy success

查看 Git 提交历史

历史查看是调试和协作的关键，Git 提供了多种工具。

git log：基本历史

示例输出：

* a1b2c3d Add login page
* d4e5f6g Initial commit

copy success

git log --graph：分支可视化

git reflog：操作日志

cd ~
GO BACK （Backspace）
BACK TO TOP （ESC）
COMMENTS （C）