git简单使用

公司内部代码管理使用git，简单使用一下，还蛮好的。

我简单的理解是：在本地建立文件夹，可以放project，里面什么file、dir都可以放，放完了之后，提交到git里，可以供展示，或者是别人下载更新之类。高级的用法目前没用到。

1.全局设置

Git global setup

git config --global user.name "xuecheng.hu"
git config --global user.email "hxc@aispeech.com"

2.建仓提交

Create a new repository

git clone https://gitlab.spetechcular.com/xuecheng.hu/test2.git //当前git上的地址
cd test2    //已经克隆到本地目录了，直接进去
touch README.md  //各种花里胡哨操作，可以把自己的代码移进来，只要不提交，这就相当于本地文件夹
git add README.md     //提交
git commit -m "add README"  // 提交时的评论，方便看，这提交的是个啥东西
git push -u origin master   // 推送到master的这个分支，一般情况下都是这个，可以换别的

以上我的事就完成了，下面的我都没怎么看，用到再说～～

常用操作

这里只是流水账似的列出常用的几个操作, 要想真正用得熟练, 还得多看文档掌握重要的git命令如branch, checkout, push, pull, merge, fetch, reset等

创建新分支

$ git branch <branch-name>

签出分支

也叫切换分支

$ git checkout <branch-name>

列出所有branch

标星号的是当前branch

$ git branch -a 

删除本地分支

$ git branch -d <local-branch-name>

删除远程分支

$ git push origin --delete <remote-branch-name>

clone一个分支

$ # 为了规避502错误或跟踪其它分支, 若出现502再使用--depth 1
$ git clone https://gitlab.example.com/shun.zhang/aispeech-git-help.git -b <branch-name> [--depth 1]

$ # 再增加跟踪一个分支
$ git pull origin <branch-name>:<branch-name>
$ echo <branch-lastest-commit> > .git/refs/remotes/origin/<branch-name>

查看本地修改

$ git diff
$ git difftool  # diff和difftool都可以

提交本地修改

$ git commit -m "commit log" <file-pattern> # 提交部分
$ git commit -m "commit log" -a             # 提交所有

推送到远程仓库

$ git push origin <branch-name>

回滚

恢复到某个文件到最近一次提交的版本/取消某个文件的本地修改

$ git checkout <file-name>

恢复某个文件到历史版本

$ git log <file-name>                   # 查看日志中的commit-number
$ git reset <commit-number> <file-name>
$ git checkout <file-name>

撤消本地commit(本地commit了, 但未push到服务端)

git reset --hard <commit-number>

同步当前分支的更新

例如当前feature分支还在开发中, 其它小伙伴向当前提交了代码 不建议使用pull命令, 因为它隐藏了一些细节, 这里用fetch & merge命令替代, 每一步心里有数

$ git fetch origin <branch-name>              # 下载最新的代码到远程跟踪分支, 即origin/<branch-name>
$ git difftool <branch-name> origin/<branch-name> # 查看更新内容, 看看而已, 不要在这一步执行手工merge
$ git merge origin/<branch-name>              # 尝试合并远程跟踪分支的代码到本地分支
$ git mergetool                               # 借助mergetool解决冲突

同步其它分支的更新

例如当前feature分支还在开发中, master上已经有了更新的代码, 和上例同步当前分支更新的步骤类似

$ git fetch origin master
$ git difftool <branch-name> origin/master
$ git merge origin/master
$ git mergetool

$ # git merge --abort # 回到merge前的状态

fork后同步上游仓库的更新

如下示例里假设你fork了shun.zhang/aispeech-git-help, 你想享受到上游的更新

$ git remote -v # 查看远程仓库
origin https://gitlab.example.com/li.li/aispeech-git-help.git (push)
origin https://gitlab.example.com/li.li/aispeech-git-help.git (fetch)

$ git remote add upstream https://gitlab.example.com/shun.zhang/aispeech-git-help.git # 第一次需要添加上游仓库
$ git remote -v
origin  https://gitlab.example.com/li.li/aispeech-git-help.git (push)
origin  https://gitlab.example.com/li.li/aispeech-git-help.git (fetch)
upstream    https://gitlab.example.com/shun.zhang/aispeech-git-help.git (push)
upstream    https://gitlab.example.com/shun.zhang/aispeech-git-help.git (fetch)


$ git fetch upstream # 和上例同步当前分支更新的步骤类似了
$ git difftool <branch-name> upstream/master
$ git merge upstream/master
$ git mergetool

引用公共代码

代码引用在git上有两种方式: submodule和subtree, 推荐使用subtree方式, submodule需要每个人都有公共项目的权限, 而subtree只需要一个有权限访问公共库的人来维护就行了, 对团队其它成员是透明的 虽然可以直接引用代码库, 但是基础项目尽量对外发布二进制库, 而不是开放源代码给其它项目直接引用

$ # 第一次初始化
$ git remote add -f <remote-subtree-repository> <remote-subtree-repository-url>
$ git subtree add --prefix=<local-directory> <remote-subtree-repository> <remote-subtree-branch-name> --squash

$ # 同步subtree的更新
$ git fetch <remote-subtree-repository> <remote-subtree-branch-name>
$ git subtree pull --prefix=<local-directory> <remote-subtree-repository> <remote-subtree-branch-name>

project管理

create

在网页上创建, 默认限制一个用户最多创建3个项目, 如需创建更多项目请与管理员联系

fork

只有当你有某个项目的读权限但是没有写权限时才需要fork, 这在开源界用的多, 但在公司内部基本上都是private项目, 所以使用不多

permission

所有项目默认是private, 即只对该项目组内的成员开放权限, 项目的owner(默认是创建者)负责项目的访问权限设置, 并且可以对每一个成员设置权限

group

有时一个项目比较大, 会有很多子项目, 这时可以专门为这个大项目创建一个分组, 例如aios分组下有aios-core, aios-for-car, 语音内核core分组下有asr-cloud, asr-local等

如需创建group请与管理员联系

transfer

可以将一个项目过户给另一个用户, 比如将 shun.zhang 创建的 aispeech-git-help 过户给 li.li, 过户后的地址就变成了 https://gitlab.example.com/li.li/aispeech-git-help

常见问题

• 用什么编辑markdown文本 -- dillinger 是优秀的markdown在线编辑器
• gitlab clone时报502错误 -- 加参数--depth 1
• Your branch and 'origin/master' have diverged -- 执行git pull --rebase
• 支持TOC -- README.MD第一行使用标签[[_TOC_]], gitlab支持TOC