# Git 使用说明

## 1. 为什么需要在 WSL 中使用 Git

本项目包含 Linux 符号链接文件（如 `SDK/OpenCV320/Arm/aarch64/` 和 `SDK/OpenCV480/Arm/aarch64/lib/` 目录下的 `.so` 文件），这些符号链接在 Windows 原生环境下无法正确处理。

**原因：**
- Windows 的符号链接与 Linux 的符号链接格式不兼容
- 在 Windows 下使用 Git 操作这些文件会导致符号链接被破坏或转换为普通文件
- WSL (Windows Subsystem for Linux) 可以正确处理 Linux 符号链接

**建议：**
- 所有 Git 操作（clone、pull、push、commit 等）都应在 WSL 环境中进行
- 代码编辑和编译可以在 Windows 下进行，但版本控制操作需要在 WSL 中完成

## 2. Ubuntu 下使用 Git 所需安装的软件

### 基础安装

```bash
# 更新软件包列表
sudo apt update

# 安装 Git
sudo apt install git

# 验证安装
git --version
```

### 配置 Git 用户信息

```bash
# 设置用户名
git config --global user.name "你的用户名"

# 设置邮箱
git config --global user.email "你的邮箱@example.com"

# 查看配置
git config --list
```

### 可选工具安装

```bash
# Git 图形化界面工具
sudo apt install gitk git-gui

# Git 凭证存储（避免重复输入密码）
sudo apt install git-credential-manager

# 或使用缓存方式存储凭证
git config --global credential.helper cache
git config --global credential.helper 'cache --timeout=3600'
```

## 3. Git 管理常用命令

### 仓库操作

| 命令 | 说明 |
|------|------|
| `git clone <url>` | 克隆远程仓库 |
| `git init` | 初始化本地仓库 |
| `git remote -v` | 查看远程仓库地址 |
| `git remote add origin <url>` | 添加远程仓库 |

### 状态查看

| 命令 | 说明 |
|------|------|
| `git status` | 查看工作区状态 |
| `git log` | 查看提交历史 |
| `git log --oneline` | 查看简洁提交历史 |
| `git log --graph` | 图形化显示提交历史 |
| `git diff` | 查看未暂存的修改 |
| `git diff --staged` | 查看已暂存的修改 |

### 文件操作

| 命令 | 说明 |
|------|------|
| `git add <file>` | 添加文件到暂存区 |
| `git add .` | 添加所有修改到暂存区 |
| `git rm <file>` | 删除文件并暂存 |
| `git mv <old> <new>` | 重命名/移动文件 |
| `git checkout -- <file>` | 撤销工作区修改 |
| `git reset HEAD <file>` | 取消暂存 |

### 提交操作

| 命令 | 说明 |
|------|------|
| `git commit -m "提交信息"` | 提交到本地仓库 |
| `git commit -am "提交信息"` | 添加并提交（仅已跟踪文件） |
| `git commit --amend` | 修改最后一次提交 |

### 分支操作

| 命令 | 说明 |
|------|------|
| `git branch` | 查看本地分支 |
| `git branch -a` | 查看所有分支（含远程） |
| `git branch <name>` | 创建分支 |
| `git checkout <branch>` | 切换分支 |
| `git checkout -b <name>` | 创建并切换分支 |
| `git merge <branch>` | 合并分支到当前分支 |
| `git branch -d <name>` | 删除分支 |

### 远程同步

| 命令 | 说明 |
|------|------|
| `git fetch` | 获取远程更新（不合并） |
| `git pull` | 拉取并合并远程更新 |
| `git push` | 推送到远程仓库 |
| `git push -u origin <branch>` | 推送并设置上游分支 |
| `git push origin --delete <branch>` | 删除远程分支 |

### 撤销与回退

| 命令 | 说明 |
|------|------|
| `git reset --soft HEAD~1` | 撤销最后一次提交（保留修改在暂存区） |
| `git reset --mixed HEAD~1` | 撤销最后一次提交（保留修改在工作区） |
| `git reset --hard HEAD~1` | 撤销最后一次提交（丢弃所有修改） |
| `git revert <commit>` | 创建新提交来撤销指定提交 |

### 暂存工作区

| 命令 | 说明 |
|------|------|
| `git stash` | 暂存当前工作区 |
| `git stash list` | 查看暂存列表 |
| `git stash pop` | 恢复并删除暂存 |
| `git stash apply` | 恢复暂存（不删除） |
| `git stash drop` | 删除暂存 |

### 标签操作

| 命令 | 说明 |
|------|------|
| `git tag` | 查看标签列表 |
| `git tag <name>` | 创建轻量标签 |
| `git tag -a <name> -m "说明"` | 创建附注标签 |
| `git push origin <tag>` | 推送标签到远程 |
| `git push origin --tags` | 推送所有标签 |