# git使用指南

**Repository Path**: fzlkkk/git-user-guide

## Basic Information

- **Project Name**: git使用指南
- **Description**: git 使用方法，主要用于连接远程仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-06-20
- **Last Updated**: 2025-06-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 使用git以及连接远程仓库全流程

## 一、git下载与本地安装

### 1、检测是否安装

打开终端，输入git查看是否已经安装，此处为Linux下的终端，其它操作系统大同小异

```shell
$ git
The program 'git' is currently not installed. You can install it by typing:
sudo apt-get install git
```

### 2、下载安装包并安装

未安装则进入下载页面<https://git-scm.com/downloads> 选择对应的操作系统版本

选择下载即可

点击安装包进行下载

![安装包截图](./img/01.png)

对于新手来说，一路next，基本配置即可使用，安装完毕即可。

![安装选项](img/02.png)

### 3、添加远程仓库

```shell
git remote add origin git@github.com:michaelliao/learngit.git
```

### 4、拉取远程仓库

```shell
git pull git@gitee.com:lijiatai/internship-log.git master
```

## 二、核心原理

### 0、远程仓库

一般会把项目放在远程仓库里，也就是github、gitee或者gitlab等网站或者服务器，所有人都以这个远程仓库的文件作为最新版本

### 1、工作区

就是本地电脑里的一个文件夹，可以用clone把最新版本文件从远程仓库复制到本地，在自己本地文件夹里操作

如果文件还在工作区里，那么文件就是`未追踪`状态，即`Untracked`或者`Unstage`来表示

### 2、暂存区

如果在工作区更新了一些文件想要提交到远程仓库，比如新增四个文件，只想更新两个，就可以使用`add`先把这两个文件添加到`暂存区`

暂存区内则为`已追踪`状态，使用`Stage`来表示

### 3、本地仓库

如果暂存区也觉得没问题了，就使用`commit`，添加到本地仓库，也就是本地版本区，就会新增一个版本

### 4、远程仓库（更新）

如果本地仓库可以更新到远程仓库了，就使用`push`，把内容添加到远程仓库

如果远程仓库有更新内容，则使用`pull`进行拉取更新，不过`pull`会直接更新到工作区，会覆盖已改变的内容

应该使用`fetch`，更新到本地仓库，再用`diff`进行对比区别，没问题在进行合并到工作区

## 三、实操代码

### 1、设置用户名和邮箱

```shell
git config --global user.name "Username"
git config --global user.email "UserEmail@email.com"
```

### 2、初始化

```shell
git init
```

初始化后，一般会显示`master`为主分支，不过最新版本已经更改为`main` ，默认会处于主分支

### 3、查看状态

在更新完文件后，或者忘记更新情况时，使用

```shell
git status
```

查看当前git情况

第一行会告诉你当前所处的分支

第二行往后告诉你文件状态

### 4、添加到暂存区

```shell
git add document.md
```

### 5、提交到本地仓库

```shell
git commit -m "版本更新内容信息，必填"
```

也可以直接

```shell
git commit 
```

会进入vim编辑器，按`i`键进入编辑状态，可以输入多行更新信息，输入完后摁`esc`键推出编辑模式，再输入`:wq`保存退出即可

快捷提交本都版本库

```shell
git commit -am "版本修改信息"
```

就可以直接包含add，一下提交到版本库

### 6、查看版本

```shell
git log
```

查看前面的更新版本，可以查看相关信息以及更新内容

按下`q`键退出当前页面

### 7、忽略掉相关文件

创建`.gitignore`文件

在文件内添加文件名，就不会把该文件算作更新内容

## 四、分支

当我们不知道是否需要某个新增文件作为仓库更新文件时，就可以在主分支基础上创建分支，等新分支文件准备好了，就可以进行合并，不过实际情况更为复杂

### 1、创建分支

```shell
git branch 分支名
```

创建后，不会马上跳转到新分支上

使用

```shell
git branch
```

查看所有分支，同样按`q`退出

### 2、切换分支

```shell
git checkout 分支名
```

### 3、删除分支

```shell
git branch -D 分支名
```

### 4、创建新分支并跳转到新分支

```shell
git checkout -b 新分支
```

### 5、合并到主支

先跳转到主分支

```shell
git checkout master
```

合并分支

```shell
git merge 新分支 
```

### 6、特殊情况

主支和分支分别添加了新的内容，合并时就会产生冲突，需要自己手动操作更改内容