ProgrammingNotes
  • README
  • accounting会计学
  • Apache
  • ar
  • asciidoc
  • AssemblyLanguage汇编语言
  • authorization授权
    • 1.jwt
    • 2.oauth
  • C语言
    • C++
  • cache
  • Computer计算机相关
    • 1.reinstallSystem重装系统
    • 2.vhd
    • 3.bulidWeb建站
    • 4.computerOrganization计算机原理
  • config配置文件相关
  • ContainerTechnology
    • 1.docker
    • 2.kubernetes
  • cs计算机科学
    • 1.api
      • 1.1.restful
      • 1.2.graphQL
      • 1.3.openAPI
      • 1.4.swagger
    • 10.blockchain区块链
      • 10.1.bitCoin比特币
    • 11.characterEncoding字符编码
    • 12.map
      • 12.1.百度地图
      • 12.2.qgis
      • 12.3.openLayers3
      • 12.4.postGIS
    • 13.ai人工智能
    • 14.machineLearning机器学习
    • 15.ioT物联网
    • 16.microservices微服务
    • 17.serverless无服务架构
    • 2.uml
    • 3.designPattern
    • 33.compilation_tool编译工具
      • 33.1.gradle
      • 33.2.maven
    • 4.devOps
      • 4.1.ci
        • 4.1.1.jenkins
        • 4.1.2.github_actions
        • 4.1.3.team_city
      • 4.2.argoCD
    • 6.dataVisualization数据可视化
    • 7.abandonTechnology可放弃的技术
    • 8.bigData大数据
      • 8.1.streamComputing流计算
      • 8.2.edgeComputing边缘计算
    • 9.deepLearning
  • C#
  • db数据库
    • 1.sql
    • 2.noSQL
      • 2.1.redis
      • 2.2.mongoDB
      • 2.3.hbase
      • 2.4.etcd
    • 3.fileSystem文件系统
      • 3.1.fastDFS
      • 3.2.hdfs
    • 4.postgreSQL
    • 5.sqlserver
    • 6.MySQL
    • 7.oracle
    • 8.oceanBase
    • 9.influxDB
    • DatabaseSecurity数据库安全
    • pl/sql
  • Delphi
  • dorado
  • education
  • english
  • frontEnd前端
    • 1.html
      • 1.1.h5
      • 1.2.webSocket
      • 1.3.html2pdf
    • 10.1.wonder
    • 10.webGL
    • 2.w3C规范
      • 2.1.webAPIs
    • 3.css
    • 4.dom
    • 5.xhtml
    • 6.webAssembly
    • 7.ajax
    • 8.fetch
    • 9.picture
  • git
    • 1.gitbook
    • 2.svn
    • 3.github
    • 4.travis_ci
  • golang
    • go_cloud
    • go_crawler
    • goroutine
    • hydra
  • hardware
  • ios
  • java
    • 1.jvm
    • 2.java高级特性之多线程
    • 3.javafx
    • 4.java网络编程
    • 5.java类加载和反射
    • 6.jms
    • 7.java_cloud
    • 8.jsp
    • 9.spring
  • js
    • 1.npm
    • 13.mockJS
    • 19.bootstrap
    • 2.nodeJS
    • 25.echarts
    • 3.angular
      • 3.1.angularCLI
      • 3.2.angularMaterial
    • 4.react
      • 4.3.reactNative
      • 4.4.next
    • 5.vue
      • 5.1.vue-CLI
      • 5.2.vuex
      • 5.3.axios
      • 5.4.vue-router
      • 5.5.element-ui
      • 5.6.vueCore
      • 5.7.nuxt
    • 6.compilation_tool编译工具
      • 6.1.webpack
      • 6.2.parcel
      • 6.3.grunt
    • 7.lib第三方库
      • 7.1.jQuery
      • 7.2.lodash
    • TypeScript
      • 8.1.tslint
    • Deno
    • JS设计模式
    • ECMAScript
    • JS
    • JS6
    • NativeScript
    • RXJS
    • V8
  • linux
    • 1.vim
    • 2.shell
    • 3.shellScript
    • 4.ubuntu
    • 5.makefile
    • 6.centOS
  • markdown
  • markup_lang
    • JSON
    • YAML
  • math
    • 1.algorithm算法
    • 2.cryptology密码学
    • 3.computerGraphics计算机图形学
    • 4.dataStructure数据结构
  • MC消息通信
    • MQ消息队列
      • 1.kafka
      • 2.rabbitMQ
      • 3.redis
      • 4.activeMQ
      • 5.rocketMQ
      • 6.nats
    • MQTT
      • EMQ
    • RPC
      • gRPC
  • mobile
    • android
      • 1.kotlin
      • 2.weixin
      • 3.miniProgram
    • cordova
    • dart
    • flutter
    • ios
      • xcode
    • ReactNative
  • network网络
    • 2.ss
    • 3.http
    • 4.kcp
    • 5.nmap
    • 5G
    • 6.webCrawler
  • news重要新闻
  • Philosophy哲学
    • AnCoderPrepares程序员的自我修养
    • 软件工程的语录
  • php
  • popularizationOfScience科普
  • protocol
    • 1.rpc
  • python
  • readingNotes读书笔记
    • 1.profession专业笔记
    • 2.sql_Antipatterns
    • 3.unix_Network_Programming
    • 4.the_Docker_Book
  • rust
  • scriptingLanguage
    • 2.lua
    • 3.regularExpression正则表达式
    • 4.julia
    • 5.ruby
  • security安全
  • server服务器相关
    • nginx
    • OpenResty
  • software&tool软件和工具
    • 1.vscode
    • 11.plsqldev
    • 17.androidStudio
    • 3.虚拟机VirtualMachine
    • 4.jetBrains
    • 5.eclipse
    • 7.visualStudio
    • 8.office系列
  • softwaretest软件测试
    • JUnit
  • ssh&ssm
    • 2.hibernate
    • 1.spring
  • unix
    • hackintosh
    • mac
  • vr
  • windows
    • terminal&DOS
    • windows10
    • Wine
  • word一些术语
  • zztemp草稿
    • temp
    • temp4study
    • temp4studyLater以后再学的
Powered by GitBook
On this page
  • git
  • 一 概述
  • 1 简介
  • 2 历史
  • 3 常识
  • 4 文档资料等
  • 二 安装配置
  • 1 win
  • 2 mac
  • 3 linux
  • 4 配置
  • 5 清除本地账号密码
  • 三 基础
  • 0 架构和名称
  • 1 工具生态
  • 2 仓库操作
  • 3 分支管理
  • 4 查看
  • 5 同步和推送
  • 6 撤销,回滚和文件恢复
  • 7 草稿和储藏
  • 9 git版本和标签
  • 10 多人协作
  • 其他命令
  • 四 高级
  • 1 git submodules
  • 2 git flow
  • 5 相关文件
  • 6 github pages
  • 7 .git目录
  • 五 经验
  • 1 已整理
  • 2 推送的正确做法
  • 3 .gitkeep
  • 六 问题
  • 1 已解决
  • 2 未解决
  • 七 待整理

Was this helpful?

git

git

[TOC]

一 概述

版本管理中主要包含集中化的版本控制系统 (Centralized Version Control Systems,简称 CVCS) 例如 CVS、Subversion 以及 Perforce 等 ,和分布式版本控制系统(Distributed Version Control System,简称 DVCS), 例如Git、Mercurial、Bazaar 以及 Darcs 。DVCS的特点为每一次的克隆操作,实际上都是一次对代码仓库的完整备份。 其中文件的状态主要有4个:未记录(untracked)、已提交(committed)、已修改(modified)和已暂存(staged) 。

git是开源免费的分布式版本控制系统。除了版本,最核心的操作应该都是围绕分支进行的.官方的描述是At its core, the Git version control system is a content addressable filesystem.(Git是一套内容寻址文件系)

1 简介

git是linus用c写的,是他为了帮助管理Linux内核开发而开发的一个开放源码的版本控制软件。

2 历史

2.1 为什么需要版本控制

在实际工作中,我们脑子里怎么可能记得一个几千行的文件每次都改了什么内容

3 常识

3.1 commit id(版本号)

就是commit信息里的那一长串数字,SHA1计算出来的一个非常大的数字,用十六进制表示。所以经常看到的sha1 hash、sha1 id和commit id是一个东西。

3.3 git支持多种协议:https,git和ssh

git允许我们用ssh url或者https url来管理代码,两种不同的协议.如果是https,则默认每次都要输入密码,但可以使用git提供的credential helper来存储密码

3.4 凭证助手credential helper(待测试)

用于存储git的凭证(认证信息--账号密码等),多种helper可以同时存在

Git有以下几种helper:

  1. git-credential-cache(Cache):将凭据在内存中进行短时间的缓存,不会持久化到磁盘上,15分钟自动删除。

    1. 使用git config --global credential.helper cache

    2. 参数cache –timeout=[num]:设置时间,如git config credential.helper cache –timeout=3600

  2. git-credential-store(Store):将凭据明文保存在磁盘上,永不过期。但是明文存储不安全.

    1. 指定凭证助手:git config --global credential.helper store

    2. 指定明文密码保存位置:可以为不同项目指定不同的文件从而达到使用多账号的目的.

      1. git config --global credential.helper store --file=~/cred.txt,但是该命令似乎并不生效,可以通过修改config文件达到目的,

        [credential]
        helper = store --file=D:/credential/cred1.txt
        # 再次push,便会将账户信息存至`D:/credential/cred1.txt`中.如果想清除账户,删除指定的文件即可。.
  3. git-credential-manager(Manager):安装了GitGUI,自动会在system级别中设置credential.helper为manager

    1. 老版本git是manager,新版本git是manger-core

  4. wincred

  5. osxkeychain:mac特有的,附加到系统的keychain,和store相似,不过osxkeychain是加密保存在硬盘上。这种加密方式与存放 HTTPS 凭证以及 Safari 的自动填写是相同的。

使用:

  1. 查看凭证助手设置git config --list | grep credential

  2. 取消设置凭证助手:git config --<级别,如system> --unset credential.helper

  3. 删除已有的凭证:有两种方式

    1. 修改配置文件

    2. 命令行

    3. 手动删除

      1. win系统 => 控制面板 => 凭据管理 => 找到对应的凭据并删除

      2. mac => 钥匙串中操作

        1. 有可能遇到无法删除的情况,临时解决方案是用新的token替换原来的密码

3.5 ssh-agent

安装了git之后就会有ssh-agent(windows是),ssh-agent 是用于管理SSH private keys的, 长时间持续运行的守护进程(daemon). 唯一目的就是对解密的私钥进行高速缓存.

3.7 关于HEAD的指向(重点,易错点)

HEAD表示当前版本,即最近的那个commit,HEAD~1(或者HEAD^)是上个版本(前一个commit),是当前所在commit的前一个或父commit.以此类推,上上个版本是HEAD~2(或HEAD^^)...

3.8 git名字来源

作者是linus,他说过他是个自负的混蛋,所有项目都以他的名字命名,先有linux,现在是git.

3.9 git命令弹出的shell

似乎跟系统的shell有关,本人用vim的使用方式去使用暂时没发现什么问题(待补充).

3.10 stale git branch

过期的git分支,一般是删除了远程分支,但是本地分支还在的情况下看得到.

3.11 gitlab生成秘钥

  1. 检查是否已经存在SSH Key:ls -al ~/.ssh,如果有,查看id_rsa.pub文件中的邮箱对不对

  2. 重新生成秘钥:ssh-keygen -t rsa -C 'foo@example.com',一般情况下一路回车就行

  3. 打开gitlab,找到Profile Settings-->SSH Keys--->Add SSH Key,并把id_rsa.pub中的内容粘贴到Key所对应的文本框,在Title对应的文本框中给这个sshkey设置一个名字,点击Add key,搞定

3.13 分支状态:active(活动)、stale(过时的)、traced

Active branches(活动分支):表示过去三个月内任何人提交的所有分支,按最近的提交最先显示的顺序排序分支。

Stale branches(过时的分支):过去三个月内没有人提交的所有分支,按最早的提交最先显示的顺序排序分支。

3.13 Delta

在git中经常能看到delta这个词,比如克隆仓库或者拉取远程更新。它来自于Delta encoding(增量编码)。增量编码(delta coding)通过维护增量的方式,保存数据,这样能够达到更好的压缩比,对于保存连续的或者数据段在一个稳定范围内出现的场景,效果更好。

3.14 游离状态

(待整理)状态下的提交不能被引用关联到,从而可能丢失

3.15 git ref

参考:https://developer.github.com/v3/git/refs/

git ref的前缀有:refs/heads/,refs/tags/,refs/remotes/

3.16 图谱

看懂图谱:

  • 每一个点代表一次提交记录

  • 支线不一定代表分支,但是创建一个新分支(并合并后)必然会产生一条新的支线

  • 颜色不会固定代表某个分支

  • 一般而言最左边那条是主干

括号里分支名含义:形如HEAD -> feature/aaa、origin/feature/aaa、HEAD -> feature/aaa, origin/feature/aaa等,表示的是这个commit是这些分支最新的commit。

parent、child的意思?

4 文档资料等

  1. 官方

    1. https://git-scm.com/

  2. 网友翻译的linus关于git的演讲:https://v.youku.com/v_show/id_XMzg5MjIzODM3Mg==.html

  3. 网友翻译整理的Git的奇技淫巧:https://github.com/521xueweihan/git-tips

二 安装配置

1 win

1.1 安装

  1. 下载git for windows

  2. 安装过程大同小异,注意设置git环境的时候选择第二项"use git from the windows command prompt",如果选第一项就不能在cmd中使用git,要自己去配置path。自己配置的时候添git安装目录下的bin目录或者cmd目录都可以

  3. 安装完之后记得配置global username和useremail,这两样就是提交时需要记录的名字和邮箱,这样才可以提交到本地仓库;然后就是推送,如果是需要登录的服务器(github等)推送的时候还需要输入账号密码

    # 注意没配置的话会报错:unable to auto-detect email address
    # 查看git的user.name和email
    git config user.name
    git config user.email
    # 配置用户级的git user.name和email
    git config --global user.name "<用户名>"
    git config --global user.email "<邮箱>"
    # 为每个项目单独配置name和email: 使用 --local(默认参数,不加该参数也是一样的效果)
    git config --local user.name "<用户名>"
    git config --local user.email "<邮箱>"

1.2 配置ssh Key(可选)

主要用于ssh方式的秘密登录.

  1. 查看目录下是否有公钥

    SSH 公钥默认储存在账户的主目录下的 ~/.ssh 目录,进入它的子目录查看是否有xxx和 xxx.pub 来命名的一对文件,这个 xxx通常就是id_dsa或id_rsa.有.pub后缀的文件就是公钥,另一个文件则是密钥。

  2. 没有则交互式创建:ssh-keygen -t rsa -b 4096 -C "your_email@example.com",默认会在~/.ssh下生成公钥和密钥.或者直接输入ssh-keygen也行,但是选项有点多.

    会要求输入密码,应该是用于ssh登录服务器命令行界面的(待确认),所以只是使用git的话可以不用输入.

  3. 添加到ssh-agent(多账户时才用)

    比如上面新建了个人的key,如果我还需要再创建一个公司的key,可以:

    1. 创建ssh key:ssh-keygen -t rsa -b 4096 -f $home/.ssh/company -C "wdwangtw@gmail.com"

    2. 开启ssh-agent:eval "ssh-agent -s"

    3. 添加私钥到ssh-agent:ssh-add ~/.ssh/conpany/xxx,如果报错"could not open a connection to your authentication agent",则输入ssh-agent bash,再输入ssh-add ~/.ssh/conpany/xxx

    4. 创建或修改ssh-agent的配置文件(默认是在~/.ssh目录下的config文件)

      Host myhost personal 
      User xushike
      HostName github.com
      IdentityFile ~/.ssh/id_rsa
      
      Host myhost company
      User wdwangtw
      HostName github.com
      IdentityFile ~/.ssh/company

      其格式为:

      Host myhost USER_HOST     ;USER_HOST为自定义host名字,如上面的personal和company
      User USER_NAME                 ;USER_NAME为自定义名称
      HostName SERVER_HOST   ;SERVER_HOST为实际服务器host,此时为GitHub
      IdentityFile PRIVATE_KEY      ;PRIVATE_KEY为本地key

      当再次clone一个新Repos时,如果其ssh地址为git@github.com:wdwangtw/xxx.git,使用git clone git@company:wdwangtw/TestUserwd.git即可clone到本地(注意github.com换成了自定义的company),并且push时也不用输入任何验证。

    5. 告诉ssh 允许 ssh-agent 转发(可选)

      加入我有a和b两个服务器的钥匙,此时在a服务器上想不输入密码的连到b服务器,就需要配置转发功能.添加ForwardAgent yes到config文件中.然后每个服务器都需要这样设置.

  4. 将公钥添加到github或者gitlab等服务器的账户里

    Copies the contents of the id_rsa.pub file to your clipboard,然后粘贴到服务器需要你填入的地方.

    1. 如果换电脑,可以把本地的key拷过去,也可以重新生成key.

  5. 如果之前用的https协议,此时需要remote origin,然后重新设置origin:git remote add origin git@github.com:xushike/study.git

  6. 对于github,可以测试是否成功设置ssh key:ssh -T git@github.com

1.3 git自身的更新

reference from StackOverflow:https://stackoverflow.com/questions/13790592/how-to-upgrade-to-the-latest-version-of-git-on-windows-still-showing-older-vers

大意是:Since Git 2.16.1(2) you can usegit update-git-for-windows,In versions between 2.14.2 and 2.16.1, the command wasgit update,更早的版本没有提供git update命令,只有去官网下载。

也可以直接github上下载:https://github.com/git-for-windows/git/releases

1.4卸载

2 mac

安装:

  1. 方式一(推荐):Homebrew安装

    1. 需要注意的是,从2.x的某个版本开始,brew install git已经不包含gitk了,需要brew install git-gui来获取gitk

  2. 方式二:用Xcode的Command Line Tools

3 linux

3.1 未整理

  1. linux下ssh-agent的全局配置文件是/etc/ssh/ssh_config?

  2. linux下启动命令是:eval ssh-agent?

4 配置

4.1 Git仓库的配置文件

Git共有三个级别的config文件,分别是system、global和local:

  1. .git/config:指定仓库配置(特定于某个仓库),获取或设置时使用--local参数(或者省去)。

  2. ~/.gitconfig:用户级别仓库配置(适用用于特定用户下的所有仓库),获取或设置时使用--global参数。

    1. 当然该配置不是一定有的,比如公司的mac air上就没有改配置文件

  3. /etc/gitconfig:系统级别仓库配置(适用于所有仓库),获取或设置时使用--system参数。

覆写关系为:自上到下,作用范围越大;小范围优先级高于大范围。

打开一个配置文件,大概长这个样子:

[user] 
name = John Smith
email = john@example.com
[alias]
st = status
co = checkout
br = branch
up = rebase
ci = commit
[core]
editor = vim

4.2 设置 git config itemA valueA

不带级别的话默认是--local,比如git config color.ui true,默认是设置到当前git仓库的config文件中,如果没有该文件,会提示出来且不会自动创建该文件。如果在设置时加上了--global和--system,会在没有对应config文件的情况下自动创建对应的config文件。

使用

  1. 查看设置

    1. 查看所有配置(包括git自带的和用户自定义的):git config -l

    2. 查看配置文件的内容(似乎只能显示自己额外设置的配置,对于git本身的一些配置不会显示)

      • 查看项目的配置文件git config --local -l

      • 查看用户的配置文件git config --global -l

      • 查看系统的配置文件git config --system -l

    3. 查看具体某个项的设置:git config --get itemA,比如查看大小写敏感git config --get core.ignorecase

  2. 设置

  3. 取消设置

    1. 一般情况下取消某个项的设置git config --unset itemA,比如git config --global --unset user.email

    2. 特殊的,比如git config --global url."git@*.domain.cc:libA".insteadOf "https://*.domain.cc/libA"

      1. 可以这样取消git config --global --remove-section url."git@*.domain.cc:lib"

      2. 也可以直接删除~/.gitconfig中对应的段落

常用设置项:

  1. 为命令设置别名:比如git config --global alias.st status,设置后就可以用st代替status。如果想使用非git命令,需要在前面加上叹号!,如git config --global alias.visual '!gitk'

4.3 配置自动补全

win:

  1. todo

mac按以下步骤操作:

  1. 下载git-completion.bash:https://github.com/git/git/blob/master/contrib/completion/git-completion.bash

  2. 将git-completion.bash放到该目录下:~/.git-completion.bash

  3. 修改.bashrc,在最后添加:source "/Users/xxx/.git-completion.bash"

  4. 如果.bash_profile里加上了那句source .bashrc,那么对新开的bash已经生效了。

然后就可以使用git的自动补全了,比如输入git co,然后按两次tab键,就会出现提示commit config,输入git checkout按两次tab就会出现所有分支名等。

5 清除本地账号密码

5.2 mac

mac终端使用git时,输入账号密码会自动记忆到钥匙串。所以,清除方法是,在钥匙串程序黎搜索github, 结果中种类为互联网密码的条目即为所需, 删除它即可。

三 基础

0 架构和名称

三棵树(The Three Trees)、三板斧、四个状态、四个对象

从git的官方book来看,三棵树是:

Tree
description
Role

HEAD/Repo

指向最后一次提交

Last commit snapshot, next parent(上一次提交的快照,下一次提交的父结点。可以简单理解为该分支上的最后一次提交的快照)

Index/Stage

用于暂存更改

Proposed next commit snapshot(预期的下一次提交的快照)

Working Directory/work space(工作目录/工作区)

用于编写更改

Sandbox

从git的官方中文book来看,三棵树是:

  • 工作目录/工作区(Working Directory或work space)

  • 暂存区(Index文件或Stage)

  • HEAD(当前分支所在的commit).

个人:储藏区(stash)算不算第四棵树?

“三板斧”:通常指的git add、git commit和git push三个命令,也就是最常用最简单的三个命令。

四个状态:在git看来,文件有四个状态

  1. 未记录(untracked)

  2. 已提交(committed)

  3. 已修改(modified)

  4. 已暂存(staged)

四个对象:git 主要有四个对象,分别是 Blob,Tree, Commit, Tag 他们都用 SHA-1 进行命名

  1. Blob:用于存储单个文件内容,一般都是二进制的数据文件

  2. Tree:对应文件系统的目录结构,里面主要有:子目录 (tree),文件列表 (blob),文件类型以及一些数据文件权限模型等

  3. Commit:是一次修改的集合,当前所有修改的文件的一个集合,可以类比一批操作的“事务”。是修改过的文件集的一个快照,随着一次 commit 操作,修改过的文件将会被提交到 local repository 中。通过 commit 对象,在版本化中可以检索出每次修改内容,是版本化的基石

  4. Tag:tag 是一个"固化的分支",一旦打上 tag 之后,这个 tag 代表的内容将永远不可变,因为 tag 只会关联当时版本库中最后一个 commit 对象。一般应用或者软件版本的发布一般用 tag。

git的hash

查看使用的hash算法git rev-parse --show-object-format,默认采用sha1

Plumbing和Porcelain

Plumbing则是Git的底层部分,它处理Git对象和Git仓库的内部结构细节。Plumbing包括了一些原始且较低级别的Git命令,如git init和git hash-object等。而Porcelain提供了一种更高级别的Git使用体验,以命令行工具和图形用户界面的形式向用户暴露Git功能。它包含了一些常用且易于使用的Git命令,如git add,git commit和git push等。

detached HEAD状态

什么是detached HEAD:也称为游离状态/游离指针状态,detached HEAD 状态是指 HEAD 指针不指在任何分支的索引.进入 detached HEAD 状态后 git 会创建一个临时分支,会看到提示信息"You are in 'detached HEAD' state...",一般是用于草稿。

草稿想转正怎么操作:git add、git commit 然后 git checkout -b 新的分支,不然临时分支会被 git 删除。

草稿不想要了怎么操作(退出该状态最优雅的处理方法):切换回原来的分支git checkout -

1 工具生态

git bash

使用:

  1. 配置:老版本配置起来比较麻烦,推荐先升级到最新的git版本,然后再配置

    # 解决windows下使用git bash中文乱码的配置(待整理)
    git config --global gui.encoding utf-8 # 代码库编码
    git config --global i18n.commitencoding utf-8 # log编码
    git config --global core.quotepath false # 支持中文路径
    
    git config --global i18n.logoutputencoding utf-8
    export LESSCHARSET=utf-8

git gui

gitk

参考:https://git-scm.com/docs/gitk

安装:

  1. mac:参考git的安装部分

实测在windows的powershell中运行gitk会直接退出,其他shell则没有问题。

如果出现中文乱码,可以修改设置git config --global gui.encoding utf-8

以图形化的界面显示文件修改记录:gitk --follow <文件名>

显示其它分支的修改记录:查阅文档后以为gitk --branches可以,结果试了下似乎不行,最后换成gitk <branch_name>来解决的,似乎会列出所有和该分支有关联的分支的记录。(待整理)

参数:

  • --simplify-by-decoration

  • --all

  • 搜索

    • 按提交时间过滤gitk --since='2020-08-25' --until='2020-09-21'

图形界面说明:

  1. Parent:父commit,如果在commit1的基础上做了修改(也可以不做修改)然后提交生成了commit2,那么commit1就是commit2的parent,commit1的hash值会被记录在commit2里面,但commit1里面不会记录commit2的hash值。如果commit是多个分支合并的(称为octopus merge),则有多个父commit。

  2. Child:子commit,可以理解为下一个commit,如果被合并到了多个分支,则有多个

  3. branches:所有包含这个commit的分支

  4. Follows:前一个tag名称

注意:mac上和liunx需要自己安装,mac可用brew:brew install gitk

问题:

  1. mac打开gitk一片空白,报错如下:Error in startup script: window "." was deleted before its visibility changed while executing "tkwait visibility ." (file "/usr/local/bin/gitk" line 12629)

    1. 更新gitk版本git upgrade git-gui:实测从2.27.0 -> 2.33.0就好了

git mergetool

主要用于解决冲突,似乎只有存在冲突文件时才会出现(待测试)

2 仓库操作

2.1 git init 初始化仓库

官网说的初始化命令默认会创建master分支,但实践发现,在第一次commit之前很多命令都报错(比如git branch,git checkout,远程仓库的命令等),所以最佳实践是第一次commit之后再去操作分支和远程仓库。

注意:如果在Windows系统,请确保目录名(包括父目录)不包含中文

2.2 git clone 克隆仓库

克隆仓库的所有内容,克隆后当前在默认分支(一般是master分支).

git clone <远程仓库地址> [本地仓库名称]:克隆,并将库放到[本地仓库名称]文件夹中.如git clone https://github.com/xushike/study.git studyNote

参数:

  1. --recursive:对于含有submodules的仓库,其作用等同于git clone+git submodule init+git submodule udpate,参考git submodule部分的笔记

  2. -o:默认情况下,克隆时所使用的远程主机自动被Git命名为origin。如果想用其他的主机名,需要带上该参数,如

    git clone -o bar https://github.com/foo.git
    git remote
    # bar
  3. -b:克隆指定的分支,比如git clone -b 分支名 仓库地址。克隆某分支到本地目录,然后在该目录下push时,对应的就是push到远端的对应分支。

2.3 git remote:远程仓库相关

查看远程仓库:

  • git remote -v:查看所有关联的远程仓库的名称和地址(拉取和推送)。在对远程仓库有修改后可以用该命令判断是否修改正确。

  • git remote show:查看有那些远程仓库,一般单远程库的显示可能是origin,多远程库可能origin upstream ...等。

  • git remote show <远程仓库名>:查看远程仓库详细信息,如git remote show origin。可查看的信息包括:

    • 远程仓库地址

    • 远程分支、分支的绑定和同步情况

    • 最新的commit在哪个分支:HEAD branch: master表示最新的commit在master分支上,HEAD branch: develop表示最新的commit在develop分支上,

添加到新的远程仓库:git remote add <远程仓库名> <远程仓库地址>,多远程库的做法常用于种子库或核心库.远程仓库地址最好以.git后缀结尾,比如https://github.xxx.git,如果是https://github.xxx,虽然也能重定向过去,但是会有warn提示。

可以设置多个远程仓库,拉取的时候指定仓库和分支名就行了,如git pull <远程仓库名> <分支名>

修改远程仓库的url地址:git remote set-url REMOTE_NAME NEW_REMOTE_URL,如果设置错误,会出现xxx does not to be a git repository。例子如,

git remote set-url origin https://github.com/xushike/ProgrammingNotes
git remote set-url origin git@gitlab.abc.com:go/goods-stocks.git 

重命名远程仓库:

  1. (不推荐,可能导致问题?待测试)git remote rename <原名称> <新名称>

  2. (推荐?)先删除远程分支,再推送本地新分支

取消(删除)远程仓库的关联:git remote rm <远程仓库名>,注意每次取消再重新关联远程仓库之后,都需要重新推送并关联分支.

3 分支管理

Git鼓励大量使用分支,分支可以说是git最核心的内容了.因为创建、合并和删除分支非常快,所以Git鼓励你使用分支完成某个任务,合并后再删掉分支,这和直接在master分支上工作效果是一样的,但过程更安全。

3.1 创建和查看分支git branch

查看分支:git branch,列出本地的所有分支,在当前分支前面会有一个星号.注意才clone完之后只会显示默认分支,实际上其他分支还是存在的.

参数说明:

  • 不带任何参数:列出所有本地分支

  • -l <pattern>、--list <pattern>:不带<pattern>的话是列出所有本地分支。

    git branch --list "*zhangsan*" 或者 git branch --list *zhangsan*
  • -r、--remote:列出所有远程分支(包括已被删除但缓存还在的)

  • -a、--all:列出所有远程分支(包括已被删除但缓存还在的)和所有本地分支

  • -v:查看所有分支最后一次commit信息;-vv:同时还能查看对应的远程分支

  • -m old_name new_name:重命名分支

查看远程所有现在还存在的分支:git ls-remote

新建分支:

  1. git branch <分支名>:通过复制当前分支的所有commit和暂存区来生成一个新分支,不会复制工作区的文件

  2. 创建并切换分支:git checkout -b <分支名>,等于执行git branch <分支名>加git checkout <分支名>

  3. 从指定的commit创建分支:git checkout -b <分支名> <commit_id>

更新所有分支:git remote update [远程分支名],会更新远程仓库的所有分支,没用过,感觉可能会有问题,(待研究).

3.2 切换分支/签出分支/进入游离状态(git checkout和git switch)

对本地而言,可以直接切换到本地以及所有的远程(orgin、upstream等)的分支,如果切换远程时提示没有对应的分支,需要先同步一下远程信息,比如git fetch upstreamA,单远程库的情况下这样使用没问题,如果是多远程库,可能会提示git checkout --track origin/<name>,意思是git并不清楚你要检出哪个远程库的分支,所以要用提示的命令,比如git checkout --track origin/develop

使用:

  1. 切换分支git checkout branch_name:工作目录会恢复到该分支最后一次提交时的样子(暂存区和工作目录是干净的),如果Git不能干净利落地完成这个任务,它将禁止切换分支。所以对于新增的文件,如果目标分支没有该文件,切换成功;有该文件,切换失败.

  2. 进入游离状态git checkout commit_id:因为分支其实是指向某个commitid的指针,所以checkout也可以切换到一个commmitid,它会根据这个commit生成一个暂时的branch(此时处于游离状态,还不是真正的branch),具体参考架构部分的detached HEAD状态笔记

git switch:因为git checkout有点复杂了,所以git又新增了一个命令git switch用于切换分支。除了不能切换到commitid,其他和git branch用法一样。

  1. 参数

    1. -c

3.3 删除分支

不能删除当前分支,所以要删除的时候需要先切换到其他分支.

删除本地分支:

  1. git branch -d <分支名>,删除的时候可以先切换到其他分支,如果被删的分支没有合并到master会有警告,如“xxx is not fully merged”,没有推送到关联的远程分支则会有警告,这两种情况想继续删除可以先处理了该分支或者使用强制删除git branch -D <分支名>。

删除远程分支:

  1. git push origin --delete <远程分支名>,此时该远程分支(假设是dev1.0)的状态是stale,如果本地重新clone该项目则该分支将不存在;如果本地之前拉取过该分支,那么再次推送本地的dev1.0会导致远程的dev1.0再次变成tracked状态(相当于没有删除),所以此时需要执行git remote prune <远程名>,此时本地库上该远程分支就真正删除了.

删除本地库上失效的远程追踪分支:git remote prune <远程仓库名>,但如果已经先删除了远程的分支,该命令不会删除对应的本地分支,仍然需要手动删除。也不会删除未追踪的本地分支。

  1. 参数--dry-run:打印执行信息,但并不真正执行

3.4 合并分支

合并时正确做法是不要修改vi中默认的Merge branch 'other_branch_name',只解决合并相关的冲突,等合并完之后再做其他修改。这样方便后续跟踪分析。

合并目标分支到当前分支:git merge <目标分支名>,默认是快进模式(Fast-forward)

如果想全部采用某一方的更改,可以用git checkout --ours .或git checkout --theirs .

撤销上次的分支合并:git merge --abort

合并远程的其他分支到当前分支:

cherry-pick

非常优雅的命令,只merge部分commit到当前分支上,git cherry-pick commit_id...。适用场景:比如两个并行开发的分支上有相同的bug,修改了其中一个之后可以合并到另一个分支上。比如分支2上有个commit的id是23d9422,想将该次提交合并到当前分支(分支1)上可以使用git cherry-pick 23d9422。没有冲突的话默认会自动提交。合并时的顺序和参数的顺序有关,和参数对应的commit_id的提交时间无关,比如git cherry-pick A B C,就算B的提交时间在A的前面,也是先合并A。如果A有冲突,会提示出来,需要git cherry-pick --continue来解决冲突,否则无法合并B,也可以git cherry-pick --abort来取消合并。

用法:

  1. 合并多个commit:用空格分隔。如git cherry-pick A B C D E F、git cherry-pick aaa..bbb A E等

  2. 范围merge:两个commit中间的所有内容用..代替。如cherry-pick A..B,则是合并(A, B](左开右闭)的内容,如果想合并闭区间的内容,可以使用cherry-pick A^..B,即是合并[A, B]的内容。该命令可以和上面的命令混用。

  3. 合并另外一个分支的最后一次提交到当前分支:git cherry-pick branchName

  4. 合并另外一个分支的所有不同提交到当前分支:git cherry-pick ..branchName或者git cherry-pick ^HEAD branchname

参数:

  1. --continue:参考解决冲突的步骤

  2. --abort:取消这次cherry-pick,这种情况下当前分支恢复到cherry-pick前的状态,没有改变.

  3. --quit:中断这次cherry-pick,这种情况下当前分支中未冲突的内容状态将为modified

  4. -n(--no-commit):不自动提交

  5. -e(--edit):编辑提交信息

解决冲突的步骤:pick多个时如果有冲突,需要用显示冲突的文件,解决冲突之后(解决冲突后执行了git commit或git add)如果还有冲突,似乎需要再执行这个命令来解决下一个冲突。

经验:

  1. 重复pick:pick过的commit_id,再次pick时,不会像Fast-forward那样做智能判断,依然是按顺序来判断是否有冲突。比如A和B对同一个文件有修改,B时间在后面,先执行一次git cherry-pick A B,然后在执行git cherry-pick A,那么需要再解决一次冲突。如果重复pick没有冲突的话,会提示空提交,可以使用git reset来跳过这个pick或者git commit --allow-empty强行提交这个空pick。

  2. 非纯净pick:假如当前分支在branchA,合并branchB时如果有冲突并解决了冲突然后提交生成了commitA,那么branchC在pick commitA的时候,实际上会引入branchB里面冲突的那部分代码。

只合并部分文件

参考git checkout branch_name file_name部分

4 查看

4.1 git status:检查更新和工作区状态

4.2 git log:查看提交日志

直接使用是查看当前分支的本地提交日志,默认reverse chronological order排列。

查看远程分支的提交日志:git log [origin]/[master],本地很久没有更新过远程仓库的信息了,看到的日志可能就不是最新的,所以在查看之前需要先运行git fetch 或者git fetch origin(待补充)

查看具体某个文件的提交日志:git log -- <文件名>

参数说明:

  • --oneline:压缩模式,在每个提交的旁边显示经过精简的提交哈希码和提交信息,以一行显示

    1. 查看最近三次提交:git log --oneline -3

  • --graph:图形模式,使用该选项会在输出的左边绘制一张基于文本格式的历史信息表示图。如果你查看的是单个分支的历史记录的话,该选项无效(具体参考图谱部分)

  • --all:显示所有分支的历史记录

  • --decorate:查询git log --help,解释是:打印commit的refs信息(分支名称、tag名称等)。并没有说需要什么条件才会显示这些。实测是:如果某个commit上有tag或者该commit是某个分支最新的commit才会显示。

  • --simplify-by-decoration:"Commits that are referred by some branch or tag are selected.",也就是说只显示被合并或者打了tag的commit,当然,最新的一次提交是永远存在的,所以也会包括在内。一般在想知道commit关键的变化信息,比如分支关系的时候使用。

  • --oneline --graph --decorate --all:查看所有的提交

  • --pretty=oneline:只看commit的-m信息

  • --stat:显示变动文件数和行数

  • --patch、-p、-u:查看具体变更内容。

  • --reverse反向排序:默认是最近的提交排在前面,使用git log --reverse则是最早的提交排在前面

  • 搜索、过滤

    • --grep=<xxx>或--grep "<xxx>":按提交信息过滤,支持正则。如git log --grep="first"

    • --author="<xxx>":按提交人过滤

    • -- <file_path>或<file_path>:按文件过滤

    • 按修改的文本内容过滤

      • git log -G <pattern>:支持正则查找。如git log -G '配件编码',会搜索所有改动文本包含"配件编码"的commit。如git log -G "fmt.Println"

    • 按提交时间过滤git log --since='2020-08-25' --until='2020-09-21'

4.5 git diff 查看变更(主要用于查看冲突)

git diff顾名思义就是查看difference,显示的格式正是Unix通用的diff格式.后面可跟某个文件名或commit_id,不跟的话就默认列出当前工作区的所有更改.

git diff HEAD:对比workspace与最后一次commit。以此类推,git diff HEAD~1是比较最后一次commit_id和倒数第二次commit_id。

对比本地和远程分支间的差异:git diff <branch_name> <origin_name>/<origin_branch_name>。比如对比本地master和远程master的差异git diff master origin/master

参数:

  1. -p:Generate patch (see section on generating patches). 默认参数.

4.6 git blame(查看文件的每个部分是谁修改的)

git blame <filename>

4.6 git show 查看提交的内容

直接使用是查看当前分支最新commit的内容

查看某个commit的内容(与分支无关):git show <commit id>

查看某个commit中某个文件的变化(与分支无关):git show <commit id> <文件名>

4.7 查看命令帮助信息

查看所有命令:git --help

查看某个具体命令的帮助:git command_name -h,比如git fetch --help

4.8 git reflog:查看关键命令(commit,pull,checkout)的记录

出现错误的时候很有用。

5 同步和推送

5.1 git fetch:拉取远端到本地仓库

首先需要明白:git在本地会保存两个版本的仓库,分为本地仓库和远程仓库,这里的远程仓库是保存在本地的远程仓库,不是远程的远程仓库。git fetch只是更新本地的远程仓库的代码为最新的,而本地的本地仓库的代码还未被更新,使用对应的git merge后本地的本地仓库才和远程仓库一样是最新的。

使用:

  1. 拉取远程主机的所有更新到本地

    1. 拉取绑定的远程主机的所有更新git fetch,默认是git fetch origin,拉其他上游的时候需要指定上游。

    2. 拉取指定上游git fetch <远程主机名>,比如git fetch upstream

    3. git fetch可以同步到新的分支到本地,但是远端有删除分支,直接git fetch是不能将远程已经不存在的branch等在本地删除的,此时可以git fetch --prune实现在本地删除远程已经不存在的分支,简写git fetch -p

  2. 拉取远程主机的指定分支的更新到本地分支git fetch <远程主机名> <远程分支名> : <本地分支名>,比如git fetch origin master : dev

  3. 拉取远程主机的指定分支的更新到本地当前分支git fetch <远程主机名> <分支名>,比如git fetch origin master

取回更新后,会显示被本次操作所影响到的本地仓库里分支的状态,还会返回一个FETCH_HEAD(用小写也可以),指的是某个branch(如果git fetch没有指定远程分支,则是当前分支对应的远程分支,如果指定了,则是指定的远程分支)在服务器上的最新状态,我们可以在本地通过它查看刚取回的更新信息:git log -p FETCH_HEAD,然后可以选择是否执行git merge FETCH_HEAD来合并到当前分支。

# git fetch执行完后的状态,如果只fetch了一个分支,只会显示一个分支的状态,如果fetch了所有分支,则会显示所有分支的状态
= [最新]                qa                                       -> origin/qa
# "最新"表示?(待补充)

对比git pull:可以自己选择合并或者不合并,所以更加可控。

5.2 git pull = git fetch + git merge

默认是快速合并(fast-forward),有冲突的话需要手动解决。

默认是拉取远程主机所有更新,但只merge当前分支跟踪的远程到当前分支:git pull。如果当前分支没有跟踪的远程分支,该命令不会生效,会出现警告。

拉取指定分支的更新:

  1. git pull <远程仓库名> <远程分支名>:<本地分支名>。这样不会拉取远程主机的所有更新,也就是说如果有人新增了分支branchA并推送到远程,使用该命令不会拉取到新分支branchA的信息,用git branch -r也看不到新分支。

  2. 对于上面的命令,如果远程分支是与当前分支合并,则冒号后面的部分可以省略,可以简写为git pull <远程仓库名> <远程分支名>

  3. 对于上面的命令,如果远程分支是与当前分支合并,且远程分支就是当前分支对应的远程分支,则可以进一步省略,简写为git pull

5.3 git add暂存

工作目录的文件只有两种状态:已跟踪(tracked)和未跟踪(untracked),加入过暂存的都是已跟踪文件,初次clone后的所有文件都是已跟踪的.

所以暂存有两层意思:对于未跟踪的文件是将其跟踪,对于已跟踪的,是跟踪其最新变动.

git add <被跟踪的文件名>:用于把文件放入暂存区,放入过暂存区的文件会被跟踪(tracked),这个跟踪表示会被git管理,而且会被commit以及其他一些命令影响到.

如果文件暂存后又被修改了,需要再次暂存然后提交。

参数说明:

  • -u:暂存所有已关联的文件(新建的文件不受影响)

  • -f:如果想暂存的文件被ignore了,加上该命令可以强制暂存

  • -i:逐个确认

  • -p、--patch:只选文档中的部分变更进入stage,会进入Interactive Mode

取消暂存:git reset HEAD <文件名>,具体参考git reset部分

删除文件并添加到暂存:git rm <文件名>,等价于:直接删除文件+添加到暂存(即git add <文件名>)

移动或重命名文件并添加到暂存:git mv fileA fileB,等价于:移动或重命名文件+添加到暂存(即git add)

git rm --cached <file_path>:删除暂存区或分支上的文件, 但本地又需要使用, 只是不希望这个文件被版本控制 git rm -r --cached <dir_path>:如果是目录。

5.4 git commit

作动词时表示做一个版本,作名词表示版本。Git每次提交操作保存的提交对象包含了作者的姓名和邮箱、提交时输入的信息以及指向它的父对象的指针(首次提交产生的提交对象没有父对象,普通提交操作产生的提交对象有一个父对象,而由多个分支合并产生的提交对象有多个父对象,父对象可以简单理解为父commit)

最佳实践:请确保在对项目 commit 更改时,使用短小的 commit。不要进行大量 commit,记录 10 多个文件和数百行代码的更改。最好频繁多次地进行小的 commit,只记录很少数量的文件和代码更改。

参数说明:

  1. --amend:与上次commit合并提交,可修改commit信息,最终只会有一个提交.(很好用,但多人合作时慎用)

    1. 撤销amend的方法:参考:https://blog.csdn.net/qq_17034717/article/details/79536873。大概是使用git reflog找到前面操作的commit id,然后使用git reset --hard <commit_id>恢复过去

  2. -a:约等于git add和git commit一起使用,将所有unstaged的文件变成staged(这里不包括untracked(新建的)文件),一般更推荐使用git add

  3. -m:commit message,用双引号的话默认输入的所有内容会变成一行

    1. 实现commit message多行的方法

      1. 在一个commit命令内多次调用-m,比如git commit -m "commit title" -m "commit description"

      2. 使用单引号

  4. --author="username <xxx@xxx.com>":以此作者信息提交。假如某个commit用userA信息提交了,想改成userB,就可以参考这个命令git commit --amend --author="username <xxx@xxx.com>",直接用git commit --amend是不行的

5.5 git rebase 变基/压制/衍合

将 commit结合在一起是一个称为压制(squash)的过程,我的理解就是将多个commit合成一个commit(会生成新的SHA,同时原来的多个就会消失掉),当然该命令是强大且危险的. 也可以在压制前新建一个分支备份下.

  1. 两种用法

    1. 选择压制哪些commit

      1. 比如压制最后的三个commit:git rebase -i HEAD~3,

        1. 参数-i会出现统一设置这几个commit的交互界面,推荐加上,否则就要在压制过程中一个一个设置

      2. 极端情况是想从当前分支的第一个提交开始rebase,可以使用git rebase -i --root

    2. 选择远程分支和本地分支的压制

      1. 比如git rebase upstream/branchA <local_branch_B>会执行以下操作

        1. 会将local_branch_B中比upstream/branchA多的commit先撤销掉,并将这些commit放在一块临时存储区(.git/rebase)

        2. 然后将upstream/branchA中比local_branch_B多的commit应用到local_branch_B上,此刻local_branch_B和upstream/branchA的代码状态一致。

        3. 将存放的临时存储区的commit重新应用到新的local_branch_B上,此时可能会冲突。

        4. 解决冲突

          1. 手动编辑冲突文件,手动删除或者保留冲突的代码;

          2. 对于“both added”、“both deleted”、“both modified”等类型的冲突,若想完整地保留某一方的修改可以执行git checkout --ours(或者--theirs) <文件名>来选择想要保留的版本。需要注意的是由于git rebase 是先撤销再应用commit,所以这里的ours指的是upstream/branchA,theirs指的是我们将要应用的临时commit。

          3. 对于“added by us/them”、“deleted by us/them”等类型的冲突需要使用git rm 和git add 来删除/添加file。在此过程中需要特别注意谁是us,谁是them。

          4. 冲突解决完之后,使用git add 来标记冲突已解决,最后执行git rebase --continue继续。如果中间遇到某个补丁不需要应用,可以用git rebase --skip忽略

  2. 交互式参数 2. 交互式参数p(pick):使 commit 保持原样 3. 交互式参数r(reword):保留commit的内容,但修改 commit 说明 4. e:edit <commit> = use commit, but stop for amending(保留该commit, 但我要停下来修改该提交(不仅仅修改注释)) 4. 交互式参数s(squash):将此 commit 的更改结合到上面的那个commit(界面中位于其上面的 commit )中,两者的注释信息会合并 5. 交互式参数f(fixup):将此 commit 的更改结合到上面的那个commit(界面中位于其上面的 commit )中,但不保留该提交的注释信息 6. 交互式参数x(exec):运行 shell 命令(待整理) 7. 交互式参数d(drop):删除 commit(待整理)

界面看起来是这样,从上到下,log是从旧到新的顺序:

pick cbf3b57 add a.txt for test git rebase
pick 0325c7f add b.txt for test git rebase

# Rebase 52ef447..0325c7f onto 52ef447 (2 commands)
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# ...

我们就是修改上面的"pick",然后:wq,然后rebase processor会检测我们输入的指令

  1. 如果指令输入错误,它会提示

    You can fix this with 'git rebase --edit-todo' and then run 'git rebase --continue'.
    Or you can abort the rebase with 'git rebase --abort'.

    此时我们需要重新输入指令

  2. 如果指令输入正确:我们可以再输入git rebase --continue让它真正执行指令。它会从上到下开始执行,每次git rebase --continue执行一条,直到完成。

  3. git rebase还未结束的时候,执行git status会提示

     ```bash
     interactive rebase in progress; onto 52ef447
     No commands done.
     Next commands to do (2 remaining commands):
     reword cbf3b57 add a.txt for test git rebase
     pick 0325c7f add b.txt for test git rebase
     (use "git rebase --edit-todo" to view and edit)
     You are currently editing a commit while rebasing branch 'master' on '52ef447'.
     (use "git commit --amend" to amend the current commit)
     (use "git rebase --continue" once you are satisfied with your changes)
     ```
  4. 最后完成的时候会提示Successfully rebased

注意,多人合作的情况下,压制不应包含已push的commit,因为其他人可能已经pull了你准备压制的commit,如果你再压制,其他人可能需要做非常麻烦的修改才能同步.

问题

  1. 暂停commit等的意义是什么

  2. 取消git rebase事务是用git rebase –abort?

5.6 git push:推送

默认是推送当前所在的分支.注意如果在推送的同一时刻有其他人也在推,那么自己的推送就会被驳回,需要先合并别人的更新再推送.

参数说明:

  • -f:用于强制推送,比如本地进行过压制操作,可能导致远程服务器上有本地没有的commit此时普通的push会被拒绝,需要加上该参数.

推送到远程的某个分支(不关联):git push <远程仓库名> <远程分支名>,如果远程没有该分支会自动创建.

关联:关联了之后拉取和推送可以简化为git pull和git push,会自动拉取或推送到关联的分支,很方便.现在新分支第一次推送的时候必须手动关联一个远程分支.

  • 分支关联:git branch --track <本地分支名> <远程仓库名>/<远程分支名> or git branch --set-upstream-to=origin/<branch> feature/xushike_20180918_dont_checkout_qty(待测试)

  • 关联并推送:git push -u/--track/--set-upstream-to <远程仓库名> <远程分支名>.

    # 设置为跟踪来自 'origin' 的远程分支 'hotfix/hello'
    git branch --set-upstream-to origin/hotfix/hello

6 撤销,回滚和文件恢复

6.1 git reset

用于从仓库区恢复版本

分为已push和未push两种情况。

未push

参数说明(待整理):

  • --mixed(不带参数时的默认参数):

    • git reset <commit id>或git reset <HEAD~n>:会将HEAD从当前commit指向某个commit,仅仅重置暂存区,即丢弃当前暂存区,然后将当前commit到某个commit之间的所有修改移动到暂存区,工作区的内容保持不变。此时可以直接git add然后git commit重新提交对本地代码的修改。

    • 也可以作用于单个文件,取消暂存:git reset file_name

  • --soft:保留暂存区和工作区,同时将当前commit到某个commit之间的所有修改移动到暂存区。此时可以直接git commit重新提交对本地代码的修改。

  • --hard:重置暂存区、工作区及版本库,也就是说工作区和暂存区以及某个commit之后的所有修改都会丢失,慎用!

看概念有点晕,其实结合图片和使用场景来理解就很容易,参考:https://segmentfault.com/a/1190000009658888:

  • soft就是只动repo:比如我对这次提价不满意,可以使用git reset --soft HEAD让HEAD指针回退,而暂存区和工作区可以不用动

  • mixed就是动repo还有staging(这个是默认参数):比如我想让工作区不改变,而暂存区和引用(HEAD指针)回退一次,使用git reset --mixed HEAD^

  • hard就是动repo还有staging还有working

git reset可以作用于单个文件:作用于单个文件的时候不能指定上面的三个参数(--mixed、--soft、--hard),虽然此时也是默认使用的--mixed,写法是git reset -- file_name或git reset commid_id file_name,如果作用于单个文件,则HEAD不会移动,其他和上面一样。

已push

首先看下git revert和git reset的区别: 一般情况下,git revert是生成一个新的提交来撤销某次提交,此次提交之前的commit都会被保留,revert不是让指针移回去,而是新增一个表示撤销的commit; 而git reset是回到某次提交,某次提交及之前的commit都会被保留,但是某次之后的修改都会被退回到暂存区。推送到远程的话,git revert是追加commit(会保留所有原来的commit),而git reset只能强制推送,会覆盖掉原来的commit。

对于已经push到远程的,使用reset命令可以本地回滚,但是push的时候会被拒绝,必需使用强制推送,如果是多人合作的话,强制推送可能导致别人的本地和远程不一致的问题。这种情况推荐用git revert <HEAD~n>,具体自己斟酌。

然后看下git revert的用法:默认情况下会自动提交,带上-n就不会自动提交

  1. 撤销单个commit:有两种情况

    1. 该commit是merge,此时需要借助参数-m:git revert commit_id -m num:假设当前分支(分支A)的最新commit_id是commitA,分支B的最新commit_id是commitB,把分支B合并到分支A之后生成的新的commit_id是commitC,则git revert commitC -m 1是撤销到commitA,git revert commitC -m 2是撤销到commitB。如果不指定-m参数会报错"... 是一个合并提交但未提供 -m"

    2. 该commit不是merge

      1. git revert HEAD撤销前一次commit

      2. git revert HEAD~1撤销前前次commit。比如提交了版本一、版本二、版本三,想撤销版本二但是又想保留版本三,就可以用这个。

      3. git revert commit_id撤销指定的版本

      4. git revert -n commit_id撤销指定的版本并且不自动提交

        # revert 三个commit但是又不想生成三个新的commit
        git revert -n a b c 
        git commit -m "revert a b c"
  2. 撤销多个commit

    # 撤销(A,..,B] 左开右闭
    git revert A..B
    # 撤销[A,..,B]
    git revert A^..B

撤销时的冲突解决:撤销时如果有冲突,需要解决冲突,否则需要取消这次撤销,使用git revert --abort

如何解决撤销后再merge部分代码消失的问题:在日后继续merge以前的老版本时,因为git revert是用一次逆向的commit“中和”之前的提交,因此日后合并老的branch时,导致这部分改变不会再次出现。

  1. 把之前那个revert再revert掉(待实践):找到之前revert对应的commit_id,然后按指定版本的撤销方式来撤销,这样第一次revert掉的这部分代码就会恢复回来,但这部分代码对应的commit记录不会显示出来。

也就是说revert是可以套娃的...

6.2 git checkout

它有两个功能:分支操作和文件恢复

  1. 分支操作:见分支管理部分笔记

  2. 文件恢复:

    1. 用版本库里的某个版本覆盖索引区(staged or index)和工作区(work tree)的版本,无论工作区是修改还是删除

    2. 用索引区的版本覆盖工作区的版本

文件恢复有如下多种用法

git checkout

后面不带任何参数,相当于检查工作区,暂存区,HEAD间的差别。等于git status?

git checkout -- file_name(todo)

用暂存区的文件覆盖工作区中的文件,即只撤销工作区的文件修改,对没有暂存过(tracked)的文件是不生效的。

用法

  1. git checkout -- file_name(注意不是两个下划线),省略--(double hyphen)也可以,git checkout file_name,--是为了避免路径、分支名和引用(或者提交ID)同名而发生冲突,如果冲突就必须用-- HEAD而不是只用HEAD。如果写成git checkout .,会在当前目录下用暂存区的文件覆盖工作区中的所有文件,即将文件工作区的修改全部丢弃(不包括没暂存过的文件),慎用! 还有一种情况

    # 检出所有.c文件
    git checkout -- '*.c' 
  2. 恢复删除的文件:但是会丢失该文件上所有未提交的修改

    1. 文件没有被trackedgit checkout -- <file_path>

    2. 文件已经被trackedgit checkout head -- <file_path>

git checkout commit_id file_name

和git checkout -- file_name类似,用指定提交中的文件覆盖暂存区和工作区中的文件

git checkout branch_name file_name

将其他分支repo的文件覆盖到当前分支,即将其对应文件覆盖到工作区和暂存区(注意是覆盖,不是合并)。可以使用参数-p

6.3 git restore

git reset和git checkout有点复杂了,所以git又新增了一个git restore命令专门用来恢复staged和worktree的文件,它提供更好的语义。

git restore [--worktree] aaa # 从staged中恢复aaa到worktree 
git restore --staged aaa # 从repo中恢复aaa到staged 
git restore --staged --worktree aaa # 从repo中恢复aaa到staged和worktree 
git restore --source dev aaa # 从指定commit中恢复aaa到worktree

7 草稿和储藏

7.1 detached HEAD 状态

见架构部分笔记

7.2 git stash 储藏修改

当某个分支改到一半需要切换到另一个分支时,有些文件只更改到一半,这个时候有两种解决方法:commit和stash,使用stash最好.注意新增的文件不受影响.

创建储藏:

  1. 默认,git stash:会将上一个commit之后的所有已跟踪的内容储藏起来并生成一个hash版本值,此时该stash的说明信息默认是commit message。

    1. 没有在git 版本控制中的文件,是不能被git stash 存起来的。想要存起来有两种方法

      1. 可以先将这些文件git add,然后储藏

      2. git stash -u:也会储藏未跟踪文件

    2. 不储藏暂存区的内容,git stash --keep-index

  2. 同时修改stash的说明信息 2. (不推荐)git stash save "save_remark":不支持带路径的写法,也就是会忽略掉后面的路径,将项目下的所有能储藏的都储藏起来,

    1. (推荐)git stash push -m "save_remark",优点如下

      1. 支持路径,后面如果跟上路径,只会储藏该路径下所有能储藏的。如git stash push subDir/subDir.txt

      2. 支持多种参数。比如想储藏部分文件,同时修改说明信息,可以git stash push -p -m "xxx"

  3. 只储藏为跟踪文件中的部分文件,git stash -p,进入交互式命令界面选择要储藏的文件

查看储藏:

  1. 查看stash列表git stash list,可以查看储藏版本信息.

  2. 查看具体stash里的内容:git stash show xxx,支持所有git diff的参数,比如-p

    # 查看第一个stash的变更内容
    git stash show 0 -p

恢复储藏:

  1. git stash apply <储藏的名字>从指定版本中恢复,如git stash apply stash@{3}.注意储藏是不区别分支的,也就是可以恢复到任何分支上,所以分支很多时的最佳实践是储藏时带上当前分支的信息.(新版似乎自带分支信息)。

    1. "error: unknown switch `e'"

  2. 恢复并删除储藏git stash pop [stash@{numA}]: 不指定的话(git stash pop)则默认恢复并删除最前面的储藏(stash@{0}),如果恢复的时候产生了冲突,不会删除该储藏,需要自己手动去删除。

  3. 恢复时产生了冲突,如果想全部采用某一方的更改,可以用git checkout --ours .或git checkout --theirs .

删除储藏:删除之后,其他储藏名字的号码会自动更新。

  1. 按名字删除储藏:git stash drop <储藏的名字>,比如git stash drop stash@{0}

  2. 删除所有储藏:git stash clear、git stash drop

9 git版本和标签

git标签/git tag/锚点

既然有commitid为什么还要git tag:tag可以取有意义的的名字,比commitid更易记住。

git有两种类型的标签:轻量标签(lightweight)与含附注标签(annotated),annotated标签用于发布,而lightweight标签用于私有或临时对象的labels。

  1. lightweight:对于lightweight标签,git底层不会创建一个真正意义上的tag对象,只是对某个commit的引用,可以理解为某个commmit的别名

  2. annotated:创建时带有-a(--annotate),-s或-u参数的标签称为annotated标签。对于annotated标签,git底层会创建一个 tag对象,包含创建日期、标记者名称和电子邮件、标记消息和可选的 GnuPG 签名

使用:

  1. 查看

    1. 查看所有标签:git tag,默认只会显示标签,如果想同时看annotation,可以带上参数-n99(表示查看99行的commit或annotation信息,99行妥妥地够用了)

      # 默认按名称排序
      v0.0.1-alpha
      v1.0.1
      v1.0.2
      v2.0.0
    2. 按pattern筛选标签git tag -l 'xxx',比如git tag -l 'v1.7*'

    3. 根据tag_name查看commit信息:git show <tag_name>,比如git show v2.0.0

  2. 创建标签:不带-a(--annotate),-s和-u参数时默认创建的是lightweight标签

    1. 创建lightweight标签

      1. 在最新commit上创建taggit tag <tag_name>,比如git tag v1.0

      2. 在指定commitid上创建标签:git tag <tag_name> <commit_id>

    2. 创建annotated标签:git tag -a <tag_name> <commit_id> -m <tag_message>

      git tag -a v1.0_release # 附注标签名用有意义的结尾也是最佳实践之一,比如这儿的_release
      git tag -a v1.0_release 49c4566918 -m "v1.0正式发布"
    3. 推送标签到远程:默认情况下git push命令不会把标签推送到远程Repo,所以需要手动推送

      1. 推送指定标签到远程Repo

        1. 命令一:git push origin <tag_name>

        2. 命令二:git push origin refs/tags/<tag_name>:refs/tags/<tag_name>

      2. 推送所有标签到远程Repogit push origin --tags

    4. 同步远程标签到本地git fetch 上游

  3. 删除标签

    1. 删除标签git tag -d 标签名,删除本地所有标签git tag -d

    2. 删除远程标签

      1. 命令一:git push origin :refs/tags/<tag_name>,比如git push origin :refs/tags/v2.0.0

      2. 命令二:git push origin --delete <tag_name>

  4. 检出标签:以标签的所在,新建一个分支。git checkout -b <branch_name> <tag_name>

git describe

显示离当前提交最近的(历史向后最近,而不是历史向前最近)标签的一些信息。用来描述离你最近的标签。一般是在历史commit里移动后找到自己的方向。

使用:

  1. 直接使用git describe:默认忽略lightweight标签,只会列出annotated标签。等同于git describe HEAD

  2. 一般使用git describe refA:refA可以是任何能被 Git 识别成提交记录的引用,如果你没有指定的话,Git会使用你目前所检出的位置(HEAD),它输出的结果可能是这样的:<tag>_<numCommits>_g<hash>,tag 表示的是离 ref 最近的标签, numCommits 是表示这个 ref 与 tag 相差有多少个提交记录, hash 表示的是你所给定的 ref 所表示的提交记录哈希值的前几位。

git describe --tags

# 情况1 项目没有任何tag,则会显示
fatal: No names found, cannot describe anything.

# 情况2 当前commit上有tag且带注释,则只会显示tag
v1.1.1
# 当前commit上有tag但不带注释,则显示的是这样
v1.1.1-0-gxxxx

# 情况3 当前commit距离最新的tag已经过了很多个提交了,则会显示
v1.0.0-18-g7cb5639 # 表示最新的tag是v1.0.0,距离这个tag到现在已经有18个提交,g是git的缩写(在多版本管理工具中会有用),最新的commit是7cb5639

问题:

  1. 实际使用发现它是跳着来的,不知道为啥

10 多人协作

  1. 查看每位贡献者的commit统计git shortlog:会显示commit数量和信息,按作者排序

    1. 参数--author="[user_name]":根据名字筛选

  2. 根据commit来筛选:

    1. 形如git show 5966b66

    2. 形如git log --grep=bug:搜索的方式来查找,注意如果写成不含等号的,如git log --grep "fort",则Git 将显示顺序包含字符 f、o、r、t 的 commit.

  3. README

    最后,如果你添加的任何代码更改会使项目发生极大的变化,则应更新 README 文件以向其他人说明此更改。

  4. pull request

10.1 规范

  1. 多人协作时,不要各自在自己的 Git 分支开发,然后发文件合并。正确的方法应该是开一个远程分支,然后一起在远程分支里协作。不然,容易出现代码回溯(即别人的代码被覆盖的情况)

10.2 常用术语(黑话)

  • np:no problem「没问题」

  • wfh:work from home 「在家办公」。

  • CR:Code Review 「代码审查」

  • WIP   Work in progress, do not merge yet. // 开发中。WIP可用于多个地方:

    1. WIP也可用于MR,在MR的标题带上前缀WIP:表示分支没准备好,不能合并

    2. pull请求中,表示工作还没完成,但是想提交代码,目的是:寻求初步的反馈,想使用项目的集成基础设施,比如CI

    3. WIP也可以用于分支,

  • DNM Do not merge. //不要合并

  • CL Changelist. // 修改的文件

  • CS Changeset. // 和CL 类似

  • TBR To Be Reviewed. // 提示维护者进行 review

  • TBD To Be Done(or Defined/Discussed/Decided/Determined). // 根据语境不同意义有所区别,但一般都是还没搞定的意思

  • IMO In My Opinion. //在我看来、依我看、依我所见

  • IMHO In My Humble Opinion IMO. //谦虚的说法,以我的拙见(多用于邮件和网络)

  • AFAIK/AFAICT As Far As I Know / Can Tell. //据我所知

  • FYI For your information. //供你参考

  • AFK Away From the Keyboard. //稍后回来

  • IANAL I am not a lawyer, but I smell licensing issues. // 我不是律师,但是我闻到了许可问题

  • LGTM Looks good to me. // Riview 完别人的 PR ,没有问题。通常出现在 PR 的评论里,表示对提交者的赞许,鼓励他更多的参与贡献。正如语气 在我看来很好 所以大多是审核者或者项目所有者对贡献者的鼓励,请在评论别人的 PR 时斟酌一二。

  • SGTM Sounds Good To Me.

  • PTAL Please take a look. // 帮我看下,一般都是请别人 review 自己的 PR

  • CC Carbon copy // 一般代表抄送别人的意思

  • RFC  —  request for comments. // 我觉得这个想法很好, 我们来一起讨论下

  • IIRC  —  if I recall correctly. // 如果我没记错

  • ACK  —  acknowledgement. // 我确认了或者我接受了,我承认了

  • NACK/NAK — negative acknowledgement. // 我不同意

  • TL;DR Too Long; Didn't Read. // 太长懒得看。也有很多文档在做简略描述之前会写这么一句

10.3 git fork

和clone不同,fork会copy一份代码到自己名下的远程仓库,fork这个动作没什么好讲的,主要说下fork相关的工作流程。

一般流程是这样:

  1. fork代码,clone,此时本地代码地址是.../myNameA/projectA,orgin是.../myNameA/projectA

  2. 肯定要和原作者的仓库同步,所以需要再设置一个源绑定到原作者的仓库:git remote add upstream source_rep_url,比如git remote add upstream https://github.com/xushike/toy.git

  3. 和原仓库同步

    1. git fetch upstream,也可以git fetch --dry-run先检查远端是否有变动

    2. 然后选择想要合并的分支,比如想把develop合并到当前分支,可以git pull upstream develop

  4. 提交MR到原仓库

    1. 先add,commit自己本地的修改,过程中最好使用rebase(待补充)

      1. rebase可以将多个commit合并成一个,会让Code Review非常直观

    2. 和原仓库同步:确定你这次提交之前与你最后一次拉代码的时候没有人提交,如果有,这时候需要再拉一次代码

    3. 可以直接以当前分支(比如featrue分支)提MR,也可以合并到自己的主分支(比如develop)再提MR

如何同步upstream上新增的分支呢:

  1. 本地建立同名分支:git checkout -b branchA

  2. 然后拉取upstream的同名分支到本地git pull upstream branchA,done

可以fork空仓库吗:似乎不行,好像必须要有README.md或者lisence文件(待验证)

其他命令

git fsck:文件系统检测

git fsck --lost-found:找回git add过但是已经不存在文件中的内容。可以通过运行 git show commit_hash查看提交之后的改变或者运行git merge commit_hash来恢复到之前的提交。git fsck 相对reflog是有优势的,比方说你删除一个远程的分支然后关闭仓库,用fsck 你可以搜索和恢复已删除的远程分支。

git gc

git gc 将“重复的”松散的对象变成一个单独的包文件,除非以任何方式压缩文件都不会使生成的包文件有显著差异。

git bundle

参考:https://git-scm.com/book/zh/v2/Git-%E5%B7%A5%E5%85%B7-%E6%89%93%E5%8C%85

bundle 命令会将 git push 命令所传输的所有内容打包成一个二进制文件,你可以将这个文件通过邮件或者闪存传给其他人,然后解包到其他的仓库中。

git bisect 二分法定位问题

参考:http://www.ruanyifeng.com/blog/2018/12/git-bisect.html

四 高级

1 git submodules

参考:

  1. http://www.ayqy.net/blog/%E7%90%86%E8%A7%A3git-submodules/

使用场景:待补充。

添加submodule到主模块: git submodule add path1.git path2,path1.git是submodule的仓库地址,path2是当前项目中submodule的路径。可以添加多个submodule,添加完之后会在当前目录生成.gitmodules文件,记录了每个submodule的引用信息--在当前项目的位置以及仓库的所在,大概内容如下

[submodule "libs/lib1"]
    path = libs/lib1
    url = /home/henryyan/submd/repos/lib1.git

然后推送.gitmodules和path2的改动就算添加完成。注意:

  1. 不要在.gitignore文件中ignore 子模块目录,不然会跟踪不到子模块。

  2. 需要同时提交.gitmodules文件和子模块的commit修改,不然会导致子模块添加不上。

clone带有submodule的仓库:普通clone下来的时候,里面的submodule只有表示坑位的空目录而没有内容。

  1. git submodule:查看submodule的状态,如果显示hash码和文件目录,且文件目录前有减号,表示子模块还没检出.类似

    -c22aff85be91eca442734dcb07115ffe526b13a1 libs/lib1
  2. git submodule init:初始化,会创建本地配置.git/config,记录仓库地址。在clone含有submodules的repo后,需要进行初始化。

    1. 实测会提示子模 xxx 未对 路径 xxx 注册,似乎可以不用管

  3. git submodule update:更新子模块

    1. --init:git submodule update --init等同与git submodule init+git submodule update

    2. --remote:会拉取子模块对应分支的最新代码,如有更新,占位目录的git状态会发生变化。不加该参数,则拉取的是当前依赖的版本。每次执行git submodule update --remote后,子模块会处于detached状态。

      1. 官方解释是:It’s also important to realize that a submodule reference within the host repository is not a reference to a specific branch of that submodule’s project, it points directly to a specific commit (or SHA1 reference), it is not a symbolic reference such as a branch or tag. In technical terms, it’s a detached HEAD pointing directly to the latest commit as of the submodule add.大概翻译就是对子模块的引用是引用的特定的提交,而不是特定的分支。

    3. --recursive:递归更新,子模块所依赖的子模块也会更新。

改动子模块的代码:

  1. 可以直接去子模块的项目地址修改,也可以去主模块中子模块的路径修改。如果是在主模块中,要切换到子模块所在路径,此时注意切换分支(通常是detached状态),改动后推送到子模块的远程。

更新主模块所依赖的子模块版本:例子如下

```bash
# 在主模块里
git add sub_module
git commit 
git push
```

删除子模块:git submodule deinit

更新子模块的URL:git submodule sync [--sub_module],根据文档可知,我们需要先更新.gitmodules和.git/config中的URL配置,然后执行该命令。

当子模块很多时,可以加上foreach参数来对每个子模块执行相同的命令。如git submodule foreach 'git checkout -b featureA'

2 git flow

git flow是git的扩展,基于Vincent Driessen的https://nvie.com/posts/a-successful-git-branching-model,

2.1 分支命名参考

大概围绕以下几种来命名

  • master:主分支

  • hotfix:热修复

  • release:发布分支

    • stable:稳定的发布分支

  • develop:开发

  • feature:功能分支

2.2 分支详解

master分支:master分支上存放的应该是随时可供在生产环境中部署的代码。 当开发产生了一份新的可供部署的代码时,master分支上的代码会被更新。同时,每一次更新,添加对应的版本号标签(TAG)。

  1. master分支是保护分支,不可直接push到远程仓master分支

  2. master分支代码只能被release分支或hotfix分支合并

develop分支:用作平时开发的主分支,并一直存在,永远是功能最新最全的分支。 feature,release分支都是基于develop分支建立的。feature,release,hotfix分支最终都要合并到该分支,保证该分支拥有最全的代码。

  1. develop分支是保护分支,不可直接push到远程仓库develop分支。

  2. develop分支不能与master分支直接交互。

feature分支:用于开发新功能。都是基于develop分支建立。如果该分支需要多人协作,那么需要将该分支push到远程,否则保留在本地即可。功能开发完成之后要合并到develop,并且将该分支进行删除,防止分支爆炸。

  1. 每个feature颗粒要尽量小,因为它需要我们能尽早merge回develop分支,否则冲突解决起来就没完没了。

release分支:用于发布准备的专门分支。要发版本的时候建立该分支并且指定版本号。该分支将用来测试以及改bug。 release 分支上的代码要合并到master 分支和 develop 分支。合并到master分支要打tag。分别合并后,可以选择是否删掉release分支,如果不删,也不能再在此分支上进行后续开发。

  1. release分支可以从develop分支上指定commit派生出

  2. release分支一旦建立就将独立,不可再从其他分支pull代码

stable:个人理解是长期的release分支,比如软件同时存在多个版本就可以用stable分支。

hotfix分支:用于修复线上代码的bug。基于master分支建立,完成之后先合并到 master然后打上tag,再合并到develop 分支

  1. 实际使用中可能hotfix需要从dev分支cherry-pick出来的,流程大概是这样:

    1. 基于master分支建立hotfix

    2. 从dev分支cherry-pick到hotfi

    3. 合并hotfix到master并打上tag,然后验证master的代码,验证通过为止

    4. 从dev分支cherry-pick到hotfix后如果没有冲突也没有新增什么修改,master此时是可以直接合并到dev的。但实际情况不会这么简单,实际从dev分支cherry-pick到hotfix,其中可能有冲突,解决冲突后代码可能和dev的原commit不一样了。cherry-pick后可能还需要新增一些修改。这个时候需要从dev切一个resolve_conflict的分支

      1. merge master到resolve_conflict

      2. merge resolve_conflict到dev

    5. 然后dev可以直接merge到master了

5 相关文件

.gitignore

参考:

  1. 各种语言的gitignore示例:https://github.com/toptal/gitignore

该文件只能作用于 Untracked Files,也就是那些从来没有被 Git 记录过的文件(自添加以后,从未 add 及 commit 过的文件)

规则:

  • /开头表示匹配仅匹配当前目录下的,以/结尾表示匹配目录

  • 星号*通配多个字符;

  • 问号?通配单个字符

  • 方括号[]包含单个字符的匹配列表;

  • 叹号!表示不忽略(跟踪)匹配到的文件或目录;

    !.gitkeep # 绕过跟踪空目录的限制

使用:

node_modules # 匹配所有名称为node_modules的文件,目录,链接
/node_modules/ # 仅匹配当前目录下名为 node_modules 的目录
node_modules/ # 匹配所有名为 node_modules 的目录,包括当前目录及所有子目录

conf*/
/dir/* # 匹配当前目录下dir目录里的所有内容(但不包括 dir 目录本身)

规范顺序和范围:git 对于.gitignore配置文件是按行从上到下进行规则匹配的,意味着如果前面的规则匹配的范围更大,则后面的规则将不会生效;

里面可以写注释,使用#

.gitattributes

参考:https://git-scm.com/docs/gitattributes

格式为

pattern        attr1 attr2 ...

属性和值

  1. text:该属性控制index区中文本文件的行结尾标准化。当一个文本文件被标准化时,它的行尾标准化为LF。如果未启用该属性,Git 使用core.autocrlf配置变量来确定文件是否应该转换

    1. 启用该属性但未设置值:标记pattern为文本文件,并启用行结尾标准化。不管index区的文件是什么行结尾,签入签出的时候都会标准化为LF

    2. text=auto:由git自行判断是否为文本文件,对于文本文件,如果是CRLF且未添加到git,则在文件签入时,行结尾标准化为LF;如果是CRLF但已添加到git,则在文件签入时,不执行操作,保持CRLF不变。(待验证)

  2. eol: 该属性控制工作目录中使用的行结尾风格。(另外,还可以使用git的core.eol配置和core.autocrlf配置来控制)

    1. eol=crlf:签出文件时行结尾标准化为CRLF

    2. eol=lf:签出文件时行结尾保持与index区中一致(如果index区中的文件是CRLF,签出时是CRLF;如果index区中的文件是LF,签出时是LF)

  3. diff

优先级

  1. 同一个.gitattributes文件中,遵循覆盖原则,即后面的行会覆盖前面的设置

  2. 多个.gitattributes文件优先级: todo

.gitattributes文件的eol属性、git的core.eol配置和core.autocrlf配置的区别:eol属性只对符合pattern的文件生效,core.eol对所有文本文件生效。优先级.gitattributes > core.autocrlf > core.eol

常用操作:

  1. 向已有项目加入.gitattributes文件

    1. 把工作区未完成的内容放到stash

    2. 新增.gitattributes文件并推送,比如我的是

      * text=auto eol=lf
      *.{cmd,[cC][mM][dD]} text eol=crlf
      *.{bat,[bB][aA][tT]} text eol=crlf
    3. 执行以下命令来更新本地文件

      git rm --cached -r .
      git reset --hard 
      # 实测,index是LF的文本文件在工作区变成LF了,index是CRLF的文本文件在工作区变成了CRLF,符合预期

6 github pages

用来做网站的

7 .git目录

五 经验

1 已整理

  1. Git上手并不难,深入学习还是建议多实践

  2. 虽然做了这么多笔记,但是最佳实践还是使用工具,比输命令可靠

  3. 记住,在 Git 中任何 已提交的 东西几乎总是可以恢复的。--git官方book

  4. stackoverflow大牛说的多人合作注意事项:

    • 不要用强制推送

    • 不要破坏commit history和别人的pull

  5. 只想获取远程仓库的所有变动信息,而不想合并任何分支:使用git fetch,而不是git pull,后者会做git merge。

2 推送的正确做法

  1. 先commit

  2. 然后pull(如果没有commit就pull,当pull和本地修改的文件冲突时会提示“和本地文件有冲突,需要先commit”,此时先commit然后pull),

  3. 如果pull后文件冲突,需要解决冲突

  4. 然后push

3 .gitkeep

它不是官方git的一部分,而是大家约定成俗的一种习惯.因为linus最开始把git的快照设计成只由文件组成,导致git不跟踪空文件夹(算是设计失误吧),然后想到反正我们能用假文件来占位,所以最后也没改它.

后来大家想跟踪空文件夹,就在空文件夹里面放一个.gitkeep空文件,会被解析成占位符.当然,放其他文件(.nofile,.gitignore等任意空文件都可以)也可以

六 问题

1 已解决

1.1 git pull 时cannot lock ref ...

  1. 第一种可能:就是我经常遇到的,网络或者什么不太重要原因,会出现这个,再git pull一下就好了.

1.3 You have not concluded your merge (MERGE_HEAD exists)

原因可能有多种.我当时大概是先push了一次,然后使用修改了一些文件然后使用git commit --amend并且修改了commit信息,然后push,然后pull下来有冲突,然后我合并并且解决了冲突,但这个时候就出问题了,我把解决完的那个文件加入暂存区,结果暂存区里没有那个文件,然后不管执行pull还是push都提示这个错误.重新试了一次还是这样,估计不是冲突的原因,而是git commit --amend相关操作出错了.

因为我本地的修改是最新的,可以舍弃远程的,所以先git push -f强制推送,然后git pull还是报错,于是再执行git reset HEAD,就不会再报错了.但是注意此时不能再用git commit --amend命令,如果想用的话必须另外push一个新的commit然后再用.

1.4 如果你在创建.gitignore文件之前就已经push项目了,那么即时你在.gitignore文件中写入新的规则,这些规则也不会起作用。

如果文件曾经被 Git 记录过,那么.gitignore 就对它们完全无效.

解决方法就是先把本地缓存删除(改变成未track状态),然后再提交,比如

git rm -r --cached <文件路径>
git commit -m 'update .gitignore'

如果还是不行的话,在先将想要取消追踪的文件移到项目目录外),并提交,然后提交后再将刚刚移出的文件再移入项目中即可

1.5 unable to get credential storage lock: File exists

我当时出现这个问题可能是因为我配置了凭证助手,但github的账号密码和gitlab的账号密码不一样,所以git pull后提示我输入gitlab的密码,我输入之后就出现这个错误.

最后我取消了凭证助手就好了.

1.6 Your configuration specifies to merge with the ref 'refs/heads/master' from the remote, but no such ref was fetched.

我当时出现这种情况是github上新建了一个空的项目,然后clone,然后pull就会报这个错

1.7 fatal: unable to access 'https://xxx': Empty reply from server

我当时是重装系统后没有配置user.name和user.email出现的这个问题

1.8 文件内容没变,但是git显示文件的被修改

因为文件的权限被修改了.可以设置忽略检查文件的权限:git config core.filemode false

1.9 Permission denied (publickey)...

git协议需要配置ssh key并且上传到服务器上

1.10 拉取很久没更新的项目,一直卡在“展开对象中”

可能原因:待补充

解决办法1:删除项目,重新clone

1.11 git stash pop出现:xxx already exists, no checkout Could not restore untracked files from stash

可能原因1:做了一些骚操作,比如混合了新增、修改、拉取等,导致最后stash之后恢复不了了。

解决办法1:确保文件没问题的情况下,强制恢复git checkout stash -- .,参考:https://stackoverflow.com/questions/16606203/force-git-stash-to-overwrite-added-files

1.12 WARNING: POSSIBLE DNS SPOOFING DETECTED

The ECDSA host key for gitlab.hztl3.xyz has changed,
and the key for the corresponding IP address 124.239.245.251
is unknown. This could either mean that
DNS SPOOFING is happening or the IP address for the host
and its host key have changed at the same time.

服务器迁移了,这个域名对应的IP地址已经变了,需要去~/.ssh/known_hosts把原来的删除,然后重新操作git。

1.13 无法克隆 xxx 到子模组路径 xxx

.gitmodules子模块的路径用的ssh路径,但实际上是https路径,所以需要修改成https路径

1.14 fatal: early EOFs fatal: index-pack failed

原因可能是codebase太大,有以下几种解决方法:

  1. 设置core.compression为默认值,git config --add core.compression -1或者git config --global --add core.compression -1,具体可以参考git config --help

    1. zlib压缩对变化显著的二进制文件似乎效果不好。

  2. 不用https的方式,而直接使用ssh的方式。(实测可行)

  3. shallow clone:git clone --depth depth remote-url

1.15 Unable to create 'XXXXXX/.git/index.lock': File exists.

解决方法:找到index.lock 删除即可

1.16 fatal: 您位于一个尚未初始化的分支

待解决

1.17 查看某个commit包含在哪些分支里

git branch -r --contains COMMIT_ID

1.18 git默认对文件名大小写不敏感

方法一:用git重命名

  1. 重命名文件:git mv a.txt A.txt

  2. 重命名文件夹: git mv foldername tempname && git mv tempname folderName (在大小写不敏感的系统中,如windows,重命名文件夹的大小写,使用临时文件名)

方法二:也可以设置 git config core.ignorecase false使其对大小写敏感,但是提交上去会被认为是重写,多人协作可能就差生了冲突。所以在大小写敏感的情况下,可以先备份文件,然后删除文件在重新提交。

1.20 换行符

文件中换行的地方出现大量^M

出现原因:三大系统的换行符不一样

  • 在windows下的文本文件的每一行结尾,都有一个回车()和换行(),就是CRLF

  • 在linux下的文本文件的每一行结尾,只有一个回车(),是LF

  • 在Mac下的文本文件的每一行结尾,只有一个换行(),也是LF

所以在windows下编辑linux(或者在Linux下编辑Windows)打开过的文件可能会在结尾的地方出现"^M"

几个解决方案:推荐几个方案混合使用 方案一:使用core.autocrlf配置。GitHub suggests that you should make sure to only use \n as a newline character in git-handled repos. 推荐设置git config --global core.autocrlf xxx(xxx的值取决于你的开发环境系统)

git config core.autocrlf有三个值:

  • true(默认值): 文件在本地检出为 CRLF,但是每当你提交文件时,CRLF 的所有实例都将替换为 LF。此设置确保你的代码库在所有文件的最终版本中始终使用 LF,但在获取时在本地使用 CRLF。windows开发人员推荐使用该设置。

  • false:不做任何转换,文本保持本来的样子。通常不建议使用这个值(除非是团队中的每个人都使用相同的操作系统)

  • input: 如果一个文件最初被 Windows 开发人员提交的,你会在本地看到它是 CRLF(后续你再编辑这个文件,会强制让它变成LF)。如果文件已经是LF了,后续操作依然还是LF。Mac/Linux 开发人员推荐使用该设置

input 和 ​​true值唯一区别是git会不会在本地获取文件时处理行尾。

具体应该设置哪个值呢?看场景:

  1. 在windows下新建了文件,提交时出现"warning: CRLF will be replaced by LF in fileA. The file will have its original line endings in your working directory"。这并不是说出现问题, Git 只是警告你,你的 CRLF 行结尾将在提交时规范化为 LF,如果不想看到这个警告,把core.autocrlf设置为input(因为主流的跨平台文本编辑器都支持 LF,所以可以这么修改),然后删除fileA重新clone就好了。

方案二:使用.gitattributes文件,文件内容如下

* text=auto eol=lf
*.{cmd,[cC][mM][dD]} text eol=crlf
*.{bat,[bB][aA][tT]} text eol=crlf

git使用一种简单的算法来检测你的 repo 中的特定文件是文本文件还是二进制文件(例如,可执行文件、图像或字体文件)。默认情况下,此算法用于比较已更改的文件,但它也可以用于强制行尾约定。第一行的含义参考``部分笔记,后面两行则是让win的批处理文件CRLF行结尾

提交此文件后,使用git add --renormalize .命令来重新格式化所有之前添加的文件。但是这个方案也不够完美,因为win本地的文件依然是CRLF行结尾,如果用了linting工具(比如ESLint等),可能会提示烦人的行结尾警告,这个时候也可以考虑方案三。

方案三:使用.editorconfig 文件,该文件旨在创建用于自定义任何给定文本编辑器行为的标准化格式。许多文本编辑器(包括 VS Code,IDEA,GitHub)支持并自动读取此文件(如果存在)。格式如

root = true

[*]
end_of_line = lf

这样,我们用支持的编辑器创建一个新文件,它将始终LF行结尾。

最后,可以使用git ls-files --eol来显示git跟踪的所有文件的行尾信息,格式如下:

i/lf    w/crlf  attr/text=auto eol=lf   fileA.txt

从左到右分别是:

  • i:索引中的行尾(被推送到你的仓库的行)

  • w:工作树中的行尾

  • attr:适用于此文件的 .gitattributes 规则

  • 文件名

1.21 windows下git log中文乱码

方法1:在系统环境变量里增加LESSCHARSET=utf-8,然后重启相关的IDE就行了。 方法2:更新git版本

参考:https://stackoverflow.com/questions/53012504/what-does-the-warning-redirecting-to-actually-mean

可能原因:

  1. 远程仓库的地址没有以.git结尾

1.23 Git :fatal: refusing to merge unrelated histories

原因是两个分支是两个不同的版本,具有不同的提交历史,解决方法是加上--allow-unrelated-histories允许不相关历史强制合并

1.24 git vim中文乱码的问题

windows上git log、git diff等命令显示的中文是正确的,但是git commit --amend、git rebase -i head~1等命令显示的中文是乱码。发现使用后面两个命令的时候是是用的vim编辑器打开,而windows的vim是我安装git的时候附带的,git的安装目录是C:\Program Files\Git,vim目录在C:\Program Files\Git\usr\bin。不过使用git附带的which命令查看which which、which vim的时候,显示的是/usr/bin/which和/usr/bin/vim这里which以C:\Program Files\Git为根目录,搞不懂(猜测可能是git默认设置的吧)。要修改vim的配置文件,就要去修改C:\Program Files\Git\etc\vimrc文件,具体参考vim笔记部分

1.25 git rebase upstream/master vs git pull --rebase upstream master

参考:https://stackoverflow.com/questions/15602037/git-rebase-upstream-master-vs-git-pull-rebase-upstream-master

1.26 Failed to connect to 127.0.0.1 port 10010: Connection refused

开了代理导致的,

# 查看代理
env|grep -i proxy
ALL_PROXY=socks5://127.0.0.1:10010

# 取消代理
unset ALL_PROXY

1.27 Could not resolve host: github.com

应该是DNS污染

  1. 需要自己修改hosts

  2. 或者刷新DNS缓存sudo killall -HUP mDNSResponder(mac不同系统命令不一样)

1.28 fatal: 不支持 'https' 协议

在我git remote add upstream xxx之后出现的,应该是xxx的地址写错了,git remote rm upstream然后重新git remote add upstream xxx就好了

1.29 ... SSL_ERROR_SYSCALL ...

多试几次

1.30 OpenSSL SSL_read: Connection was reset, errno 10054

错误原因可能是网络不稳定,连接超时。如果试了多次还是报这个错误,建议执行这个命令``

同样的错误还有"Failed to connect to github.com port 443 after 21105 ms: Timed out"

2 未解决

2.N 其他

  1. git 可以只clone分支而不是master吗?

  2. win7 64位旗舰版下使用git reset --hard HEAD^无法恢复到上个版本 网友的回答是:

    你用的shell把^当做换行转义了, 类似于\; 使用"包起来即可, 如: git reset --hard "HEAD^" 也可以用~代替, 如: git reset --hard HEAD~1

  3. unknown revision or path not in the working tree. 我是自己新建的仓库,然后直接add了一些文件,并没有commit,然后调用git reset HEAD命令出现的这个错。后面了解了git三棵树和该命令原理之后明白了:是因为初始化后没有commit,HEAD就是空的,所以无法移动HEAD指针。这种情况下,可以直接git reset [path],因为这个命令可以跳过"移动HEAD指针"这一步,直接把HEAD复制到index

  4. 关于HEAD和分支指针的那张图片,一目了然

  5. git是如何判断冲突和不冲突的,界限在哪儿?

  6. 在maste分支上写了东西,然后想提交到develop分支上

  7. git的feature

  8. github的提交请求是怎么操作

  9. --global 使用全局配置文件 --system 使用系统级配置文件 --local 使用仓库级配置文件

  10. 可以绑定多个远程仓库吗?

  11. ip前的git和https有什么区别

  12. git提交多了会导致变慢吗?

  13. global和本地都配置了,则优先使用的哪个?

  14. git的分支合并等操作

  15. 笔记

  16. git hook

  17. merge的时候,保存信息时不知道怎么操作,最后出现Merge made by the 'recursive' strategy.

  18. vscode的git没有显示远程有多少个更新的pull是什么情况

七 待整理

  1. 有时项目会对特性分支的命名有特定要求。例如,如果一个分支将要解决错误修复,那么许多项目会要求添加一个 bugfix- 前缀。回到我们处理登录表单错误的分支,它得被命名为 bugfix-login-form。

  2. RawGit 作为一个缓存代理,提供的功能是缓存 GitHub 中 raw 文件并添加上正确的 Content-Type header,从而使文件能被浏览器正确渲染。

RawGit 对未开通 GitHub Pages 的项目中的任意 HTML/CSS/JS 文件以及 Gist 代码的渲染展示提供了方便。

使用方法:https://rawgit.com/ 或 https://raw.githack.com/

  1. 如何查看其他人提交的更新

  2. gitlab的clone需要权限吗

  3. feature分支和普通分支的区别是啥?

  4. Git的奇技淫巧🙈:http://www.cnblogs.com/xueweihan/p/5703144.html

  5. https://blog.csdn.net/mrleeapple/article/details/50488455

Previous9.pictureNext1.gitbook

Last updated 8 months ago

Was this helpful?

git的官方中文book,应该大部分问题都能在上面找到答案,推荐阅读,但是有些内容并不生效(?):

方式三:在下载安装

官方参考资料:

一图胜千言:

1.22 拉取gitlab远程仓库的时候出现 redirecting to https://projectA.git/

Pull Request 的命令行管理:

网友的文章:

关于ssh的配置,可参考官方文档:

网友的一些总结,感觉写的不错:

⚠️
https://git-scm.com/book/zh/v2
https://git-scm.com/download/mac
https://git-scm.com/book/zh/v2/Git-工具-重置揭密#_git_reset
http://www.ruanyifeng.com/blog/2017/07/pull_request.html
https://segmentfault.com/a/1190000011168654
Pro Git(中文版)
https://help.github.com/articles/connecting-to-github-with-ssh/
http://classfoo.com/ccby/article/j4HZbSN