# Git 命令集

![Git flow](https://1690334719-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGN1m49kw1BIzqYjDOx%2Fuploads%2Fgit-blob-40690c41608e671276244f2483d8123dae4c78db%2Fgit-tool.png?alt=media)

## Git 指令使用手册

### 常用指令

#### 初始化一个空的 Git 仓库 demo

```shell
mkdir demo
cd demo
git init
```

```shell
# 1. global user
git config --global user.name "xxxx"
git config --global user.email "xxxxx@xxxx.com"
# 2. create new repo
# 2.1 在命令行上创建一个新的存储库
git clone https://xxxxx.git
cd [project-name]
touch README.md
git add README.md
git commit -m "add README"
git push -u origin master
# 2.2 从命令行推送现有空的存储库
cd existing_folder
git init
git remote add origin https://xxxxxx.git
git add .
git commit -m "Initial commit"
git push -u origin master
# 2.3 命令行推送已有存储库
cd existing_repo
git remote set-url origin https://xxxxx.git
git push --all https://xxxx.git
```

#### 克隆项目基本操作

```shell
# 克隆 HTTPS
git clone https://github.com/gyx8899/YX-JS-ToolKit.git
    # 克隆并更改“YX-JS-ToolKit”默认文件夹名为 newProjectName
    git clone https://github.com/gyx8899/YX-JS-ToolKit.git newProjectName
cd YX-JS-ToolKit

# 查看本地仓库内容状态
git status
    # s-short b-branch
    git status -sb

# 查看本地仓库提交记录
git log
    # 查看详细历史 -p  -patch
    git log -p
    # 查看简要统计
    git log --stat
    # 查看单行日志信息
    git log --pretty=oneline
    9fceb02d0ae598e95dc970b74767f19372d61af8 updated rakefile
    # 查看单行日志信息（哈希值前7位）
    git log --oneline
    9fceb02 updated rakefile
    # 在所有提交日志中搜索包含「homepage」的提交
    git log --all --grep='homepage'
    # 获取某人的提交日志
    git log --author="Maxence"

# 获取所有操作历史
git reflog

# 查看当前 commit
git show
    # 查看任意一个 commit: branch 或 HEAD 标记 或 SHA-1 码
    git show 5e68b0d8
    # 查看指定 commit 中的指定文件
    git show 5e68b0d8 shopping\ list.txt

# 添加工作区改动文件到 Stage (暂存区)
git add A.txt
git stage A.txt
    # 添加工作区所有改动文件到 Stage（暂存区）
    git add .
    # 将所有修改过的文件加入 Stage
    git add -u
    # 将本地删除文件、新增文件都提交到 Stage
    git add -a
    # 可以对一个文件内的修改选择性的添加 Stage
    git add -p

# 提交工作区改动到本地仓库（代码库）
git commit
    # 0. 进入 Comment 添加模式
    # 1. 点击键盘键 i
    # 2. 输入改动 Comment 注解
    # 3. 点击键盘键 Esc
    # 4. 鼠标点击 cmd 区域，将焦点重新聚焦 cmd
    # 5.1 dos 模式 - Shift + Z, Shift + Z, 两次退出 Comment 编辑模式
    # 5.2 vim 模式 - 1. ESC, 2. :set noreadonly 3. :wq  (root 权限 :wq!)

    # 1. 简化 commit 的命令 -m
    git commit -m "Comment text"
    # 2. 简化多行 commit 的命令 -m, 两种方式：
    git commit -m "commit title" -m "commit description"
    git commit -m "commit title
    >
    > commit description"

# 推送本地仓库改动到远程仓库（代码库）
git push
    # 推送本地仓库改动到远程 origin 仓库的 feature1 分支
    git push origin feature1

# 只需要再输入一次密码， Git 就会把你的密码保存下来，之后不用输入了
git config credential.helper store

# 从中央仓库拉取最新文件到本地仓库
git pull
        # git pull 等于 fetch 和 merge 两条命令
        git fetch
        git merge FETCH_HEAD
    # + rebase
    git pull --rebase

# 对比工作区和暂存区
git diff
    # 对比工作区和上一条版本库提交
    git diff HEAD
    # 对比暂存区和上一条版本库提交
    git diff --staged

# commit [type]
# 1. feat: 新功能
# 2. fix: 修复 bug
# 3. chore: 构建过程或辅助工具的变动
# 4. style: 根式（不影响代码于行的变动）
# 5. refactor: 重构
# 6. test: 增加测试
# 7. docs: 文档
git commit -m "[type]: xxxxx"
```

#### 分支操作

```shell
## 创建分支
git branch_name
    # 切换分支
    git checkout branch_name
    # 创建并切到分支
    git checkout -b branch_name
    # 跳到之前的分支
    git checkout -
    # 删除分支
    git branch -d branch_name
    # 查看分支 (a: all, r: remote, show-branch: and commits)
    git branch -a
    git branch -r
git show-branch

## 合并分支: 分支仓库 branchA 合并 master 的内容
# 1. 拉取最新的 master；
git checkout master
git pull
# 2. 切到本地仓库合并 feature1
git checkout branchA
git merge master
  # 1. 冲突时，解决冲突文件
  git add conflict_file.txt
  git commit
  # 2. 冲突时，放弃合并
  git merge --abort

# 3. 先把 branch 的基准更新到 master 的最新，再把 branch 上的提交记录，再在最新位置上重新提交
git checkout branch1
git rebase master
# 再把 branch1 合并到 master
git checkout master
git merge branch1

# 上传本地创建的分支到远程仓库
git push --set-upstream origin branch1

# 合并 remote template/master
    # 1. 添加 remote template
    git remote add template https://github.com/gyx8899/npm-template.git
    # 2. 拉取 master, template, branches 所有远端的最新文件到本地
    git fetch --all
    # 3. 合并 template 的 master 到本地仓库
    git merge template/master --allow-unrelated-histories
    # 4. 处理冲突

# 分支 A 重设指向远程分支 B
    # 1. 查看分支 B 上的日志，找到最新的 log commit hash
    git checkout B
    git log
    # 2. 回到分支本地 A，更改头部指向
    git checkout A
    git reset --hard [B hash]
    git reset --hard origin/B
    git push --force
...
```

#### Feature branching 工作流 - 方式1-靠吼

```shell
## User A
git checkout -b feature2
git add .
git commit
git push origin feature2

## User B 查看后说通过
git pull
git checkout feature2

## User A
git checkout master
git pull
git merge feature2
git push
git branch -d feature2
# 上面两行等价下面一行
git push origin -d feature2

```

#### Feature branching 工作流 - 方式2 - Pull Request

```shell
# 用这一次新的commit, 合并上一次 commit。进而达到修复上一次 commit 的 comment 内容
git add .
git commit --amend
git commit --amend --only   # 打开编辑器，编辑新的提交信息，针对已经 commit 但未 push 的提交
git commit --amend --only -m '新的 comment 内容'  # 针对已经 commit 但未 push 的提交

# rebase --interactive 的缩写，交互式 rebase，
git rebase -i HEAD^^
git rebase -i HEAD~5
# 继续 rebase, 把后面的 commit 应用上去。
git rebase --continue
```

> 说明：在 Git 中，有两个「偏移符号」： ^ 和 \~。
>
> ^ 的用法：在 commit 的后面加一个或多个 ^ 号，可以把 commit 往回偏移，偏移的数量是 ^ 的数量。例如：master^ 表示 master 指向的 commit 之前的那个 commit； HEAD^^ 表示 HEAD 所指向的 commit 往前数两个 commit。
>
> \~ 的用法：在 commit 的后面加上 \~ 号和一个数，可以把 commit 往回偏移，偏移的数量是 \~ 号后面的数。例如：HEAD\~5 表示 HEAD 指向的 commit往前数 5 个 commit。
>
> Rebase 816f737..b13037a onto 816f737 (1 command)
>
> Commands: p, pick = use commit r, reword = use commit, but edit the commit message e, edit = use commit, but stop for amending s, squash = use commit, but meld into previous commit f, fixup = like "squash", but discard this commit's log message x, exec = run command (the rest of the line) using shell d, drop = remove commit
>
> These lines can be re-ordered; they are executed from top to bottom.
>
> If you remove a line here THAT COMMIT WILL BE LOST.
>
> However, if you remove everything, the rebase will be aborted.
>
> Note that empty commits are commented out

#### 撤销commit

```shell
# ^在 windows (terminal) 中是特殊字符，使用时加上引号："^"
# 撤销前某一次提交, 把编辑区域中想删掉的那一次 commit comment 删掉即可。
git rebase -i HEAD^   #撤销最后1次
git reset -i HEAD"^"  #For windows
git reset -i "HEAD^"  #For windows

git rebase -i HEAD^^  #撤销最后2次
git rebase -i HEAD~5  #撤销最后5次
# 丢弃上一次提交 --hard
git reset --hard "HEAD^"   # Add quote for windows
git push --force origin master
# 以倒数第二个 commit 为起点（起点不包含在 rebase 序列里哟），branch1 为终点，rebase 到倒数第三个 commit 上。
git rebase --onto HEAD^^ HEAD^ branch1
# 撤销本地分支上的所有提交
git reset --hard origin/<branch-name>

# 强制推送到 remote
git push -f
```

#### 撤销已在中央仓库的 branch 的 commit

```shell
# 先在本地仓库 branch 使用上面的 撤销 commit, 再强制提交到 branch。--force, 忽略冲突强制 push
git push origin branch1 -f
```

#### 撤销已在中央仓库的 master 的 commit, 只是新增一条 revert commit

```shell
# 撤销 commit
git revert HEAD^
```

> 如果出错内容在私有 branch：在本地把内容修正后，强制 push (push -f）一次就可以解决；
>
> 如果出错内容在 master：不要强制 push，而要用 revert 把写错的 commit 撤销。

#### 重置回退

```shell
# 重置回退并保留工作目录的内容，并清空暂存区。
git reset HEAD^
    git reset CommitHashValue
    # 重置回退并清空工作目录的所有改动
    git reset --hard "HEAD^"   // Add quote for windows
    git reset --hard CommitHashValue
    # 重置回退并保留工作目录和暂存区的内容，并把重置 HEAD 的位置所导致的新的文件差异放进暂存区
    git reset --soft HEAD^
    git reset --soft CommitHashValue
    # 重置到相应提交
    git reset HEAD@{4}
    # ……或者……
    git reset --hard <提交的哈希值>
```

> \--hard：重置位置的同时，清空工作目录的所有改动；
>
> \--soft（常用）：重置位置的同时，保留工作目录和暂存区的内容，并把重置 HEAD 的位置所导致的新的文件差异放进暂存区。
>
> \--mixed（默认）：重置位置的同时，保留工作目录的内容，并清空暂存区。

#### Checkout

```shell
git checkout HEAD^^
git checkout master~5
git checkout 78a4bc
git checkout 78a4bc^
# 用来只让 HEAD 和 branch 脱离而不移动 HEAD 的用法
git checkout --detach
```

#### Stash(暂存区): 临时存放工作目录的改动

```shell
# 将工作区的改动保存到暂存区，工作区还原至上次commit
git stash
# 没有被 track 的文件（即从来没有被 add 过的文件不会被 stash 起来，因为 Git 会忽略它们。如果想把这些文件也一起 stash，可以加上 `-u` 参数，它是 `--include-untracked` 的简写。
git stash -u
# 显示之前 stash 的所有记录
git stash list
# 清空 git stash
git stash clear
# 读取并恢复上次暂存的代码改动, apply 方式：只应用不删除，pop 方式：应用且删除
git stash apply
git stash pop
# 给 stash 加上注释名
git stash save "fix:xxxxx"
# 应用指定的 stash
git stash list
stash@{0}: On master: fix:xxxxx
stash@{1}: On new_branch: feat:xxxxx
stash@{2}: On new_branch: doc:xxxxx
git stash pop stash@\{1\}
# 删除(丢弃）stash@{1}
git stash drop 1
# 查看 stash@{2}
git stash show 2
# 应用 stash@{2}
git stash apply 2
```

#### 重建已删除的 branch1

```shell
# 从 log 中查找已删除 branch1 的 SHA-1
git reflog
git checkout c08de9a
git checkout -b branch1

# 查看某个 branch 上的移动历史
git reflog master
```

#### tag

```shell
# 查看 History 中已有的 tag
git tag
v0.1
v1.3

# 查看特定模式的 tag
git tag -l 'v1.8.5*'
v1.8.5
v1.8.5-rc0   # rc = Release Candidate
v1.8.5-rc1
v1.8.5.1
v1.8.5.2

# 两种标签：轻量标签（简单 - lightweight）和附注标签（详细 - annotated）
# 轻量标签
git tag v1.4.0
# 附注标签
git tag -a v1.4.1 -m "my version v1.4.1"

# 查看具体标签信息
git show v1.4.1

# 某次提交忘记打标签，后期补打标签
# 1. 查找提交记录
git log --oneline
9fceb02 updated rakefile
# 2. 补打标签 + 校验和（或部分校验和）
git tag -a v1.4.2 9fceb02

# 共享标签，即推送标签到远程仓库
git push origin v1.4.2   # 推送指定的标签
git push origin --tags   # 推送所有本地的标签

# 删除本地标签
git tag -d v1.4.1
# 将删除的本地标签，推送到远程仓库
git push origin :refs/tags/v1.4.1

# checkout 分支到指定 tag
git checkout -b version2 v2.0.0
```

#### cherry-pick

```shell
git cherry-pick [--edit] [-n] [-m parent-number] [-s] [-x] [--ff] [-S[<keyid>]] <commit>…​
git cherry-pick (--continue | --skip | --abort | --quit)

# 取另一个分支的一个提交记录id，在本分支上重新提交
git cherry-pick <commit id>
# 取另一个分支的一个提交记录id，在本分支上重新提交并保留原分支的提交信息
git cherry-pick -x <commit id>
# 取另一个分支的一段区间(左开右闭（])提交记录，在本分支上重新提交
git cherry-pick <start-commit-id>..<end-commit-id>
# 取另一个分支的一段区间(左闭右闭[])提交记录，在本分支上重新提交
git cherry-pick <start-commit-id>^..<end-commit-id>
# 也可以用在同一个分支上，场景为某次提交删除了，需要重新提交，可以使用 cherry-pick
```

#### patch: 对已有的 commit 记录生成补丁，并应用补丁

```bash
# 1. 生成
git format-patch [hash]
git format-patch [hash-A]...[hash-B] -o [~/../path]

# 2. 检查patch
git apply --state [~/../xxxx.patch]
# 3. 能否应用成功
git apply --check [~/../xxxx.patch]

# 4. 应用patch
git am [~/../xxxx.patch]
```

#### Pull changes from a template repository

```shell
# 1. Remove/Add this template repository as a remote
git remote rm upstream
# git remote add template [URL of the template repo]
git remote add template https://github.com/gyx8899/npm-template.git

# 2. Update the remote changes
git fetch --all

# 3. Merge another branch from the new remote to your current one
# git merge template/[branch to merge] --allow-unrelated-histories
git merge template/master --allow-unrelated-histories
```

#### HEAD (\*)

```shell
# 强制把 master 指向分支 bugFix / bugFix parent / bugFix grand parent commit
git branch -f master bugFix
git branch -f master bugFix^
git branch -f master bugFix~2
# 强制把 bugFix 指向分支 bugFix parent / bugFix grand parent commit
git branch -f bugFix bugFix^
git branch -f bugFix bugFix~2

# HEAD (*) 指向分支 bugFix
git checkout bugFix
git checkout bugFix^
git checkout bugFix~2
# HEAD (*) 指向 hash 值 C1 (C1 只是个指代，真实 hash 值很长)
git checkout C1
# HEAD (*) 重新指向 master
git checkout master
```

#### 更改远程仓库 URL

```shell
# 更改
git remote set-url origin https://github.com/USERNAME/REPOSITORY.git
# 查看
git remote -v
# 移除 upstream
git remote rm upstream
```

#### git config

```shell
# 查看
git config list
# registry
git config set registry http://registry.npmjs.org
git config set registry https://registry.npm.taobao.org
git config get registry
git config delete registry
## 示例：指定安装源
npm i daybyday/yx-node --registry=https://registry.npm.taobao.org
## 或者使用 nrm 管理 registry：https://www.npmjs.com/package/nrm
npm i -g nrm
nrm ls
  npm -------- https://registry.npmjs.org/
  yarn ------- https://registry.yarnpkg.com/
  cnpm ------- http://r.cnpmjs.org/
  taobao ----- https://registry.npm.taobao.org/
  nj --------- https://registry.nodejitsu.com/
  npmMirror -- https://skimdb.npmjs.com/registry/
  edunpm ----- http://registry.enpmjs.org/
```

### Learn Git Branching - 速查

#### Git Remotes

**Push & Pull**

```shell
# 1. Clone Intro
git clone

# 2. Remote Branches: git checkout <remote name>/<branch name>
git checkout o/master

# 3. Git Fetchin
git fetch

git fetch remotename
# 获取远程仓库的更新

# 4. Git Pullin
git pull
# ===
git fetch; git merge master

# 5. Faking teamwork: branch, commit count
git fakeTeamwork
git fakeTeamwork foo 3

## 克隆分支，增加两条提交记录，提交并拉取及合并代码
git clone
git fakeTeamwork 2
git commit
git pull

# 6. Git Pushin
git push

# 7. Deverged History
git fetch; git rebase master; git push;
git pull --rebase; git push;

git fetch; git merge master; git push;
git pull; git push

# 8. Locked Master: 推送改动到远程分支
git checkout -b branch1
git push

# 9. 将在线更新与您的本地工作进行合并
git merge remotename/branchname

# git pull 是在同一个命令中完成 git fetch 和 git merge 的便捷方式。
# 获取在线更新并将其与您的本地工作进行合并
$ git pull remotename branchname

```

**To Origin And Beyond**

```shell
# 1. Push master
git fetch
## 以 o/master 为 base, 把 side1 分支移动到 o/master 上
git rebase o/master side1
git rebase side1 side2
git rebase side2 side3
git rebase side3 master
git push

# 2. Merge with remotes
git checkout master
git pull origin master
git merge side1
git merge side2
git merge side3
git push origin master

# 3. Remote tracking
git checkout -b side o/master
git commit
git pull --rebase
git push

# 4. Git push arguments
## 把本地 master 推送到远程仓库
git push origin master
## 把本地 foo 推送到远程仓库
git push origin foo

# 5. Git push arguments -- Expended
## 把分支 foo 推送到远程仓库 master 上
git push origin foo:master
## 把本地 master 的前一条提交到远程仓库的 foo 分支上
git push origin master^:foo

# 6. Fetch arguments
git fetch origin master^:foo
git fetch origin foo:master
git checkout foo
git merge master

git pull origin master^:foo
git pull origin foo:master
git branch -f foo
git checkout foo

# 7. Source of nothing
## 删除远程仓库上的 bar 分支（提交空内容到远程仓库分支）
git push origin :foo
## 拉取远程仓库并创建 abc 分支
git fetch origin :abc

# 8. Pull arguments
## 拉取远程仓库 bar 分支到本地，并基于 bar 新建分支 foo, 然后合并 foo 分支
git pull origin bar:foo
## 拉取远程仓库 master 到本地，并基于 master 新建分支 side, 然后合并 side 分支
git pull origin master:side

```

#### Branch

**Delete local branch**

```shell
# 先查看本地分支
git branch -a
# 删除本地分支
git branch -d <branch-name>

# 有一些分支有未 merge 的该动，需要使用 -D 删除
git branch -D <branch-name>
```

**Delete remote branch**

```shell
git push orign --delete <branch-name>
```

#### Git Subtree

```shell
git subtree add   --prefix=<prefix> <commit>
git subtree add   --prefix=<prefix> <repository> <ref>
git subtree pull  --prefix=<prefix> <repository> <ref>
git subtree push  --prefix=<prefix> <repository> <ref>
git subtree merge --prefix=<prefix> <commit>
git subtree split --prefix=<prefix> [OPTIONS] [<commit>]

git subtree add --prefix=[relativePath] [repoUrl] [master/main] // --squash
```

#### 迁移仓库

* 在新的 Git 仓库上新建项目xxx;
* 单独克隆一下旧仓库地址，包含所有提交记录

```shell
git clone --bare xxx.git
```

* 推送到新的仓库地址

```shell
git push --mirror xxx.git
```

* 切换旧项目的 remote url

```shell
git branch -r
git remote -v
git remote set-url origin xxx.git
```

#### 提交信息类别

`git commit -m "fix: xxxxxxxx"`

```shell
feat：     新功能（feature）
fix：      修补bug
docs：     文档（documentation）
style：    格式（不影响代码运行的变动）
refactor： 重构（即不是新增功能，也不是修改bug的代码变动）
test：     增加测试
chore：    构建过程或辅助工具的变动
```

### Questions: 常见问题

* SSL\_read: SSL\_ERROR\_SYSCALL, errno 10054

```shell
YX-JS-ToolKit\\docs>git push
fatal: unable to access 'https://github.com/gyx8899/YX-JS-ToolKit.git/': Op
enSSL SSL_read: SSL_ERROR_SYSCALL, errno 10054
```

```shell
git config http.sslVerify "false"
git config --global http.sslVerify "false"
git push
Username:
Password:
```

* OpenSSL SSL\_read: Connection was reset, errno 10054

```shell
git clone https://github.com/gyx8899/yx-js.git
# fatal: unable to access 'https://github.com/gyx8899/yx-js.git/': OpenSSL SSL_read: Connection was reset, errno 10054
```

Solutions:

* Couldn't connect Github on your network, need use VPN;
* Update DNS cache;
  * Mac: sudo killall -HUP mDNSResponder sudo dscacheutil -flushcache
  * Windows: ipconfig /flushdns
* remote: HTTP Basic: Access denied fatal: Authentication failed for 'Your remove url'

```shell
# 方案1（来自网络）
git config --system --unset credential.helper
# 方案2（来自网络）
git config --global http.emptyAuth true
```

> 方案3 情况：第一次输入账号密码错误后，或者 git 账号更新了密码， 或者 Git 管理员强制用户更新密码； 方案3 方法：到”控制面板 \ 用户帐户 \ 凭据管理器 \ Windows凭据”下找到对应 git 的凭据，1. 直接修改凭据里的账号密码； 2. 删除凭据，然后继续尝试 git clone 命令，会重新提示输入用户名和密码；

* Github, Gitlab, Gitee, 多账号管理 - 提交时的用户选择

```shell
# 设置全局账号
git config --global user.name "Steper Kuo @github"
git config --global user.email "gyx8899@126.com"
# 设置局部账号, 需要在每个 gitlab 项目下都设置一次
git config --local user.name "Steper Kuo @gitlab"
git config --local user.email "gyx8899@126.com"
# 设置局部账号, 需要在每个 gitee 项目下都设置一次
git config --local user.name "Steper Kuo @gitee"
git config --local user.email "gyx8899@126.com"
```

* Could not merge origin/master: You have not concluded your merge (MERGE\_HEAD exists). Please, commit your changes before you merge.

```shell
# 方案：保留本地。终止合并 -》 重新合并 -》 重新拉取
git merge --abort
git reset --merge
git pull
```

* Committing is not possible because you have unmerged files.

```shell
git status
# After merge, still can't submit, check your git status
cd unmerged files folder
git add .
git add [file]

git commit -m "message"
git push
```

* Your local changes to the following files would be overwritten by merge: Please commit your changes or stash them before you merge.

```shell
git stash
git pull origin master  #== git fetch + get merge
git stash pop
```

* `git merge master` fatal: refusing to merge unrelated histories

```shell
git merge master --allow-unrelated-histories
# 同理 git pull/push same fatal
git pull origin master --allow-unrelated-histories
```

* Warning: LF will be replaced by CRLF

```shell
git config --global core.autocrlf false
```

* npm install: Error: Can't find Python executable "python", you can set the PYTHON env variable

```shell
# For windows: run below script with Administrator authority
npm install --global --production windows-build-tools
```

* 分支 Merge 后仍然提示：有未合并文件

> commit is not possible because you have unmerged files

```shell
# 合并后有新增文件，未被添加到仓库里，需要命令添加
git add .
```

* Rebasing master with "git pull --rebase"

```shell
> git pull --rebase
You are not currently on a branch.
Please specify which branch you want to rebase against.
See git-pull(1) for details.

    git pull <remote> <branch>
```

```shell
git rebase --abort
git pull --rebase
```

* git pull - error: You have not concluded your merge (MERGE\_HEAD exists).

> hint: Please, commit your changes before merging. fatal: Exiting because of unfinished merge.

```shell
# 发生冲突，解决 merge 问题
git reset --hard
git pull
```

* Please move or remove them before you switch branches. Aborting fatal: Could not detach HEAD First, rewinding head to replay your work on top of it

> 手动删除或添加哪些未被添加到 git 的本地文件，然后再 `git pull`。

* Squash commits in git after they have been pushed?

Such as squash last 4 commits in remote master

```sheel
# 1. Solution on master
git rebase -i origin/master~4 master
git push origin +master
```

```shell
# 2. Solution on branch
git checkout my_branch
git reset --soft HEAD~4
git commit
git push --force origin my_branch
```

* Failed to connect to github.com port 443: Timed out

> fatal: unable to access '<https://github.com/gyx8899/blog.git/>': Failed to connect to github.com port 443: Timed out

检查网络状态，发现并解决网络问题，或重连（启）网络连接，重新尝试 git 命令即可。

* Pull request 提交后， 如果 diff 文件被 revert 并提交，会导致 pull request 自动关闭

注意确保修改文件的改动在分支上，然后再建分支进行进一步测试。而不是直接在同一个分支或 Master 上修改提交，这会对当前的 pull request 造成影响，因为这些后续改动也会被包含在 pull request 中。

* "fatal: ambiguous argument 'HEAD" after "git reset --hard HEAD^" in windows

> ^在 windows (terminal) 中是特殊字符。

```shell
git reset --hard "HEAD^"
git reset --hard HEAD"^"
git reset --hard HEAD~1
```

* [Git 提交信息中的 Author 和 Committer 的差异](https://blog.darkthread.net/blog/git-author-n-committer/)：

> Git 的每个Commit 都有作者(Author)跟提交者(Committer)两种角色，每次新增修改删除档案并使用git commit 指令存成Commit，一开始Commit 的作者与提交者都是执行提交动作的操作人员(严格来说是user.name 跟user.email 所设定的身分)，而作者日期(AuthorDate)及提交日期(CommitDate)就是执行git commit 的时间。但如果Commit 经过再处理或操作，提交日期将会更新，而也可能出现提交者与作者不同的状况。造成作者/作者日期与提交者/提交日期不同的常见情境有：
>
> * 执行Rebase (包含git pull --rebase)
> * 执行Amend 修改Commit 讯息
> * 执行Cherry-Pick 搬动Commit
> * 产生更新档交付他人套用
>
> 总之，只要Git 操作导致Commit ID 改变，就必须更新提交者及提交日期，若操作者并非该Commit 的原始提交者，便会发生作者与提交者不同的状况。要观察提交日期与提交者，除使用Visual Studio、Source Tree、Git GUI 等GUI 工具，用git show --pretty=fuller commit\_id 亦可查看

* 修改 branch 的名字

```shell
# 修改本地 branch name
git branch -m <new_name>
# 将新的 branch push 到 remote
git push origin -u <new_name>
# 删除 remote old branch
git push origin --delete <old_name>
```

* 使用 git 命令中出现 - remote: Repository not found.

> fatal: repository '<https://github.com/xxxxxx/xxxxxx.git/>' not found

此处的情况有：

> 1. 提交另一个 github 账号下的仓库改动，但是这个仓库是私有的。而本地 git 记录的账号密码不是这个 github 账号。
> 2. fatal: unable to access '<https://github.com/[user-name>]/\[repo-name].git/': The requested URL returned error: 403

解决方法：

```shell
# 正常的 repo https url
https://github.com/gyx8899/blog.git
# (一步搞定)设置 remote，之后就会提示输入密码了，然后顺利提交
git remote set-url origin https://[user-name]@github.com/[user-name]/[repo-name].git
# 例子：
git remote set-url origin https://gyx8899@github.com/gyx8899/blog.git
```

* 一台电脑登录多个git 账户，如 github, gitlab
  1. Github: [生成新 SSH 密钥并添加到 ssh-agent - GitHub Docs](https://docs.github.com/cn/free-pro-team@latest/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)
  2. Github: [新增 SSH 密钥到 GitHub 帐户 - GitHub Docs](https://docs.github.com/cn/free-pro-team@latest/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account)
  3. 验证测试参考：[同一台电脑怎样配置并使用多个git账号\_冰河世纪-CSDN博客](https://blog.csdn.net/u010132177/article/details/104825446/)
* Git 提交的中文文件名乱码

> "\346\265\213\350\257\225.txt"

```shell
git config --global core.quotepath false
```

> [Git中文显示问题解决](http://xstarcd.github.io/wiki/shell/git_chinese.html)

* fatal: not a git repository (or any of the parent directories): .git

> git 命令只能在 git 目录中使用，执行：git init

* Failed to connect to github.com port 443:connection timed out

> git config --global --unset http.proxy
>
> git config --global --unset https.proxy

* You have unstaged changes.

```shell
error: cannot pull with rebase: You have unstaged changes.
error: additionally, your index contains uncommitted changes.
error: please commit or stash them.

Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        new file:   src/***/image.jpg
Changes not staged for commit:
  (use "git add/rm <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        deleted:    src/***/image.jpg
```

```shell
# cd to target folder, restore current folder's all unstaged files
git restore --staged .
```

* remote: Permission to gyx8899/blog.git (Owned by Git-User-A) denied to \[Git-User-B].

```shell
#fatal: unable to access 'https://github.com/gyx8899/blog.git/': The requested URL returned error: 403
1. Add Git-User-B to blog Reop contributer;
2. Remove user-b from computer; (控制面板–>用户–>证书管理–>系统证书)
3. Add A's SSH to B's github;
```

* npm install error: node-sass 3.13.1

> 参考 <https://blog.csdn.net/y_k_y/article/details/86535268> 文章中最后的方案，即 <https://github.com/pnp/sp-dev-fx-webparts/issues/501#issuecomment-389285371> 方案，以管理员权限安装 npm 包 - windows-build-tools，成功后重新 npm install。问题即可解决。
>
> 示例执行的命令：

```shell
npm install --global --production windows-build-tools
```

> 在 VS code 的 terminal 中执行（测试成功）

```shell
npm i -g windows-build-tools --vs2017
```

* npm install nrm error: internal/validators.js:124 throw new ERR\_INVALID\_ARG\_TYPE(name, ‘string’, value);

```shell
internal/validators.js:124
    throw new ERR_INVALID_ARG_TYPE(name, 'string', value);
    ^

[TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string. Received undefined
  at validateString (internal/validators.js:124:11)
  at Object.join (path.js:375:7)
  at Object.<anonymous> (C:\Users\xxxx\AppData\Roaming\npm\node_modules\nrm\cli.js:17:20)
  at Module._compile (internal/modules/cjs/loader.js:1063:30)
  at Object.Module._extensions..js (internal/modules/cjs/loader.js:1092:10)
  at Module.load (internal/modules/cjs/loader.js:928:32)
  at Function.Module._load (internal/modules/cjs/loader.js:769:14)
  at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:72:12)
  at internal/main/run_main_module.js:17:47
] {
  code: 'ERR_INVALID_ARG_TYPE'
}
```

```shell
# C:\Users\xxxx\AppData\Roaming\npm\node_modules\nrm\cli.js:17:20
# 修改 cli.js 第17行
## const NRMRC = path.join(process.env.HOME, '.nrmrc');
const NRMRC = path.join(process.env[(process.platform == 'win32') ? 'USERPROFILE' : 'HOME'], '.nrmrc');
```

* warning: LF will be replaced by CRLF

```shell
# 关闭自动 crlf
git config core.autocrlf false
```

* Your branch is based on 'origin/master', but the upstream is gone.

```shell
git branch --unset-upstream
```

* fatal: The current branch master has no upstream branch.

```shell
git push --set-upstream origin master
```

* error /node\_modules/node-sass: Command failed (npm install in New Mac)

情况之一：新电脑安装的 Node version 太高了，node-sass 不匹配，需要安装 nvm 使用低版本的 node

* fatal: '<https://github.com/gyx8899/blog.git/>' 鉴权失败

remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. remote: Please see <https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/> for more information.

[stackoverflow 方案](https://stackoverflow.com/questions/68775869/support-for-password-authentication-was-removed-please-use-a-personal-access-to)

```shell
# Developer's hack (shortcode):
git remote set-url origin https://<githubtoken>@github.com/<username>/<repositoryname>.git
# demo
git remote set-url origin https://<githubtoken>@github.com/gyx8899/blog.git

```

* Git: hint: You have divergent branches and need to specify how to reconcile them. 提交了本地代码未推送，同时 remote 有新改动未拉到本地，push 本地代码时报错提示

  warning: 不建议在没有为偏离分支指定合并策略时执行pull操作。您可以在执行下一次pull操作之前执行下面一条命令来抑制本消息：

  git config pull.rebase false # 合并（默认缺省策略）

  git config pull.rebase true # 变基

  git config pull.ff only # 仅快进

  您可以将 "git config" 替换为 "git config --global" 以便为所有仓库设置缺省的配置项。您也可以在每次执行 pull 命令时添加 --rebase --no-rebase，或者 --ff-only 参数覆盖缺省设置。

```shell
# 方法 1
git config pull.rebase false
# 方法 2: 查看本地提交记录，reset 到本地提交记录的前一条后，重新拉取代码，重新提交本地记录
git log -3
git reset --hard <HASH>
git pull
# 方法 3: 简单直接
git pull --rebase
git push
```

* Git 全局忽略文件

```shell
# Mac下配置Git 的全局忽略文件
$ git config --global core.excludesfile ~/.gitignore_global
 
$ vim ~/.gitignore_global
```

* Git 重置分支为 master

```shell
git reset --hard origin/master
git push --force
```

* Git 撤销 rebase 引起的变基

```shell
git rebase --abort
```

* Git merge 后 push 阶段提示校验不通过

```shell
# 撤销变基
git reset --hard HEAD^
# git rebase --abort
# push 忽略校验
git push --no-verify
```

## 练习

* [Learn Git Branching](https://learngitbranching.js.org/)

## 参考

* <https://git-scm.com/docs> Git - Reference