Change My World by Program

0%

Git 手册

发表于 更新于 分类于 Disqus：

Git指南

这里所列举的通用配置无论是在Windows还是Linux，都要用到。

安装与配置

安装Git软件

Windows平台：Git for Windows(在安装的时候注意那些选项的设置)

Linux平台：sudo apt-get install git

基础配置

打开终端，在windows平台就用上一步安装上的git bash

1
2
3
4
5
6
7
8
9
10
11
12
13
# 全局配置，这里的用户名和邮箱填写你自己的帐号，可以是github上的帐号信息
git config --global user.name "haoflyent"
git config --global user.email "haoflynet@gmail.com"

# 如果要同一台机器多个git账户，那么可以取消全局设置
git config --global --unset user.name
git config --global --unset user.email
git config user.email "x@xx.com"    # 在仓库里面单独设置
git config user.name "xx"

# 生成密钥
ssh-keygen -t rsa -C "haoflynet@gmail.com"
# 然后一路默认就可以，注意看其中的密钥存放位置，其中公钥文件Windows默认为/c/Users/用户名/.ssh/id_rsa.pub# Linux默认为 ~/.ssh/rsa_pub

Git相关文件

.gitkeep: 这个文件当前所在的空目录可以加入到版本控制里面去

Github的使用

打开公钥文件，然后复制其中的内容到Github上的setting->SSH keys->Add SSH key，如下

点击Add Key后会要求输入github密码，因为这是特别敏感的操作
然后进行新建仓库，无论是github还是其他托管网站都可以新建远程库，新建完成后都会提示你下一步该怎么做

按照上图给出 操作指南，有三种方法分别是

  • 在本地建立一个新库，并新建一个README.md到远程库
  • 直接将本地库的代码推送到远程库，不过在本地需要将文件夹编程一个库
  • 从别的库导入代码到该库
    具体的命令在途中均有给出

常用操作

日志/历史/版本

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
GIT_CURL_VERBOSE=1 GIT_TRACE=1 git ...	# 相当于debug，能看到git命令执行期间的状态

git remote -v 	# 列出远程仓库地址
git remote set-url origin git@xxx.git	# 修改git远程仓库地址
git remote add author git@xxx.git	# 添加一个远程仓库地址
git pull author master:origin/master	# 从指定远程仓库拉取分支合并到本地分支

git log  # 查看提交的历史,--oneline按行显示，--graph查看分支的合并情况，--all显示所有分支的历史
git reflog	# 查看HEAD的历史情况

# 版本回退/回滚,--hard表示将该次提交之前所有的更改都丢弃，git reset是把HEAD向历史移动，之后的所有提交都会删除掉，而git revert是HEAD继续向前，新的commit就和revert的内容刚好相反，所以推荐使用revert，reset的target是要会退到的版本，而revert得target是要取消的版本
git reset --hard HEAD^  # 回退到上一个版本
git reset --hard HEAD^^ # 回退到上上个版本
git reset --hard 233333 # 指定提交ID的回退
git push -f origin master	# remote端也更新

git verify-pack -v .git/objects/pack/<SHA-1-code>.idx | sort -k 3 -n | tail -n 20 # 找出git提交历史中有大文件的提交
git rev-list --object --all | grep commit_id	# 找到某次上面列出的某次提交中提交的文件

代码更改

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
git blame filename   # 查看某文件的改动历史
git diff + 分支名/commit_id   # 比较当前分支和目标分支的不同
git diff master
git diff 分支名 -- filename	# 比较不同分支的指定文件的不同

git reset HEAD filename		# 把已经commit了的文件取消暂存
git checkout -- filename	# 放弃指定文件的更改
git commit --amend			# 撤销上一次提交，并将暂存区文件重新提交。当然如果没有git add，直接执行这条命令就相当于修改message

git stash					# 暂存，常用于要切换分支，但是当前分支上面的更改并不想现在提交，需要先把当前分支的状态暂存起来。暂存起来后就可以自由切换到其他分支了。
git stash -p	# 以交互的方式确定每一个修改是否需要stash
git stash list				# 查看所有的"储藏"
git stash apply				# 应用最近一次的“储藏”
git show stash@{1}			# 查看stash
git stacsh apply stash@{2}	# 应用指定的"储藏"

分支操作

分支命名规范:

  • 功能(feature)分支: feature-*
  • 预发布(release)分支: release-版本号
  • 修补bug(fixbug)分支: fixbug-*
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
git fetch						# 取回所有分支的更新
git fetch -p					# 取回远程分支，并且在本地删除远程已经删除的分支
git branch -a  					# 查看所有分支
git branch -D dev				# 删除本地分支
git checkout -b new-branch 		# 在本地新建分支并切换到新分支
git checkout -b dev origin/dev	# 拉取远程分支到本地并命名为dev分支
git push origin :serverfix		# 直接删除远程分支

## 强制覆盖本地分支
git fetch --all
git reset --hard origin/master

## 合并分支
### 在新的分支如bug-fix修改完成后，执行以下操作
git checkout dev	# 切换回dev分支
git merge bug-fix	# 将bug-fix合并到当前分支，即dev分支

变基(rebase)

  • 简单地说就是将多个commit合并为一个commit，以使提交历史变得干净整洁。
  • 最好不要修改已经push过的提交进行修改，如果一定要修改，需要使用git push -f origin 分支名进行推送以覆盖历史提交，对于还没合并进主分支的提交，其实也还可以，但是一定要慎重。
  • 需要注意的是变基后提交的hash会改变
  • 可以使用git filter-branch --treefilter 'rm -f password.txt' HEAD命令对整个版本历史中的每次提交进行修改，可以以此来删除误提交的敏感信息

例如，我在本地新建了一个文件，并且先后对文件进行了三次修改操作，但是我想将更新操作合并。通过git log --oneline查看本地的提交历史如下:

1
2
3
4
4721d5f update readme file
c4cd33c update readme file
31cf944 update readme file
7c040d1 add readme file

为了防止合并多次或者多个冲突，在rebase之前最好先git fetch origin master将远程分支的提交log拉取下来。

接下来，我就使用rebase命令编辑提交历史:git rebase -i [startpoint] [endpoint]，其中-i参数表示交互式界面，后面两个参数表示指定一个编辑区间，如果不提供，那么startpoint默认为当前已经提交到远程仓库的最后一次提交，endpoint为当前为提交到远程仓库的最后一次提交，是一个左开右闭区间。我这里直接执行git rebase -i 7c040d1(一般情况下只需要git rebase origin/master即可)表示只合并最后三个提交。会弹出下面这个交互式页面:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
pick 31cf944 update readme file
pick c4cd33c update readme file
pick 4721d5f update readme file

# Rebase 7c040e1..4721d5f onto 7c040e1 (3 commands)
#
# Commands:
# p, pick = use commit	保留该commit
# r, reword = use commit, but edit the commit message 保留该commit，但是修改commit的注释
# e, edit = use commit, but stop for amending 保留该commit，但是要停下来修改该次提交
# s, squash = use commit, but meld into previous commit	将该commit和前一个commit合并
# f, fixup = like "squash", but discard this commit's log message 将该commit和前一个commit合并，但是不保留注释信息
# x, exec = run command (the rest of the line) using shell 执行shell命令
# d, drop = remove commit 丢弃该次commit
#
# These lines can be re-ordered; they are executed from top to bottom.	需要注意的是rebase操作是从上往下执行，也就是从最新的commit到最开始的commit执行
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#
# Note that empty commits are commented out

其中开头几行为几次提交的信息，下面的则是操作说明。我现在直接将上面的提交信息修改为

1
2
3
pick 31cf944 update readme file
s c4cd33c update readme file
s 4721d5f update readme file

然后:wq保存即可。现在查看提交历史就变成了这样

1
2
2783433 update readme file
7c040e1 add readme file

标签

1
2
3
4
5
git tag 									# 查看当前所有的标签
git tag v1.0.0							# 在当前commit打一个标签
git tag -d v1.0.0						# 删除一个标签
git push origin v1.0.0					# 将打的标签推送到仓库
git push origin :refs/tags/v1.0.0		# 本地删除标签后远程也要删除

其他功能

1
2
# 统计代码行数
git log --author="$(git config --get user.name)" --pretty=tformat: --numstat | gawk '{ add += $1 ; subs += $2 ; loc += $1 - $2 } END { printf "added lines: %s removed lines : %s total lines: %s\n",add,subs,loc }' -

贡献PR(Fork别人的项目)

如果希望给开源项目贡献代码或者直接修复bug，那么就需要涉及到fork了并提交了。步骤如下:

  1. fork别人的仓库到自己这里: 直接在github里面点击fork，即可在自己的代码仓库里面创建一个一模一样的仓库。

  2. 从自己的代码仓库clone下来，并开发。

  3. 开发完成后，commit到自己的代码仓库

  4. 在自己的项目创建Pull Request，指向到原开源项目中去。

记得添加commit说明。

多人协作

参考文章：廖雪峰的官方网站
前提：已经在Github上创建了库并创建了一个新的分支，假设新分支名为dev，那么开发步骤如下：

  1. 抓取远程分支到本地

    1
    2
    3
    4
    5
    git clone git@github.com:haoflynet/test.git
    git branch      # 查看当前分支
    git checkout -b dev origin/dev  # 将本地的dev分支对应远程的origin/dev分支并切换到该分支

    git clone -b mybranch --single-branch git://sub.domain.com/repo.git # 直接拉取指定分支到本地

  2. 在该分支下进行开发

  3. 修改完成后推送到远程dev分支

    1
    2
    3
    git add .
    git commit -m "some modification"
    git push origin dev

  4. 修改并合并到master分支

    1
    2
    3
    git checkout master # 首先切换到本地的master分支
    git merge --no-ff   # 将本地的dev分支与本地的master分支合并
    git pull            # 获取远程索引

    这一步可能这一步可能会冲突，原因当然是其他人在你之前对远程的master分支进行了修改并提交上去
    如果没有错，就直接推送
    git push origin master

TroubleShooting

  • git checkout -b dev origin/dev出现错误fatal: cannot update paths and switch to branch ‘origin/dev’
    原因是未在远程创建dev分支，或者未在本地更新分支信息

  • git remote add origin git@github.com:haoflynet/test，出现错误fatal: remote origin already exists
    原因是克隆别人的库下来修改后push到自己的库可能会出现这种错误，要先执行git remote rm origin

  • .gitignore无效，该忽略的依然没有被忽略

    1
    2
    3
    git rm -r --cached .	# 这条命令处理不了文件夹，如果是文件夹，需要把最后的点修改为文件夹的路径
    git add .
    git commit -m "fixed untracked files"

    这样会删除github上面已经提交了的但是现在忽略了的文件，如果要在github上面保留一份，那么执行git add -f filename

  • There was a problem with the editor ‘vi’
    vi编辑器的问题吧，直接换成vim
    git config --global core.editor $(which vim)

  • 更改文件名后，远程居然没有过更新
    git默认对文件名的大小写不敏感，需要在仓库执行git config core.ignorecase false让它对大小写敏感

  • 413 request entity too large

    发生这个问题是因为采用的是https而不是ssh方式来push仓库，而https传输数据的大小一般是由服务器，即nginx来控制的，太大了是传不上去的，这时候只需要更改为ssh方式即可。

  • 修改提交作者和邮箱: git可以通过git filter-branch修改已经提交了的commit的作者和邮箱。如果仅仅想修改一次的，可以直接git commit --amend --author="haoflynet <haoflynet@gmail.com>"。这里有一个来自若有所思-胡磊的批量修改的脚本:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    #!/bin/sh
     
    git filter-branch --env-filter '
     
    an="$GIT_AUTHOR_NAME"
    am="$GIT_AUTHOR_EMAIL"
    cn="$GIT_COMMITTER_NAME"
    cm="$GIT_COMMITTER_EMAIL"
     
    if [ "$GIT_COMMITTER_EMAIL" = "[Your Old Email]" ]
    then
        cn="[Your New Author Name]"
        cm="[Your New Email]"
    fi
    if [ "$GIT_AUTHOR_EMAIL" = "[Your Old Email]" ]
    then
        an="[Your New Author Name]"
        am="[Your New Email]"
    fi
     
    export GIT_AUTHOR_NAME="$an"
    export GIT_AUTHOR_EMAIL="$am"
    export GIT_COMMITTER_NAME="$cn"
    export GIT_COMMITTER_EMAIL="$cm"
    '

  • error: you need to resolve your current index first: 通常是因为合并冲突所致，可以简单地使用git reset --merge进行恢复

  • 在目录外面执行git参数，不进入目录提交git:

    1
    git --git-dir=~/foo/.git --work-tree=~/foo push

  • 误删分支及恢复方法: 项目很久以后才发现以前某个被删除的分支还没合并到主分支，看不到修改了哪些地方了。

    1. 先用git log -g找到之前在该分支上面的commit记录(所以必须要有经常commit的习惯，可以不push但是要commit)
    2. 从该commit处新建分支git branch 新分支名 commit的hash值
    3. 切换到新分支git checkout 新分支名

  • 两个人用同一个账号登录同一台服务器居然有一个人有git权限，另一个却没有: 这是因为虽然是同一个用户登录的服务器，但是所带的key确实不一样的，可以使用ssh-add -l查看你登录的ssh key，看是否有权限。

  • warning: refname ‘remotes/origin/dev’ is ambiguous. fatal: 歧义的对象名: ‘remotes/origin/dev’: 原因是错误的新建了一个和远程分支同名的分支，在新建分支的时候一定要-b让本地分支与远程分支相对应，遇到这种情况，只需要先删除本地分支即可git branch -d 分支名

  • 提交时出现fatal: Unable to create '.git/index.lock': File exists.: 原因是检测到有其他的Git在同时操作该本地仓库，如果确认没有其他的，那么直接删除它即可rm -rf .git/index.lock

  • The project you were looking for could not be found: 切换用户试试

坚持原创技术分享，谢谢支持

欢迎关注我的其它发布渠道