Git

## 影响根目录和全部子目录
# 忽略所有名为 __pycache__ 的目录
__pycache__/
# 忽略所有以 `~` 结尾的文件和目录
*~

## 影响根目录
# 忽略根目录下的 .pyc 后缀文件
/*.pyc

git update-index --assume-unchanged <PATH>
git update-index --no-assume-unchanged <PATH>

git ls-files -v		                    # 列出所有的文件，assume unchanged 的话有 "h"
git ls-files -v | grep '^[[:lower:]]'   # 列出 assume unchanged 文件

git clone -b dev xxx   # 只克隆 dev 分支
git clone --bare xxx   # 克隆一个裸库，用于迁移
git clone --depth n xxx   # 浅克隆，只含最近 n 次更新，可以缩小 git 文件大小

git commit --amend     # 修改最近一次 commit 信息

git checkout xxx       # 切换到 xxx 分支
git checkout -- a.txt  # 撤销本地对 a.txt 的修改
git checkout .         # 撤销本地的所有修改，使用本地仓库恢复文件
git checkout id        # 切换到某个 commit（可从此另开分支）
git checkout -b xxx origin/xxx   # 新建 xxx 分支，并设置为跟踪远程 xxx 分支

git branch              # 打印所有分支
git branch -a           # 打印远程跟踪分支和本地分支
git branch -d xxx       # 删除本地分支
git branch -m xxx       # 重命名本地分支
git branch xxx          # 创建 xxx 分支
git branch -vv          # 查看分支最新提交以及正在跟踪的远程分支

git branch -u origin/xx # 设置远程仓库上游分支为 xx
git branch --set-upstream-to=origin/dev dev  # 设置 dev 分支上游为 origin/dev

# 将远程仓库与本地代码同步

## 方法一
git fetch origin master   # 将远程 origin 的 master 分支下载到本地仓库
git log -p master origin/master      # 比较本地的仓库和远程参考的区别
git log --stat master origin/master  # 比较本地的仓库和远程参考的区别（简略版）
git merge origin/master       # 把远程下载下来的代码合并到本地仓库
                              # 的当前分支，远程的和本地的合并

## 方法二
git fetch origin master:temp  # 新建本地分支 temp 保存远程 master 分支
git diff temp                 # 比较当前本地分支和本地 temp 分支的不同
git merge temp                # 本地合并分支
git branch -d temp            # 删除本地 temp 分支


# 删掉远程仓库里已经删除掉，无法访问的分支
git fetch --prune
git remote prune origin

# 若未 commit 则不要 merge

git merge --no-ff develop   # 将 develop 分支合并到 master 分支
                            # --no-ff 表示不用 fast-foward merge，保留
                            # develop 分支的 commit 信息，文件指针不改变
                            # 如果不慎忘了就用 git reset --merge ORIG_HEAD 恢复到合并前
                            
git merge --abort           # 在冲突时放弃 merge，回到 merge 前的状态

git merge --allow-unrelated-histories	# 如果想鸠占鹊巢，在 merge 时需要加上这个

git merge -X theirs dev     # 合并 dev 到当前分支，有冲突的部分全部采用 dev 分支
                            # 适用于改了二进制资源的情况

git push origin --delete xxx            # 删除远程 xxx 分支
cd 裸库.git && git push --mirror xxx    # 镜像推送库，用于库迁移

git rebase             # 消掉 pull 远程仓库时产生的 merge log
git rebase -i HEAD~4   # 交互式合并近 4 个 commit，修改 pick 为 edit 来切换对应
                       # 历史分支，此时可以通过 git commit --ammend 来修改历史


# 将 pick 改为 edit 后可修改已 push 的 commit 信息
git rebase -i HEAD~4   # 展示出近 4 次 commit
                       #   edit 需要修改的 commit
                       #   squash 需要合并的 commit

git commit --amend     # 修改 commit 信息
git rebase --continue  # 完成 rebase 操作
# git push --force       # push 到远程仓库，需要分支 unprotected

git reset HEAD [-- files]   # 撤销 git add 暂存区文件，相当于 git add 反操作
git reset --soft id         # 本地仓库回退到 id 版本，id 之后提交的修改放到暂存区
                            # 相当于撤销 commit

git reset --hard id         # 将工作区、暂存区、本地仓库全部回退到 id 版本
git reset --hard HEAD       # 撤销修改（包括 merge），回退到最新提交

git reset --mixed id        # 默认模式，所有 id 后修改回退到工作区
                            # fatal: git-write-tree: error building 
                            #        trees Cannot save the current index

git reset --merge ORIG_HEAD  # 取消 merge？

# reset 后通过 git push -f 可以修改远程仓库的 commit
# 但需要先取消掉远程仓库的分支 protect

git revert id           # 撤销 commit id 的修改
                        # 与 git reset 不同，保留 commit 信息

git remote              # 打印远程仓库名（一般origin）
git remote -v           # 打印仓库名和对应地址（分开 fetch 和 push）

git remote add origin (ssl/https address)  # 初始化仓库时用到，添加远程仓库 

# pull 公用仓库，push 私人仓库时使用
git remote set-url origin (ssl/https address)  # 设置远程仓库地址
git remote set-url --push origin (ssl/https address)  # 设置push的远程仓库地址

git submodule add <url> <path>     # 添加子模块

git stash save "xxx"       # 会将当前未提交的修改（暂存区和工作区）保存起来到本地栈
                           # 并添加该栈的版本信息 "xxx"，不保存 untracked 文件
						   # 添加 `-u` 才可以保存 untracked
						   # 添加 `-a` 保存所有（包括 ignored）

git stash pop              # pop 出栈顶
git stash apply stash@{#}  # 恢复栈 stash@{#}

git stash list		       # 打印所有的栈，栈名格式为：stash@{#}

git stash show stash@{#}   # 打印栈修改的部分
git stash apply stash@{#}  # 恢复栈 stash@{#}
git stash drop stash@{#}   # 丢弃栈 stash@{#}

git stash branch xxx       # 使用新分支恢复，避免工作区多次修改导致的冲突

git clean -n        # 看看会删掉哪些未跟踪文件
git clean -f        # 删掉全部未跟踪文件

git tag -l               # 查看所有 tag
git tag v1.1.0           # 给当前打上 tag
git push origin v1.1.0   # 推送 tag 到远程仓库