# git command user guide

**Repository Path**: chinese_pla_general_hospital/git-command-user-guide

## Basic Information

- **Project Name**: git command user guide
- **Description**: 常用git命令
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-10-11
- **Last Updated**: 2021-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# git 常用命令

## 0. 准备工作(gitee)

首先我们需要安装git工具包

    sudo apt-get install git
    
接下来我们需要在自己的计算机上生成公钥

    ssh-keygen
    
默认公钥是保存在`~/.ssh/id_rsa.pub`中，使用`cat ~/.ssh/id_rsa.pub`命令查看公钥内容并复制下来。之后我们需要登陆 [Gitee账户SSH管理界面](https://gitee.com/profile/sshkeys) 将我们刚刚复制好的公钥粘贴到指定位置中。

最后使用以下两条命令配置账户信息：

    git config --global user.name 'your gitee account username'
    git config --global user.email 'your gitee account email'


## 1. 创建新仓库

     git init new_repo
     
在上面的命令中，`new_repo`是创建的仓库名称并创建文件夹，文件夹以仓库名称命名。如果不指定`new_repo`，则会在当前目录下创建仓库，并以当前目录名称命名仓库。

因此，可以通过两种方法创建新仓库：

    git init new_repo
或者

    mkdir new_repo
    cd new_repo
    git init
    
## 2. 创建新分支

一个仓库中可能会有很多不同的开发者共同维护或测试代码，多个用户编辑同一段代码有很高的风险，因此我们通常会创建不同的分支来进行开发，其他分支的代码测试通过后才会被管理员合并到主分支。仓库建立时默认的分支为`master`。


### 2.1 创建本地分支
本地分支是开发者在自己电脑上创建的私人分支，其他用户无法查看。

    git checkout -b new_local_branch
    
用户首先进入仓库，上方`new_local_branch`是用户创建的本地分支名称。

### 2.2 创建远程分支
远程分支是开发者创建的私人分支，其他用户可以查看，除非获得权限否则无法修改。

    git checkout -b new_remote_branch
    git push
    
上面的命令中多了一个`git push`，意思是将创建好的分支上传到远程仓库。

### 2.3 从远程分支拉取到本地分支

    git checkout -b new_local_branch origin/remote_branch

本地分支的代码和远程分支代码同步。

## 3. 查看分支

    git branch
    
上面的命令是查看本地所有分支，如果想查看包括远程分支在内的所有分支，则可以用命令：`git branch -a`

## 4. 克隆仓库

如果本地没有某个项目的仓库，则可以通过git命令克隆到本地，默认克隆的仓库分支为`master`。

    git clone http://XXX/XXX/new_repo.git
    
git会自动下载仓库内的所有代码到本地的`new_repo`文件夹中。如果希望克隆某个特定分支，则可以用命令：
    
    git clone -b your_branch http://XXX/XXX/new_repo.git
    
## 5. 拉取分支

如果本地已经存在某个项目，但是还希望拉取其他远程分支，则无需重新克隆，通过git的`pull`命令可以完成。

    git pull origin remote_branch:local_branch
    
在上面的命令中，`origin`是远程主机名，一般都是origin。`remote_branch`是远程分支名称，`local_branch`是本地分支名称，如果本地分支已经存在，则远程分支和已经存在的本地分支合并。

## 6. 本地修改代码后上传到远程分支

假如本地修改了local_branch分支下的README.md文件，希望同步到远程分支remote_branch上，则可以用以下命令完成：

    git add README.md
    git commit -m 'your update description'
    git push origin local_branch:remote_branch
    
第一条`git add`命令是标记要同步的文件，如果修改的文件较多，则可以用`git add *`来表示标记所有修改过的文件。第二条`git commit`命令是给修改的文件添加改动说明。第三条命令是将本地分支同步到远程分支。

## 7. 其他常用命令

 * 查看上次提交之后是否有对文件进行再次修改 [git status](https://www.runoob.com/git/git-status.html)
 * 查看历史提交记录 [git log/git blame](https://www.runoob.com/git/git-commit-history.html)
 * 重要阶段打标签 [git tag](https://www.runoob.com/git/git-tag.html)
 * 比较文件的不同 [git diff](https://www.runoob.com/git/git-diff.html)
 * 分支交叉合并 [git merge](https://www.jianshu.com/p/58a166f24c81)