# git从入门到精通

**Repository Path**: xiaoliang_mian/duyi-git

## Basic Information

- **Project Name**: git从入门到精通
- **Description**: 前端渡一git文档
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# git从入门到精通

## git核心概念和命令

### 动机

![image-20260206121820610](https://resource.duyiedu.com/yuanjin/202602061218419.png)







![image-20260206122519720](https://resource.duyiedu.com/yuanjin/202602061225743.png)

### 安装

- windows: 从[https://git-scm.com/install/](https://git-scm.com/downloads)下载安装包，双击运行安装即可。
- mac: 自带git，无需安装。
- *linux: 使用命令 `sudo apt-get install git` 安装。*

### 配置

配置命令：

```shell
git config -l # 查看当前生效的所有配置
git config 键 # 查看当前生效的某个配置的值
git config --范围 键 "值" # 更新配置
```

#### 配置范围

- *`worktree`: 仅对当前工作树生效*
- `local`: 【常见】【默认】仅对当前仓库有效
- `global`: 【常见】对当前用户的所有仓库有效
- *`system`: 对所有用户有效*

优先级从高到底：*`worktree` >* `local` > `global` *> `system`*

#### 常见配置

- `user.name`: 【必配】配置用户名。后续提交会使用该用户名。
- `user.email`: 【必配】配置邮箱。后续提交会使用该邮箱。
- `core.editor`: 配置默认文本编辑器。
- `core.ignorecase`: 配置是否忽略文件名的大小写。默认是 `true`，即忽略大小写。
- `init.defaultbranch`：配置初始化后默认的分支名

```shell
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
git config --global core.editor "code --wait"
git config --global core.ignorecase false
git config --global init.defaultbranch "main"
```

### 初始化

要对一个目录使用git进行版本管理，必须先将该目录设置为git仓库。

使用 `git init` 命令初始化一个新的git仓库。

该命令会在当前目录下创建一个 `.git` 目录，该目录就是git仓库，里面记录了仓库的所有信息。该目录不可删除，一旦删除，该仓库就不存在了。

### .gitignore文件

仓库中某些文件是「个人专属」，不会在团队间共享，可以使用`.gitignore`文件将不需要的文件排除。

### 暂存和提交

#### 核心概念

![image-20260206150656393](https://resource.duyiedu.com/yuanjin/202602061506490.png)

#### 如何提交

提交分为两步：

1. 【可选】查看当前状态
   ```shell
   git status
   ```

2. 将改动暂存起来

   ```shell
   git add <file1> <file2> # 暂存指定文件
   git add . # 暂存当前目录及子目录下的所有文件
   ```

3. 将暂存的内容一起提交
   ```shell
   git commit # 会打开默认文本编辑器，你可以在编辑器中编写提交信息
   git commit -m "提交信息" # 直接在命令行中编写提交信息，不会打开文本编辑器
   ```



术语：

1. 工作区：包含真实文件
2. 暂存区：包含暂存的文件

#### 提交消息规范

| 提交类型     | 标识符     | 说明                       | 示例                           |
| :----------- | :--------- | :------------------------- | :----------------------------- |
| **功能新增** | `feat`     | 新增功能或特性             | `feat: 添加用户登录功能`       |
| **问题修复** | `fix`      | 修复bug或问题              | `fix: 修复登录超时问题`        |
| **文档更新** | `docs`     | 仅文档变更                 | `docs: 更新API使用说明`        |
| **代码风格** | `style`    | 代码格式调整（不影响功能） | `style: 调整代码缩进格式`      |
| **代码重构** | `refactor` | 代码重构（非功能变更）     | `refactor: 重构用户认证模块`   |
| **性能优化** | `perf`     | 性能优化相关               | `perf: 优化数据库查询性能`     |
| **测试相关** | `test`     | 测试用例相关               | `test: 添加登录功能单元测试`   |
| **构建系统** | `build`    | 构建系统或外部依赖变更     | `build: 更新webpack配置`       |
| **持续集成** | `ci`       | CI/CD配置变更              | `ci: 添加GitHub Actions工作流` |
| **工具变更** | `chore`    | 构建过程或辅助工具变更     | `chore: 更新依赖包版本`        |
| **回滚操作** | `revert`   | 回滚之前的提交             | `revert: 回滚错误的合并提交`   |

#### 提交消息修改

```shell
git commit --amend
```

该命令通常用于修改最新的提交消息。

所以使用该命令时，要确保自己所在的位置在最新的位置。

> 最佳实践1：
>
> 1. 编写提交消息时，尽量不要犯错
> 2. 提交后，立即审核提交消息，发现消息错误，立即通过上面的命令修复
>
> 最佳实践2: 让AI编写提交消息，审核后发布

#### 回滚某个提交

```shell
 git restore --source 提交id . # 将指定的提交覆盖到当前工作区根目录 
```

使用上述命令时，要确保工作区干净（暂存区没东西，工作区无更改）

### 分支管理

![image-20260209112909436](https://resource.duyiedu.com/yuanjin/202602091129537.png)

分支基本操作：

1. 查看分支

   ```shell
   git branch
   ```

2. 分支重命名

   ```shell
   git branch -m <new-name> # 重命名当前分支
   git branch -m <old-name> <new-name> # 重命名指定分支
   ```

3. 创建分支

   ```shell
   git branch <branch-name> # 创建一个新的分支，指针和当前分支相同
   git branch <branch-name> <commit-hash> # 创建一个新的分支，指针指向指定的提交
   ```

4. 切换分支

   ```shell
   git switch <branch-name> # 切换到指定分支
   git switch - # 切换到上一个分支，非常方便的在两个分支间来回切换
   ```

   > 创建并切换分支快捷方式：`git switch -c <branch-name>`

5. 删除分支

   ```shell
   git branch -d <branch-name> # 删除指定分支
   git branch -D <branch-name> # 强制删除指定分支
   ```

#### 分支基本生命周期

==永远不能在主分支上直接改动，主分支永远保证功能完整可用、可部署==

1. **新需求**
   功能/bug修复/版本回滚/...

2. **新建分支**

   ```
   feature/*     - 新功能开发
   bugfix/*      - 缺陷修复
   hotfix/*      - 紧急生产修复
   release/*     - 版本发布
   chore/*       - 维护性任务
   docs/*        - 文档更新
   refactor/*    - 代码重构
   ```

3. **在分支上开发测试**
   可能产生多次提交

4. **合并到主分支**

5. **主分支测试/部署**

6. **删除开发分支**

#### 分支常见问题

##### 如何保留现场

```shell
git stash -a # 保存当前工作区的修改到存储库
# 切换分支工作...
# 切回分支
git stash list # [可选]查询当前存储库
git stash pop <stash-id> # 调用某个存储库恢复工作区，同时删除存储库
# 如果存储库是最后一个，可以省略id
```

##### 如何解决冲突

**冲突必须手动解决，尤其是主分支的冲突。**

### 远程仓库

![image-20260209154128608](https://resource.duyiedu.com/yuanjin/202602091541687.png)

#### 注册github账号

https://github.com/

自行注册

#### SSH连接通道配置

![image-20260209160956572](https://resource.duyiedu.com/yuanjin/202602091609611.png)

##### 生成密钥对

本地生成密钥对

> windows电脑必须打开powershell，而不是普通终端
>
> mac电脑随意

```shell
ssh-keygen -t ed25519 -C "注册github的邮箱地址" -f ~/.ssh/xxx_github_key
```

命令后续交互保持默认即可。

生成完后，到电脑的`~/.ssh`目录即可看到之前生成的两个文件：

> windows电脑的位置在`c:/Users/你的用户名/.ssh`

```shell
xxx_github_key   		# 这是私钥
xxx_github_key.pub 	# 这是公钥 
```

##### 到github配置公钥

https://github.com/settings/keys

自行配置

##### 配置密钥配对规则

![image-20260209164737186](https://resource.duyiedu.com/yuanjin/202602091647288.png)

1. 打开`~/.ssh/config`，没有就创建一个

2. 配置规则
   ```yaml
   # 规则1
   Host gmail.github.com  # 当连接 git@gmail.github.com 时会匹配到此规则
     HostName github.com  # 实际上链接发出的主机
     IdentityFile ~/.ssh/gmail_github_key # 使用的私钥文件  
     User git # 固定写法
   ```

3. 测试连接
   ```shell
   ssh -T git@你配置的主机名
   ```

   成功的结果是：
   ```
   Hi xxx! You've successfully authenticated ...
   ```

   

#### 仓库和别名

要和远程仓库同步，先得有远程仓库

1. 在github中创建远程仓库

2. 在本地仓库中添加远程仓库的别名



别名常见操作

   ```shell
   # 查看当前的远程仓库别名
   git remote    	# 简要信息
   git remote -v  	# 详细信息
   
   # 添加别名
   git remote add 远程仓库别名 远程仓库ssh地址
   
   # 修改别名
   git remote rename 原别名 新别名
   
   # 删除别名
   git remote remove 要删除的别名
   ```

#### 分支同步

##### push命令

![image-20260209181424840](https://resource.duyiedu.com/yuanjin/202602091814947.png)

```shell
# 将本地的某个分支推送到指定仓库
git push -u 远程仓库别名 本地分支名 
```

细节：

- 如果远程没有相关分支，则在远程创建同名分支
- 推送完成后，会在本地创建远程跟踪分支
  - 跟踪分支自动命名：`仓库别名/分支名`
  - 跟踪分支是只读的，它的目的在于同步远程分支
  - 推送完成后，会自动同步远程跟踪分支
- 由于使用了参数`-u`，在跟踪分支创建后，会自动把本地分支`main`绑定到跟踪分支`origin/main`
  - 后续仅需要使用`git push`即可推送当前的`main`分支



这样，就完成了本地到远程的同步

##### pull命令

![image-20260209182025435](https://resource.duyiedu.com/yuanjin/202602091820476.png)

1. 使用`git fetch`命令
   ```shell
   git fetch 远程仓库别名 远程分支名
   ```

   - 如果本地没有跟踪分支，则创建跟踪分支

2. 使用`git merge`命令合并分支
   ```shell
   # 确保当前在对应分支上
   git merge 本地跟踪分支名
   ```



这样，就完成了远程到本地的同步。

使用`git pull`快捷命令，可以一步替代上面两步操作

```shell
git pull 远程仓库别名 远程分支
```

##### 克隆操作

当本地没有工程时，可以使用`git clone`操作快速完成远程仓库的下载

```shell
git clone [-b 分支名] 远程仓库地址 [想要保存的文件夹]
```

#### 同步的三种情况

==情况一：远程快进==

![image-20260209185450076](https://resource.duyiedu.com/yuanjin/202602091854173.png)



==情况二：本地快进==

![image-20260209185647463](https://resource.duyiedu.com/yuanjin/202602091856514.png)

==情况三：解决冲突==

![image-20260209192214890](https://resource.duyiedu.com/yuanjin/202602091922920.png)

简单总结：

1. 正常推送拉取，没问题什么也不管
2. 推送报错，进入第3步
3. 拉取有冲突，解决冲突重新提交，然后进入第2步

## github flow

### 完整流程

```mermaid
sequenceDiagram
		autonumber
    actor dev as 开发者
    participant Local as 本地仓库
    participant GH as 远程仓库
    actor admin as 管理员
    
    dev->>Local: 拉取: main分支
    note right of Local: 从远程同步最新代码
    dev->>Local: 开发: 切换分支，多次提交
    dev->>GH: 推送: 推送开发分支
    dev->>GH: 创建PR: base main
    admin->>GH: review: 审查
    admin->>GH: 提交：提交合并到main
    admin->>GH: 删除：删除开发分支
```



**开发者规范：**

1. **main分支只读**
2. **基于最新提交开发**



**管理员规范**

1. **main分支只能通过PR修改**
2. **PR永远无冲突**