git常用

一、克隆项目

最基础的， 应该都没问题。先找到克隆项目的地址，然后直接上指令：
git clone resource-address

二、remote

1. 说明

   • 用于对接当前项目和远程项目

2. 查看已有remote

   • 指令: git remote -v(不使用-v则只显示remote名称)

3. 添加remote

   • 指令: git remote add <remote name> <remote address>
   • 克隆项目后会默认创建remote，默认remote name 是origin，remote address是克隆时的resource-address
   • 也用于本地使用git init初始化仓库后对接远程仓库

4. 修改remote

   • 指令: git remote set-url <remote name> <remote address>或者删除remote后再添加remote git remote rm < remote name> ; git remote add <remote> <remote address>

5. 相关问题

   • 在项目中，主项目的某个子模块不与项目存放在同一个项目地址下，但开发中需要将其子模块放在主项目的某一目录下，设置步骤如下：
     a. 进入主项目中需要存放子模块的目录
     b. 克隆子模块: git clone address
     c. 进入子模块目录，删除原有的删除原有的主项目的remote: git remote rm <old remote>(也可以不删除，直接添加新的remote，但这样你要注意提交的时候有可能提交到主项目的远程仓库中去)
     d. 添加子模块的远程仓库地址: git remote add <new remote> <new remote address>(新的remote名称不要与主项目的remote名称相同)
     e. 配置完成，主项目和子模块更新代码和请使用 git pull/push <remote name> <branch> 的格式

三、分支管理

1. 从远程仓库中克隆项目到本地后，请创建属于自己的分支，保证工作中项目主要分支的稳定性

   • 创建分支指令: git checkout -b <branch>(去掉-b则为切换到已有分支)
   • 查看已有分支: git branch

2. 关联分支

   • 本地分支创建好了之后要怎么关联到远程分支上呢，使用指令git branch --set-upstream-to=<remote>/<remote branch> <local branch>

3. 删除分支

   • 删除本地分支: git branch -d <branch name> (将-d修改为-D为强制删除)
   • 删除远程分支: git push <remote> --delete <branch name>

4. 从远程仓库的指定分支更新代码

   • 当远程分支已经与本地当前分支对接后，且无其他远程仓库 remote 时，直接使用git pull 即可从本地分支对应的远程仓库中的分支更新代码到本地
   • 当本地分支未与远程分支对接或本地仓库中还存在其他的 remote 时请参考 remote 说明使用git pull <remote> <branch>

5. 删除本地文件/文件夹并同步到远程仓库

   • 删除文件: git rm test.py
   • 删除文件夹: git rm -r test
   • 使用以上指令删除本地文件/文件夹后按常规提交流程提交即可(如果不需要添加新文件则不需要git add这一步骤)

6. 同步本地分支的代码到远程分支

   • 当远程分支已经与本地当前分支对接后，且无其他远程仓库 remote 时，直接使用git pull 即可从本地分支更新代码到对应的远程仓库中的分支中
   • 当本地分支未与远程分支对接或本地仓库中还存在其他的 remote 时请参考 remote 说明使用git push <remote> <branch>
   • 当远程分支不存在时可在提交时创建远程分支: `git push --set-upstream <remote> <branch>

7. 变基

   • 指令: git rebase <branch>
   • 说明: 一般用于其他分支新增了当前分支没有的内容，使用 rebase 可以将这些内容同步过来，详细原理和使用请参考这里。

8. git-cherry-pick

   • 基本用法: git cherry-pick <commit id>
   • 说明: 一般做 hotfix 时会需要用到这个指令，将指定的某(几)个 commit 改动添加到当前分支，需要指定的 commit 满足某些条件，参考这里。一般来说如果有多个 commit 需要 cherry-pick，由于 commit 可能不连续，所以即使你的 git 版本支持 cherry-pick 连续的 commit 也不可以直接操作一个 commit 区间，此时一般是新建一个 hotfix 分支分别将需要的分支 cherry-pick，然后再将次分支提交 merge request 到需要的分支。

9. git squash

   • https://www.devroom.io/2011/07/05/git-squash-your-latests-commits-into-one/

四、版本控制

1. 查看版本日志

   • 指令: git log
   • 使用场景: 当前版本存在问题，或者其他需要查看版本记录的场景

2. 版本回退

   • 说明: 版本回退会让你的提交记录和本地代码回退到指定版本，所以当需要版本回退时请备份目标版本后添加的重要修改
   • 回退到前一个版本: git reset --hard HEAD^(需要回退指定的版本数量可在'HEAD'后添加对应数量的'^'或者使用'HEAD~'加回退版本数量，如: git reset --hard HEAD~100)
   • 通过版本号(commit id)回退到指定版本: git reset --hard <版本号>，版本号可通过版本日志查看，版本号不一定要全部输入，但至少要输入可以唯一标识该版本的长度的版本号
   • 回退到指定版本但保留改动: `git reset --soft <版本号>，会退到指定版本，但改动不会消失，可以直接使用 add 命令。

3. 回到回退前的版本

   • 说明：git的版本回退只是将HEAD指针移动到指定的节点，所以之前的节点都还在，但是通过 git log 只能查询到之前commit过的版本号，但通过以下方法可查询到回退前的版本号
   • 查询使用过的指令日志: git reflog，git 会记录每一次的git指令使用，通过该指令可以查询到使用过的指令以及执行对应指令的版本号等信息，所以可以通过版本号回到指定的版本

4. 详细git版本使用以及其他相关用法可参考廖雪峰的官方网站-版本回退

五、过滤规则

git中可在提交目录下创建 .gitignore 文件并在其中配置过滤规则，详细规则请参考 Git 忽略提交规则和 gitignore

ps: 本文章只用于个人解决问题后的相关技术记录，如有未标注来源的地方请联系修改；因为是新手使用git，欢迎大家发现文章中的问题并发表探讨，共同进步。