使用 github 做代码管理,知道这些就够了
只要掌握了下面的常用命令,基本上用使用 github 就没有问题。github 有两种认证方式,一种是通过 ssh 私钥的方式,一种通过 https 的账号名和密码。ssh 方式需要创建本地秘钥并且添加到个github 上,操作起来略显麻烦,本篇完全介绍以 https 方式管理。
主要原理说明
git 的管理依赖于在你本地仓库的目录中存在一个 .git
目录的,里面有 config、HEAD 等文件。
HEAD 里面是标识当前所在的分支,内容如下,表示当前在 dev 分支下,之后的拉取和推送都是在 dev 分支下完成:
ref: refs/heads/dev
config 里配置一些参数,如仓库地址、remote 等
[core]
repositoryformatversion = 0
filemode = true
bare = false
logallrefupdates = true
ignorecase = true
precomposeunicode = true
[remote "origin"]
url = https://username:password@github.com/huzhicheng/test__11.git
fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
remote = origin
merge = refs/heads/master
其中,url 参数是重点,表示远程仓库地址,正常的远程仓库格式为 https://github.com/huzhicheng/test__11.git
,而这里,并且包括下面用到的都是 https://username:password@github.com/huzhicheng/test__11.git
这种格式。其中username 表示 github 账号,后面冒号分隔,接一个密码,也就是 github 密码,然后用 @ 符号连接上远程仓库。
用 https 方式连接 github 项目就是这么简单。
##初始化本地仓库
假设我们要在 github 上维护一个项目。首先,要登录 github 账号,点击 “New repository”,输入项目名称,即可成功创建项目仓库,之后会提示如下内容:
echo "# 初始化仓库" >> README.md
git init
git add README.md
git commit -m "first commit"
做上面这些操作之前,我们需要在机器上创建一个空白目录,然后进入这个目录进行操作。
第一行,是说新建一个 README.md 文件,并且写上你自定义的内容;
第二行,通过 git init
命令做本地仓库的初始化;
第三行,将 README.md 添加到暂存区;
第四行,提交暂存区并写好注释说明。
本地仓库和远程仓库创建联系
本地创建完仓库后,需要把本地仓库和远程仓库建立联系,这样之后才能推送文件到远程仓库。
git remote add origin https://username:password@github.com/huzhicheng/test__11.git
移除本地仓库和远程仓库的关联
如果远程仓库作废或者添加了错误的远程仓库地址,可以用下面的命令移除掉。注意 origin 后面的内容需要和关联远程仓库时填写的内容一致才可以。
git remote rm origin https://username:password@github.com/huzhicheng/test__11.git
首次提交
git push -u origin master
推送本地修改到远程
推送前一定要先拉取最新代码,并且每次修改前及时拉取最新代码是非常好的习惯。
//拉取最新代码
git pull origin master
//查看本地仓库状态
git status
// 将所有修改更新至暂存区
git add .
// 提交暂存区更改 并写上明确的注释说明
git commit -m "注释内容"
// 提交修改至主分支
git push origin master
以上操作就可以完成从仓库初始化到文件提交的完整过程了。
那如果是参与已经存在的项目呢,远程仓库已经存在并且已有项目文件在了,下面介绍如何参与已有项目。
将远程仓库同步到本地
首先需要 clone 远程仓库到本地,然后拉取新代码就可以了,就是这么简单。
git clone https://username:password@github.com/username/xxxxxx.git
git remote -v 可以查看远程仓库版本
git fetch origin master 拉取远程仓库更新
强制覆盖本地文件
有时候临时在本地仓库做了修改,但是不想保留,再拉取更新的时候要强制覆盖本地文件,可以用如下命令。
git fetch --all
git reset --hard origin/master
git pull
解决冲突
有时候我们可能和别人同时修改了某一个文件,提交的时候发现文件已经被别人修改,并且提交了。这时,如果我们再提交文件的话会出现如下错误:
To https://github.com/huzhicheng/test__11.git
! [rejected] dev -> dev (fetch first)
error: failed to push some refs to 'https://github.com/huzhicheng/test__11.git'
hint: Updates were rejected because the remote contains work that you do
hint: not have locally. This is usually caused by another repository pushing
hint: to the same ref. You may want to first integrate the remote changes
hint: (e.g., 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.
按照提示,我们尝试 git pull origin dev 获取最新版本,通常又会出现如下问题:
From https://github.com/huzhicheng/test__11
* branch dev -> FETCH_HEAD
e6bb7ea..c04d142 dev -> origin/dev
Auto-merging dev.md
CONFLICT (content): Merge conflict in dev.md
Automatic merge failed; fix conflicts and then commit the result.
意思是说,获取新版本尝试自动合并,但是合并失败,请修复冲突并提交。
这时我们打开冲突的文件,会看到有 <<<<<<< HEAD
、=======
、>>>>>>>
这些符号,留下要合并的最后内容。然后再执行命令:
git add -u
git commit -m "解决冲突"
git pull origin dev
git push origin dev
建立并切换到新分支
如果项目中存在多个分支,例如主分支和开发分支,我们在本地创建同样的分支结构使用如下命令,创建 dev 分支,并且切换到 dev 分支 。
// 创建分支并且切换到这个分支下
git checkout -b dev
// 切换到某分支
git checkout dev
git checkout master
查看所在分支
其中前面带 * 号的为当前所在的分支。
$ git branch
* dev
master
分支合并
我们之前假设已经在 dev 分支上做了一些修改,可以发布版本之后,想要合并到 master 分支上。
首先使用 git checkout master 切换到 master 分支,然后执行 git merge dev 命令进行 dev 分支到 master 分支的合并。
$ git merge dev
Updating 1dd1bb5..5fe81cd
Fast-forward
dev.md | 6 ++++++
1 file changed, 6 insertions(+)
公众号:古时的风筝