git

git

 

1. 常用命令

• 配置当前用户的所有的本地仓库的用户
  git config --global user.name "your name"

• 配置当前用户的所有的本地仓库的邮箱
  git config --global user.email "your email"

• 配置当前用户在git bash下操作产生的log显示颜色
  git config --global color.ui true

• 创建本地仓库(空目录/非空目录)
  git init

• 创建无工作区的仓库(多用于git服务器)
  sudo git init --bare test.git

• 添加修改到暂存区
  git add .：添加当前所有的修改。(添加、删除、修改文件都属于这里的"修改"概念)
  git add [file1] [file2] ...

• 提交暂存区内容到本地版本库
  git commit -m "your comments"

  • "-m"选项后跟本次提交的注释内容；
  • 多次git add可对应一次git commit；

• 状态查看
  git status：差看工作区状态；

• 改动查看
  git diff <file>：查看工作区和暂存区的区别；
  git diff HEAD -- <file>：查看工作区和版本库里最新提交的区别

• 撤销修改
  git checkout -- <file>：文件回到最近一次git commit或git add 时的状态(最后执行这两个命令中的那个)；

  • 最后执行的是git add，那就把暂存区的内容返回来
  • 最近执行的是git commit，那就把版本库的内容返回来；
  • "--"必须有，如果没有就变成了创建分支指令了；

  git reset HEAD <file>：暂存区的修改撤销(unstage)，重新放回工作区

  • 第一步，把暂存区的内容返回到工作区；
  • 第二步，把版本库的内容返回到暂存区；
  • 这个操作在文件有错误，且已经git add放到暂存区的场景；
  • 如果文件被git commit了，只能使用版本回退的方式(前提是没有git push到远程)；

• 查看提交记录
  git log
git log --pretty=oneline

  • 可以获取commit id；

• 版本回退到之前
  git reset --hard HEAD^
git reset --hard HEAD^^：回退到之前上上个版本
  git reset --hard HEAD~100：回退到之前100个版本

• 版本回退到未来
  git reflog：查看命令历史(回退之前的命令)，确定要回退到未来的commit id；
  git reset --hard <commit id>

• 删除文件
  rm <file>删除文件(可GUI界面直接删除/可命令删除)；
  git add/rm <file>：添加修改(删除属于修改的一种)到暂存区；
  git commit -m "your comments"：提交

• 生成SSH key
  ssh-keygen -t rsa -C "your email"

  • 一路默认，不建议设置密码
  • 秘钥对在用户主目录里的.ssh目录下

• 添加本地仓库到远程仓库
  git remote add origin git@github.com:your-name/test.git：关联远程仓库

  • 远程库名：origin(github默认叫法)

  git push -u origin master：把本地master分支推送到远程仓库

  • 当远程库是空的时，需要在第一次推送时使用"-u"参数，顺便把本地master分支和远端master分支关联起来；

  git push origin master：推送本地master分支的最新commit到远端master，指定本地分支，git自动对应远端分支；

  • 本地master分支需要推送到远端仓库
  • 本地develop分支需要推送到远端仓库
  • 本地function分支(功能分支)，如果时多个人一起开发该功能，需要推送，如果单人开发，不需要推送；
  • 本地bug分支，非必要，不需要推送；

• 克隆远程库
  git clone git@github.com:username/test.git：使用SSH协议
  git clone https://github.com/username/test.git：使用HTTPS协议

  • HTTPS协议，速度慢，每次推送需要输入口令；

• 查看远程库信息

  • git remote
  • git remote -v：显示详细信息(没有推送权限时看不到push地址)

• 提取远程分支
  git checkout -b testbranch origin/testbranch：提取origin的testbranch分支到本地

  • 默认情况下，git clone只能克隆origin的master分支到本地；
    git branch --set-upstream testbranch origin/testbranch：指定本地testbranch分支与远程origin/testbranch分支的关联

• 创建分支
  git checkout -b testbrach：创建并切换到新分支；
  - git branch testbrach：创建分支
  - git checkout testbrach：切换分支

• 查看分支
  git branch

• 合并分支
  git merge testbrach：合并指定分支到当前分支

  • Fast-forward模式(快进模式)，直接把master指向testbrach的最新提交，所以合并速度非常快
  • 不是每次合并都能Fast-forward
    git merge --no-ff -m "comment : no-ff" testbrach：禁用Fast forward模式合并；

• 删除分支
  git branch -d testbrach
git branch -D testbrach：强行删除一个没有被合并过的分支

• 解决冲突

  • 合并时，多个分支对同一个文件修改会造成冲突；
  • 通过git status查看冲突内容；
  • 通过vi查看发生冲突的文件，并手动修改；
  • 合并有冲突时，当前分支会前进两个提交，被合并的分支依旧指向原来的提交；
  • git push时也会发生冲突，先git pull下来，在本地解决冲突，然后提交到本地，再git push；

• 查看分支合并情况
  git log --graph：显示分支合并图
  git log --graph --pretty=oneline --abbrev-commit

• 分支策略

  • master用于发布，平时不在该分支做开发；
  • develop分支用于开发；
  • 多人协同，从develop分支创建自己的分支，开发完成合并到develop分支；
  • 合并分支使用"--no-ff"参数可以保留合并后的历史分支，保留合并动作痕迹；
  • bug通过临时分支修复、合并，最后删除bug分支(bug分支命名前缀issue)

• 保存/恢复分支现场
  git stash：保存现场
  git stash list：查看保存的现场
  git stash apply：恢复现场(stash 内容没删除)
  git stash drop：删除现场
  git stash pop：恢复并删除现场
  git stash apply stash@{0}：多次stash后，恢复指定现场

• 创建标签

  • 创建标签时，需要切换到需要打签的分支上；
  • 标签是按字母排序，不是按时间排序；

  git tag <tagname>：默认标签打在最新的提交上；
  git log --pretty=oneline --abbrev-commit：查看历史commit id
  git tag <tagname> <commit id>： 给历史commit id打签
  git show <tagname>：查看标签信息
  git tag -a v1.0 -m "version 1.0 released" <commit id>：创建带有说明的标签

  • "-a" 指定标签名
  • "-m" 指定说明文字

  git tag -s v1.0 -m "version 1.0 released" <commit id>：

  • "-s"用私钥签名一个标签
  • 签名采用PGP签名,安装gpg,没有gpg密钥对会报错

• 推送标签
  git push origin <tagname>
git push origin --tags：一次性推送全部尚未推送到远程的本地标签

• 删除标签
  git tag -d <tagname>

• 删除已经推送到远程的标签

  • 先从本地删除 git tag -d
  • 从远程删除 git push origin :refs/tags/

 

2. github

• 开源项目，需要先fork到自己的账号下，然后从自己的账号下clone，这样才能推送，直接从开源项目作者那里clone的项目，由于没有权限不能推送；

• 如果希望将自己的修改体现在作者的开源项目里，需要在github上发起pull request(作者可以不接受)；

 

3. 定制git-忽略文件

• 工作区根目录添加.gitignore文件；

• github提供了各种模板：https://github.com/github/gitignore

• 忽略windows操作系统自动生成的文件等；

• 忽略编译生成的中间文件、可执行文件等；

• 忽略带有敏感信息的配置文件等；

• ".gitignore"文件本身要放到版本库里，并且可以对".gitignore"文件做版本管理；

 

4. 疑问

• "删除文件"这个修改操作可以使用git add添加到暂存区吗？

• 本地git reset操作的记录会被push到远端服务器吗？

• 多次stash有哪些应用场景？

• git log --graph 打印的log怎么看?

• git commit -a怎么理解？

• 数字签名的逻辑(PGP/GPG)？和ssh的区别？微软装某些驱动时需要禁用签名，和这里的关系？

• git pull 和git fetch区别？

• bug分支的逻辑？产生bug对应的工程师在bug处理完之后，需要对自己的开发分支做哪些处理？其他工程师呢？

• stash功能的逻辑？在当前分支有未提交的内容时，切换出该分支会导致这些未提交的内容丢失？有未添加到暂存区的情况呢？

• 对于避免ff合并，为什么要生成一个新的commit才能避免分支信息被删除？

• 多个分支不建议修改相同的文件？还是相同文件的同一行？对于写书的人，操作同一个文件是不是冲突会较多？

• 合并的时候，A人修改A文件，B人修改B文件，B合并到A，会不会把A修改的A文件的内容丢弃掉？这个属于冲突吗？

• 一个已经提交到版本库的文件永远不用担心误删，但是要小心，只能恢复文件到最新版本，会丢失最近一次提交后你修改的内容，这个怎么理解？

• 可以在远程不创建空仓库的前提下，直接推一个本地仓库到远程吗？

• 哪些情况下使用分支？

  • 协同工作；

• 从远程提取非主分支时，没有同时关联？

• 合并的时候，master分支如果工作区或者缓存区有未提交的更改，会被丢弃吗？非主分支要进行合并，必须是提交过的，没有新的修改的？

 

5. 备注

• "git reset"命令既可回退版本，也可回退修改；

• "HEAD"表示当前分支的最新提交；

• 仓库目录里的".git"目录就是git版本库；

  • 版本库里有暂存区(stage/index)
  • 版本库里有自动创建的master分支；
  • 版本库里有指向master的HEAD指针；

• 首次git push/git clone，本地报警告，需要添加远程服务器的SSH key：

  • 访问https://docs.github.com/en/free-pro-team@latest/github/authenticating-to-github/githubs-ssh-key-fingerprints确定服务器的SSH key；
  • 一般不会有人冒充，直接yes；

• 工作区目录中，不要使用中文；

• 版本控制系统只能跟踪文本文件(.txt，网页，程序代码等)；

• 图片、视频、word文档属于二进制文件，只能被管理(知道有变化，比如大小)，不能被跟踪(发生了什么具体的变化不知道)；

• 文本需要编码，建议使用UTF-8；

• 不要使用Windows的记事本编辑文本文件，记事本保存UTF-8编码的文件时在文件开头添加0xefbbbf字符，导致异常；

• 回退后，git log只能看到回退到的和回退到的之前的提交，回退这个动作本身不会体现在git log命令中，需要使用git reflog查看；

• git跟踪并管理的是修改，而非文件

• 合并分支时，使用Fast forward 模式，删除分支后，分支信息会丢失；