概念：

工作区：改动（增删文件和内容）
暂存区：git add后，改动的内容所在区域成为暂存区
本地仓库：git commit后 改动就放到了本地仓库，每个 commit为一个版本
远程仓库：git push 此次改动就放到了远程仓库

• HEAD:指向的是当前分支的最近一次提交记录

• Tracking：追踪，本地与远程分支的关联 如 clone 会自动建立追踪关系，有追踪关系后 大多命令就可以省略写明远程及分支名 如 origin/master

• fast-forward（快速前进）是一个术语，用来描述一种特殊的合并操作。当一个分支的提交历史是另一个分支的直接前驱时，Git 可以执行一个“快速前进”合并。这意味着没有创建一个新的合并提交，而是简单地将分支指针移动到另一个分支的最新提交上。

  • $ 6936624 (HEAD -> master, origin/master, origin/HEAD) 提交信息 类似这种就算是快进式
  • 非快进式会创建一条Merge branch 'master' of https:///xxxx.xx/xx/xx.git

• Config

  git config  user.name.. 		#配置提交用户名
  git config --global user.name.. #配置全局提交用户名
  
  git config --global core.autocrlf true #换行符 windows 设置true linux mac设置input
  
  git config --global http.proxy http://192.168.3.85:7897 #配置代理

主线（区域）	状态中	符号(git status -s)	备注
工作区	未跟踪(Untracked)	??	从没被 Git 记录过
工作区	已修改(Modified)	M	已跟踪文件被改动，尚未 add
工作区	已删除(Deleted )	D	已跟踪文件被删除，尚未 add
工作区	未修改(Unmodified)		与 HEAD 完全一致
暂存区	新增(Staged (new))	A	git add 后准备提交
暂存区	修改(Staged (modified))	M	改动后 git add
暂存区	已暂存（deleted）	D	git rm 或手动删后 git add
本地仓库	已提交(Committed)		HEAD 指向的提交里存在
远程仓库	已推送(Pushed)		与远程分支同步完成

忽略文件

.gitignore 文件重新生效

git ls-files #查看暂存区包含的文件
git ls-files *.dll #查看索引中指定后缀的文件

git rm -r --cached filename 		#取消跟踪索引区的指定文件，但不删除本地文件
git rm -r --cached . 				#取消跟踪索引区的所有文件，但不删除本地文件
git add . 							#重新trace file
git commit -m "update .gitignore"   #提交和注释
git push origin master 				#可选，如果需要同步到remote上的话



# git rm -r --cached . 详解
# `git rm`:  Git 中的删除文件的命令。它用于从 Git 仓库中删除文件或目录。
# `-r`: git rm的参数，表示递归地删除目录及其内容。在这个命令中，它用于删除目录以及目录中的所有文件和子目录。
# `--cached`: git rm 参数，表示只从 Git 缓存中删除文件，而不删除实际的文件。使用 `--cached` 选项可以确保文件保留在本地文件系统中，但不再被 Git 跟踪。
# `.`: git rm 命令的参数，表示当前目录。通过指定 `.`，`git rm` 命令将递归地删除当前目录下的所有文件和子目录。

关联远程库

1.生成本地的 key 贴到 git 完成身份认证 只适用于ssh协议

#生成秘钥关联 git
cd ~/.ssh/
ssh-keygen.exe
#id_rsa.pub

2.使用账号密码登录

git config --global credential.helper store 配置永久存储登录信息 (会存储明文,可以生成personal access token 代替密码)

git config --global credential.helper manager-core windows可以存在凭证管理器

初始化仓库

• 步骤

1. git init  						#初始化本地仓库
2. git add . 						#添加所有文件到缓存
3. git commit -m 'sss' 				#提交到仓库
4. git remote add origin [仓库地址]  #新增Git关联
5. git pull origin master --allow-unrelated-histories  #强行合并 如果远程仓库有内如比如remdeme之类的
6. git push -u origin master 		#-u是在指定默认主机，这样以后提交可以省略写主机名直接Git push。提交到指定分支git push -u origin 本地分支名:远程分支
7. git remote remove origin #移除关联仓库

• 更改远程库地址

git remote set-url origin [地址]

查看

git remote -v #远程仓库信息


git show [commitid] #超详细的内容

git ls-tree <hash>  #HEAD~1 #查看文件树
git ls-files --stage #查看暂存区 .git/index文件
git cat-file -p <hash> #查看一切

#根据文件来查看 责任 找锅
git log --oneline <filename> #文件相关的提交
git log --oneline --stat <filename> #再加上文件的行数变动 看出提交的规模
git log --pretty=format:"%h %ad %an %s" --date=short <filename> #时间和提交人
git log --pretty=format:"%h %ad %an %s" --stat --date=short <filename> #最详细
###################################################
ec078b3 2025-11-10 user1 坐标转换接口
 MorphoScan.Common.DeviceInterface/ScannerService.cs | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

312a6a3 2025-11-06 user2 更新初始化接口
 MorphoScan.Common.DeviceInterface/ScannerService.cs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

38ca96a 2025-11-06 user3 流程 初步集成部分接口
 MorphoScan.Common.DeviceInterface/ScannerService.cs | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

8c12230 2025-11-06 user3 初步梳理流程
 .../ScannerService.cs                              | 65 ++++++++++++++++++++++
 1 file changed, 65 insertions(+)

7cff4cc 2025-11-05 user1 移动坐标隐射文件到设备接口层 添加接口与实现
 .../ScannerService.cs                              | 42 ++++++++++++++++++++++
 1 file changed, 42 insertions(+)
######################################################

别名 [alias]

git config --global --get-regexp alias #查看已设置的别名

git config --global alias.ss "status -s" #设置别名 `git status -s` => `git ss`
git config --global --unset alias.ss #取消别名



#常用
git config --global alias.ss "status -s"
git config --global alias.log1 "log --oneline"
git config --global alias.cm "commit -m"
git config --global alias.cam "commit -am"
git config --global alias.logdetail 'log --pretty=format:"%h %ad %an %s" --stat --date=short'

拉取 [clone、fetch、pull]

• 操作

git clone --depth=1 --branch=main --single-branch
git clone -b <指定分支名> <远程仓库地址>
git clone --config http.proxy=http://...... <仓库地址> #使用代理 clone 好像没效果，全局设置的有效果
git clone --depth <深度> --branch <分支名称> <远程仓库链接>
#git clone --depth 1  --config http.proxy=http://192.168.3.85:7897 --branch main  https://github.com/langgenius/dify.git


git fetch [remote]  	#拉取远程仓库的所有变动 只不自动合并 拉取完成后可以通过git branch -a查看
git fetch --prune       #清理已删除的远程分支跟踪
git log <localbranch>..<origin/branch> #查看本地分支比远程分支的差异
git merge <origin/branch>


git pull 				#拉取前分支自动远程仓库默认关联的分支的所有变动 并合并 [fetch+merge]
#git pull不会在拉取远程分支的时候，删除对应的本地分支。这是为了防止，由于其他人操作了远程主机，导致git pull不知不觉删除了本地分支。但是，你可以改变这个行为，加上参数 -p 就会在本地删除远程已经删除的分支。
git pull origin branch #拉取远程的指定分支

添加 [add]

保存更改或新增的文件到暂存区

git add . # 一次性添加所有新增 更改的文件

提交 [commit]

将暂存区文件提交

git commit -m '提交信息' # 将暂存区所有文件提交
git commit -a -m '提交信息' # -am 将暂存区所有已跟踪的文件提交 (意思是新增的文件无法提交 必须使用add)

git commit -p #交互式的选择想要提交的未暂存的文件

git commit -m "new clone way-$(date '+%m.%d %H:%M')"

状态 [status]

git status
git status -s

git diff
git diff --straged

推送 [push]

• 操作

  git push
  git push [remote] --force  	#-f 强行推送当前分支到远程仓库，即使有冲突
  git push [remote] +[分支名] #+等同于-f
  git push --mirror [email protected]/path/to/path/new_project_name.git # 以镜像方式推送到新仓库，保留所有分支与提交记录，但是不会更改现有项目的remote地址
  git remote set-url origin remote_git_address  #替换地址

分支 [branch]

• Master:主分支
• Develop：开发分支
• Release：预发布
• Fixbug：补丁分支
• Feature：功能分支
• 操作

git branch    -r:远程 -a:本地 			   #查看当前分支
git branch [分支名] 						#创建分支
git checkout [分支名]  					#切换分支
git checkout -b [分支名]  				#创建并切换分支
git checkout <commitid> -b <分支名>      # 提交记录创建为分支
git checkout --orphan new_branch        # 创建为没有提交记录的分支

git branch -u origin/dev                #设置默认本地仓库跟踪远程仓库

git switch [分支名] 						#切换分支
git switch -c [分支名] 					#创建并切换分支
git switch -c <new-branch> upstream/<upstream-branch>

git push --set-upstream [远程仓库] [分支名]    #分支签入仓库或其他仓库
git push --set-upstream [远程仓库] [本地分支名]:[远程仓库分支名]
git push --set-upstream main TeleMedLink:dev -f  # 强制将本地的TeleMedLink分支签入远程main仓库的dev分支

git branch -m [原分支名]  [现分支名]  		 #修改分支名

# 更改远程分支名
git push origin :[branch_old]
git push --set-upstream origin [branch_new]

git branch -d [分支名] 					#删除分支
git push origin --delete [branch_name]    #删除远程分支

git push origin test:master -f # 强制将master分支内容替换为test分支的内容
# git switch 命令用于切换分支，而不是创建分支。

标签 [Tag]

git tag -a 0.1.3 -m “Release version 1.0″       #-a 标签名， -m 标签注解
git push origin --tags              			# 提交标签
git push origin :refs/tags/0.1.3				#删除远端tag
git push --delete origin [tagname]              #删除远端tag


git switch [tagname]        #切换到tag
#切换到标签后，你的工作目录会处于一个“分离的 HEAD”状态（detached HEAD）。意思是 HEAD 指向了一个具体的提交，而不是一个分支。
#在这种状态下，不能直接进行提交，因为标签是不可变的。需要把他新建为一个分支(branch)

贮藏 [stash]

git stash 命令用于将当前工作目录/暂存区中未提交的更改保存到一个临时的存储区域中，以便稍后再次恢复这些更改。 需要暂时保存您的更改，以便切换到其他分支或修复其他问题时。 需要在多个分支之间进行切换时，但是有未完成的更改需要在不同的分支之间共享。 注意!! git stash 命令不会将未跟踪的文件保存到存储区中(新建的文件)。如果您需要保存未跟踪的文件，可以 git add或使用 git stash -u命令

 git stash # 贮藏当前修改内容
 git stash save "message" #将未提交的更改保存到一个新的存储区，并添加一条可选的消息
 git stash show -p stash@{..} # 查看指定贮藏的详细代码
 git stash pop   #弹出最新贮藏的内容 并删除
 git stash apply #弹出保存最新的一次
 git stash apply/pop stash@{123} # 弹出指定序号的贮藏
 
 git stash push -- <file1> <file2>  #贮藏指定的文件

checkout

传统命令，可用来切换分支或回复工作目录的内容

git checkout main #切换到main分支

git checkout --readme.md #回复readme.md 文件到最近提交的状态

记一次使用checkout恢复提交

#####################
# 想还原到某个提交的分支，但是该分支被后来的提交覆盖了
# 由于修改的代码没有交叉，所以可以直接使用这种方式还原指定的代码
#####################
#拉取最新
yuche@defang MINGW64 /d/workrepo/CSharp/MorphoScan/morphoscan-modules (dev)
$ git pull
Already up to date.

#开新分支
yuche@defang MINGW64 /d/workrepo/CSharp/MorphoScan/morphoscan-modules (dev)
$ git switch -c ft-chonggou
Switched to a new branch 'ft-chonggou'

#还原某个分支的代码
yuche@defang MINGW64 /d/workrepo/CSharp/MorphoScan/morphoscan-modules (ft-chonggou)
$ git checkout d5c6241 -- ./Modules/MorphoScan.Modules.ScanModule/

#检查差异
yuche@defang MINGW64 /d/workrepo/CSharp/MorphoScan/morphoscan-modules (ft-chonggou)
$ git diff --name-only origin/dev
Modules/MorphoScan.Modules.ScanModule/ScanModuleModule.cs
Modules/MorphoScan.Modules.ScanModule/ViewModels/ScanMainViewModel.cs
Modules/MorphoScan.Modules.ScanModule/Views/ScanCompletedView.xaml

切换创建分支 [switch]

分支切换

git switch      # 切换分支
git switch -c   # 创建一个新分支并切换到该新分支
git switch -    #切换到上一个切换的分支
git switch      #以一个提交commit来创建一个分支 git switch -c test3 <e053cf128d2ad9d35e2f94878569596fb32f4306>

撤销操作 [checkout、restore、reset]

git checkout

放弃所有修改！

# 恢复工作区的内容到上次提交的状态 "."代表全部，没被追踪的文件没事【**意思就是你写的东西没了！！！**】
git checkout <文件>
git checkout <commitid> <文件>  #恢复文件到指定commitid的时候
git checkout d4e5f6a -- file.txt

git restore

新命令,跟 checkout 类似 替代了之前的命令 checkout 的某些功能 用来操作工作区与暂存区的文件。 但是更清晰明了

作用：

• 开发过程中需要快速恢复实验性更改。
• 恢复单个文件到最近提交状态以修复错误。
• 清理工作区以保持干净的工作环境。

# 恢复工作区的内容到上次提交的状态 "."代表全部，没被追踪的文件没事（因为恢复的原理是获取上一个版本的文件，但是未跟踪的文件上一个版本没有，所以他不会变更）【**意思就是你写的东西没了！！！**】
git restore <文件>

git restore --staged <文件>              # 撤销暂存区的内容到工作区(撤销add) "."代表全部, 内容不变
git restore --source=<commit id> <文件>  # 恢复文件到指定一次commit id的时候

git reset

用来操作本地仓库即 commit 后的内容。重置分支的指针和索引

作用：

• 开发时，提交历史尚未推送到远程仓库，需频繁调整。
• 需要清理临时或错误的提交，保持干净的提交历史。
• 修复分支状态或撤销错误操作。

git reset --soft HEAD^ #撤销最近一次的commit提交
		--mixed: #保留所有更改在工作目录中，但未暂存（这是默认选项）。
		-–soft：#退回暂存区。不删除工作空间的改动代码 ，撤销commit(本地库)，修改内容退回git add(暂存区) ，保留工作目录的内容
		-–hard：# 重置当前分支的指针和索引到指定的提交，同时丢弃工作目录中的所有修改。它会彻底地清除未提交的更改，包括已修改的文件和未跟踪的文件。撤销commit和add,指向指定版本 【**你本次修改写的的内容就全没了！！！！！**】
		   
 # HEAD^ 表示上一个版本，即上一次的commit，也可以写成HEAD~2，撤回两次的commit，HEAD^^ 可以使用HEAD~2 表示2次，3表示三次

注意

当 push 之后，发现有问题，可以使用 git reset 回退提交并强制推送。

• 适用场景：推送了错误的提交，想完全移除这些提交（例如，提交了不该提交的文件或错误代码），并且远程仓库尚未被其他协作者使用。适合个人项目或分支。
• 方法：使用 git reset 回退到某个提交，然后强制推送覆盖远程仓库历史。

git reset --hard HEAD~n # 回退 n 个提交，丢弃更改
# 或者
git reset --soft HEAD~n # 回退 n 个提交，保留更改以重新提交

git push -f

团队开发时，非必要不使用，会影响别人

yuche@defang MINGW64 /d/czWorkSplace/test/testgit (master)
$ git log1
4ba6c56 (HEAD -> master, origin/master, origin/HEAD) rm jpg
946babe add jpg
a921be9 update config
130cf08 2.txt
e5f8554 33333
6e0088d 123
a717313 first cmt

yuche@defang MINGW64 /d/czWorkSplace/test/testgit (master)
$ git reset --hard 130c
HEAD is now at 130cf08 2.txt

yuche@defang MINGW64 /d/czWorkSplace/test/testgit (master)
$ git log1
130cf08 (HEAD -> master) 2.txt
e5f8554 33333
6e0088d 123
a717313 first cmt

yuche@defang MINGW64 /d/czWorkSplace/test/testgit (master)
$ git push
To https://git.csoyi.xyz/yuchen/testgit.git
 ! [rejected]        master -> master (non-fast-forward)
error: failed to push some refs to 'https://git.xxx.xx/yuchen/testgit.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. If you want to integrate the remote changes,
hint: use 'git pull' before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.


yuche@defang MINGW64 /d/czWorkSplace/test/testgit (master)
$ git push -f
Total 0 (delta 0), reused 0 (delta 0), pack-reused 0 (from 0)
remote: . Processing 1 references
remote: Processed 1 references in total
To https://git.xxx.xx/yuchen/testgit.git
 + 4ba6c56...130cf08 master -> master (forced update)

总结

• 文件只在工作区操作，未 add,撤销操作：git restore <file>。 => 工作区文件回退。
• 文件已 add，未 commit。撤销操作：git restore --staged <file>。 => 暂存区文件回退，工作区文件未回退，如需继续回退，操按情况 1 操作。
• 文件已 add，已 commit。撤销操作：git reset --soft HEAD^。 => 工作区文件、暂存区文件、本地仓库都回退

git reflog

后悔药！查看命令记录，找回被退掉在 log 中看不到的版本

• 提交到远程后发现提交错了 要回退到某一个版本:

    1.git relog 				 #查看版本号 看需要退回到哪一个版本
    2.git reset --soft 版本号 		 #版本号是一个哈希值，  git reset --soft "****^"
    3.git log 				 #看看是否有退回成功
    #4.git push origin master --force     #强制提交当前版本到远端

合并 [merge]

git merge [分支名] 						#合并到当前分支
	--no-ff  #no-ff模式:非快进式合并。默认的合并是快进式合并 是直接指向被合并的分支，这样会继承被合并分支的提交记录，看起来就很不清晰，所以要用非快进式合并
	--squash #将要合并的分支的所有提交压缩成一个单独的提交，并将其应用到当前分支，而不保留原始分支的提交历史
	--abort #中止当前的合并操作，并尝试返回到合并之前的状态。这对于在合并过程中遇到问题或冲突时很有用


#本地新开分支[feature]编写后不提交到远程，合并到dev
git pull origin #拉去远程的分支
git merge dev
git switch dev
git merge feature

变基 [rebase]

作用类比 merge，不会创建整合节点 重写提交历史，可以让分支提交看起来更线性 记录看起来非常整齐，但是处理冲突比较麻烦

不要 rebase 已推送的公共分支。

• 将一个分支里的工作直接移到 另一个 分支上。移动以后会使得两个分支的功能看起来像是按顺序开发，但实际上它们是并行开发的。

  • 适合：

    • 个人分支，尚未推送。
    • 需要整理提交历史。
    • 同步主分支的最新更改。

  • 不适合：

    • 多人协作的公共分支。
    • 不想改变历史的情况。

    #当前分支A
    git rebase [分支名B]    #移动分支到该分支后
    git checkout 分支名B
    git rebase 分支A  	#把原分支的引用往前移动

变基需要处理冲突的话，解决冲突后 git add， rebase 不适合所有场景，尤其是在多人协作或已推送的分支上。

cherry-pick

挑选；挑选特定的提交来操作

基本概念

• 作用：将指定的提交（一个或多个）应用到当前分支。
• 工作原理：Git 会提取目标提交的更改（diff），然后在当前分支创建一个新的提交，保留原提交的作者信息和消息（除非手动修改）。
• 适用场景：
  • 从一个分支提取特定更改，而不需要合并整个分支。
  • 修复错误或将特性移植到其他分支。
  • 在开发中临时复用某些提交。

git cherry-pick <commit-hash> #应用用指定提交记录


#将 main 中超前的提交应用到其他分支。
git cherry-pick upstream/main..main

实例：

#现有分支提交记录
# A --- B --- C  (main)
#       \
#        D --- E  (feature)

#执行：
git checkout main
git cherry-pick E

#结果：把feature分支的E提交记录应用到main分支
# A --- B --- C --- E'  (main)
#       \
#        D --- E  (feature)

#E' 是 E 的副本，应用到 main 上，提交消息和更改内容相同，但哈希值不同。

merge、rebase、cherry-pick 的对比

操作	git cherry-pick	git merge	git rebase
粒度	单个或多个指定提交	整个分支	整个分支
历史	创建新提交	创建合并提交或快进	重写历史，保持线性
灵活性	高（选择性强）	中（全分支合并）	高（调整历史）
用途	移植特定更改	整合分支	整理提交历史

解决冲突

冲突合并有三种方式。合并（merge）、变基（rebase），只接受快进（fast-forward）。

配置命令	作用
git config pull.rebase false	默认用 merge（合并提交，保留历史）
git config pull.rebase true	默认用 rebase（变基，历史更线性）
git config pull.ff only	只允许 fast-forward（不能合并就失败）

未写完的代码(add、暂存(staged))

# 获取提示：
error: Your local changes to the following files would be overwritten by merge:
	...
Please commit your changes or stash them before you merge.
Aborting

解决办法： 使用 stash

git stash -u #贮藏  stash不会保存为跟踪的文件(untracked,未add的) 所以建议加上-u(包含未跟踪)
git pull
git stash apply/pop #应用贮藏

# 解决冲突..
# 提交

已 commit

直接获取，解决冲突即可。(git 会将远程仓库的内容与根底 commit 合并,有冲突才需要解决)

git pull

# 解决冲突..
# 提交

需要注意这种合并方式，会多出来一个提交记录！

可以使用 rebase 或者 git pull --rebase 来处理，让提交记录变得线性，但是会丢失提交记录。（根据自己的需求来决定使用哪个）

git pull --rebase

# 解决冲突

git add .
git rebase --continue

# 提交

冲突解决合并：

• 有冲突的文件是需要合并的，但是 git bash 窗口不方便，需要设置一个默认的冲突合并工具

# 设置vscode
git config --global merge.tool vscode
git config --global mergetool.vscode.cmd  'code --wait $MERGED'


# 设置vs2022
# 差异工具
git config --global diff.tool vs2022
# 合并工具
git config --global merge.tool vs2022

• 或者直接 vs2022 打开项目 合并更顺手

日志 [log]

git log -n 5 #显示最近4次提交
	--oneline #单行形式显示
	--pretty="%h-%an : %s"
	--grep="搜索内容"
	--reverse 反转排序
	--stat 查看提交历史并显示每次提交所修改的文件及统计信息 （增加了多少行、删除了多少行）

# ..   ...  交集并集
#..显示2个分支的提交差异 dev相对master的差异 一般显示dev超前的分支
#B-A的共同部分
git log master..dev --oneline
git log master...dev --oneline # 显示互相之间的差异

Git子模块 [git submodule]

Git 提供的一种机制，用于在一个 Git 仓库中嵌套引用另一个独立的 Git 仓库。它允许你将外部仓库作为子目录包含在主项目中，同时保持两个仓库的版本历史完全独立。

场景	示例
依赖外部库	你的项目依赖一个第三方库，但不想复制代码。
多仓库共享代码	多个项目共享一个公共模块，各自引用固定版本。
主项目不维护子模块代码	子模块由其他团队维护，主项目只使用它。

git submodule add <仓库地址>
git submodule init
git submodule update
git clone --recursive <仓库地址>
git submodule update --remote

使用复杂，管理麻烦

范围操作符 [..][...]

.. 单向

• 语法：git log A..B
  • 含义：从 A 到 B 的单向差异，等价于 B 减去 A 的共同部分
• 数学类比：
  • 如果把提交看作集合，A..B ≈ B-(A∩B)。
• 注意：.. 不包括 A 和 B 的共同祖先提交。

... 双向

同上

实际用途

• git log upstream/main..main：
  • 检查本地 main 是否有额外提交（例如你在 fork 上改动了代码）。
  • 如果输出为空，说明本地 main 没有超前于 upstream/main 的提交。
• git log main..upstream/main：
  • 检查 upstream/main 是否有新提交（即本地 main 是否落后）。
  • 如果输出为空，说明本地 main 包含了 upstream/main 的所有提交。

与其他命令结合

• git diff upstream/main..main：
  • 显示本地 main 相对于 upstream/main 的代码差异。
• git cherry-pick upstream/main..main：
  • 将 main 中超前的提交应用到其他分支。

---

同步

fork 了别人的仓库后，原作者又更新了仓库，将自己的代码和原仓库保持一致

• 步骤

    # 1.添加fork仓库地址
    git remote add upstream https://github.com/.....git
    # 添加完成后查看 git remote -v
    # https:github.com/vue-admin-beautiful/admin-plus.git
  
    # 2.fetch branches and commit points, pull to the local repository upstream/branch
    git fetch upstream
  
    # 3. Switch to the main branch to merge remote content
    git switch [branch]
    git merge upstream/branch
  
    # 4. It is recommended to delete the stream commit point
  
    ...

PR

• Fork到自己仓库
• clone自己仓库到本地
• 开发修改测试
• 提交
• 到自己仓库 pull request
• 等待审核合并

Git updates

git update-git-for-windows

问题记录

Frequently Asked Questions

• pre-receive hook declined

  Without commit permissions, generally mater is protected, developer cannot submit by default Administrator needs to set permissions 'Protected branches'

  You can create a readme in master and then push -f

• Clone 10054 Try switching http to git

• bash @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

  The reason is that the IP address such as the server has not changed, so the token and IP correspondence cannot be verified Solution: Delete the corresponding IP in .ssh/known_hosts

git bash 中文

git bash 中 ls 中文不会乱码，但是 git status 中文就乱码

原因是 在默认设置下，中文文件名在工作区状态输出，中文名不能正确显示，而是显示为八进制的字符编码。 解决办法：选项 - 文本 - 本地 Locale - 选 zh_CNgit config --global core.quotepath false

更新记录

git switch (2019 年, Git 2.23+)

干啥的？ 专治切换分支！取代了部分 git checkout 的功能。

git switch other-branch: 干净利落地切换分支。

git switch -: 瞬间切回上一个分支，跟 cd - 一样方便。

git switch remote-branch: 直接切换到远程分支并自动跟踪。

关键优势：

比万能的 git checkout 更专注、更安全！它会进行额外的检查，比如如果切换会导致本地未提交的改动丢失，它会中止操作，避免误操作悲剧。再也不用担心 checkout 的迷惑行为了。

git restore (2019 年, Git 2.23+)

干啥的？ 专门负责恢复文件状态！分担了 git checkout 和 git reset 的部分职责。

git restore --staged some-file.py: 把暂存区的文件撤回来（取消 add ），

等效 git reset HEAD some-file.py 。

git restore --staged --worktree some-file.py: 不仅取消暂存，还直接丢弃工作区的修改（⚠️ 慎重），

等效 git checkout -- some-file.py 。

git restore --source HEAD~2 some-file.py: 直接把文件恢复到前两次提交时的版本。

关键优势：

语义更清晰！命令名字 restore 就告诉你它在“恢复”东西。不再需要死记硬背 checkout 和 reset 在各种场景下的复杂参数组合，职责分离，不易出错。

git sparse-checkout (2020 年, Git 2.25+)

干啥的？

解救深陷超大 Monorepo 的开发者！只检出你需要的部分目录/文件。

克隆时跳过初始检出：git clone --no-checkout repo-url

初始化稀疏检出配置（锥形模式）：git sparse-checkout init --cone (初始只检出根目录)

检出特定目录：git sparse-checkout set service/common

git checkout main 后，神奇的事情发生了：只有你设置的部分目录/文件出现在工作区！

关键优势：

本地开发：git status, checkout 等命令快如闪电！尤其适合微服务架构的庞大仓库。

CI/CD： 大幅提升流水线效率！只拉取构建部署所需的部分代码，省时省资源。简直救命神器。

git worktree (2018 年)

干啥的？

让你在同一个仓库的不同目录下，同时并行处理多个分支！

假设你在 dev 分支开发，突然要紧急修复 master 的线上 Bug 。 无需 stash 或提交半成品：

git worktree add -b hotfix ./hotfix master

瞬间在 ./hotfix 子目录得到一个干净的 hotfix 分支工作副本（基于 master ）。 进去修改、测试、提交、推送一气呵成。 搞定后，回到原目录继续 dev 分支的开发。

查看所有工作树：git worktree list

关键优势： 完美解决多任务切换痛点！告别分支来回切换的麻烦和干扰，实现真正的并行开发。

1. git bisect (虽不新，但强力安利！)

干啥的？ 二分查找神器！帮你精准定位引入 Bug 的那个提交。

香在哪？ git bisect start: 开始二分查找。

git bisect bad HEAD: 标记当前提交（或已知的坏提交）是坏的。

git bisect good v1.0: 标记一个已知的好提交（比如上一个稳定版本标签）。

Git 会自动切到一个中间提交，你需要测试这个提交是好是坏：

坏的输入 git bisect bad

好的输入 git bisect good

重复步骤 4 ，Git 会自动缩小范围，直到定位到第一个引入 Bug 的提交。

git bisect reset: 结束查找，回到起点。

关键优势： 面对茫茫提交历史，手动排查 Bug 来源无异于大海捞针。bisect 用算法帮你快速缩小范围，精准打击罪魁祸首，调试效率暴增。强烈建议每个开发者都掌握。

下一页Git原理