使用 github 做代码管理，知道这些就够了

2024-02-05 18:51:16

只要掌握了下面的常用命令，基本上用使用 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(+)

公众号:古时的风筝

码农公寓