Git仓库

# Git仓库使用方法流程详解

## 一、环境搭建与基础配置

### 1.1 安装与初始化

- **安装Git**：官网下载安装包，默认配置安装

- **配置全局信息**：

```bash

git config --global user.name "Your Name"

git config --global user.email "your.email@example.com"

o 验证安装：git --version

1.2 创建本地仓库

o 初始化仓库：git init

o 克隆远程仓库：git clone <仓库URL>

1.3 忽略文件配置

o 创建.gitignore：写入需忽略的文件/目录

o 应用规则：自动跳过匹配文件

二、核心工作流程

2.1 文件状态管理

o 查看状态：git status

o 添加文件到暂存区：git add <文件名>或git add .

o 提交到本地仓库：

【bash】

git commit -m "提交说明"

2.2 版本回溯与重置

o 查看提交历史：

【bash】

git log --oneline --graph

git reflog

o 回退版本：

o 软重置：git reset --soft <提交哈希>

o 硬重置：git reset --hard <提交哈希>

o 撤销未提交的修改：

【bash】

git checkout -- <文件名>

git reset HEAD <文件名>

2.3 远程仓库协作

o 添加远程仓库：git remote add origin <远程仓库URL>

o 推送代码：

【bash】

git push -u origin main

git push

o 拉取最新代码：

【bash】

git pull origin main

git fetch origin

2.4 分支管理

o 创建与切换分支：

【bash】

git branch feature/login

git checkout feature/login

git checkout -b feature/login

o 合并分支：

【bash】

git checkout main

git merge feature/login

o 删除分支：

【bash】

git branch -d feature/login

git branch -D feature/login

o 推送分支到远程：

【bash】

git push -u origin feature/login

git push origin feature/login

2.5 标签管理

o 创建标签：

【bash】

git tag v1.0.0

git tag -a v1.0.0 -m "发布版本"

o 查看标签：

【bash】

git tag

git show v1.0.0

o 推送标签到远程：

【bash】

git push origin v1.0.0

git push origin --tags

o 删除标签：

【bash】

git tag -d v1.0.0

git push origin :refs/tags/v1.0.0

三、高级协作场景

3.1 多仓库管理

o 添加多个远程仓库：

【bash】

git remote add upstream <原始仓库URL>

git remote add fork <个人仓库URL>

o 同步上游仓库更新：

【bash】

git fetch upstream

git checkout main

git merge upstream/main

git push origin main

3.2 冲突解决策略

o 手动解决冲突：

1. 编辑冲突文件，保留需保留内容

2. 删除冲突标记后保存文件

3. 执行git add <文件名>

4. 提交合并结果：git commit -m "解决合并冲突"

o 使用合并工具：

【bash】

git config --global merge.tool vscode

git mergetool

3.3 代码审查与协作

o 创建Pull Request（PR）：

1. 推送特性分支到远程仓库

2. 在平台发起PR，填写变更说明和关联Issue

3. 团队成员进行代码审查和讨论

o 处理PR反馈：

o 根据反馈修改代码后，提交到特性分支

o 远程仓库自动更新PR内容

3.4 持续集成集成

o 配置Git Hooks：

【bash】

#!/bin/sh

if ! python -m black --check .; then

echo "代码风格不符合规范，请使用black格式化后再提交"

exit 1

fi

o 与CI/CD工具集成：

【yaml】

name: CI

on: [push, pull_request]

jobs:

build:

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v2

- run: pip install -r requirements.txt

- run: pytest

四、最佳实践与常见问题

4.1 最佳实践

o 提交粒度控制：每个提交聚焦单一逻辑单元

o 分支命名规范：

o feature/xxx：特性开发分支

o bugfix/xxx：Bug修复分支

o release/v1.0：发布分支

o hotfix/xxx：紧急修复分支

o 代码审查流程：强制要求PR需至少