# Git 推送教程

本文档教你如何将代码推送到 Git 仓库（以 Gitea 为例）。

---

## 📚 基础概念

### Git 工作流程
```
工作区 → 暂存区 → 本地仓库 → 远程仓库
  ↓        ↓         ↓          ↓
编辑文件  git add  git commit  git push
```

---

## 🚀 完整推送流程

### 1️⃣ 查看文件状态

```bash
git status
```

**作用**: 查看哪些文件被修改、新增或删除

**输出示例**:
```
Changes not staged for commit:
  modified:   frontend/src/App.vue
  
Untracked files:
  CHANGELOG.md
```

---

### 2️⃣ 添加文件到暂存区

#### 添加所有文件
```bash
git add -A
```
或
```bash
git add .
```

#### 添加特定文件
```bash
git add frontend/src/App.vue
git add CHANGELOG.md
```

#### 添加特定目录
```bash
git add frontend/
git add backend/
```

**提示**: `-A` 会添加所有修改、新增和删除的文件

---

### 3️⃣ 提交到本地仓库

```bash
git commit -m "提交说明"
```

#### 提交说明规范

**格式**: `类型: 简短描述`

**常用类型**:
- `feat`: 新功能
- `fix`: 修复bug
- `docs`: 文档更新
- `style`: 代码格式调整
- `refactor`: 重构代码
- `perf`: 性能优化
- `test`: 测试相关
- `chore`: 构建/工具相关

**示例**:
```bash
# 简单提交
git commit -m "feat: 添加用户登录功能"

# 详细提交（多行）
git commit -m "feat: 添加用户登录功能

- 实现登录表单
- 添加JWT认证
- 完善错误处理"
```

---

### 4️⃣ 推送到远程仓库

```bash
git push origin main
```

**参数说明**:
- `origin`: 远程仓库名称（默认）
- `main`: 分支名称（也可能是 `master`）

#### 首次推送
```bash
git push -u origin main
```
`-u` 参数会设置上游分支，之后只需 `git push` 即可

---

## 🔄 完整示例

### 场景1: 推送所有修改

```bash
# 1. 查看状态
git status

# 2. 添加所有文件
git add -A

# 3. 提交
git commit -m "feat: 完成首页重构"

# 4. 推送
git push origin main
```

### 场景2: 推送特定文件

```bash
# 1. 添加特定文件
git add frontend/src/App.vue
git add CHANGELOG.md

# 2. 提交
git commit -m "docs: 更新文档"

# 3. 推送
git push origin main
```

### 场景3: 修改上次提交

```bash
# 如果忘记添加某个文件
git add forgotten-file.txt
git commit --amend --no-edit

# 如果要修改提交信息
git commit --amend -m "新的提交信息"

# 强制推送（谨慎使用）
git push -f origin main
```

---

## 🔧 常用命令

### 查看相关

```bash
# 查看状态
git status

# 查看提交历史
git log

# 查看简洁历史
git log --oneline

# 查看远程仓库
git remote -v

# 查看分支
git branch
```

### 撤销相关

```bash
# 撤销工作区修改
git checkout -- filename

# 撤销暂存区（保留工作区修改）
git reset HEAD filename

# 撤销上次提交（保留修改）
git reset --soft HEAD^

# 撤销上次提交（不保留修改）
git reset --hard HEAD^
```

### 分支相关

```bash
# 查看所有分支
git branch -a

# 创建新分支
git branch feature-name

# 切换分支
git checkout feature-name

# 创建并切换分支
git checkout -b feature-name

# 合并分支
git merge feature-name

# 删除分支
git branch -d feature-name
```

---

## 🎯 快速推送（一键命令）

### 创建快捷脚本

创建文件 `push.sh`:
```bash
#!/bin/bash

# 快速推送脚本

echo "📝 查看状态..."
git status

echo ""
echo "➕ 添加所有文件..."
git add -A

echo ""
echo "💬 请输入提交信息:"
read commit_message

echo ""
echo "📦 提交中..."
git commit -m "$commit_message"

echo ""
echo "🚀 推送到远程仓库..."
git push origin main

echo ""
echo "✅ 推送完成！"
```

**使用方法**:
```bash
# 添加执行权限
chmod +x push.sh

# 运行脚本
./push.sh
```

---

## 🔐 配置 Git

### 设置用户信息

```bash
# 全局配置
git config --global user.name "你的名字"
git config --global user.email "your.email@example.com"

# 项目配置
git config user.name "你的名字"
git config user.email "your.email@example.com"
```

### 查看配置

```bash
# 查看所有配置
git config --list

# 查看特定配置
git config user.name
git config user.email
```

### 保存密码（HTTPS）

```bash
# 永久保存
git config --global credential.helper store

# 临时保存（15分钟）
git config --global credential.helper cache
```

---

## 🌐 远程仓库操作

### 添加远程仓库

```bash
git remote add origin https://git.vcck.cn/nvex/ns2.0.git
```

### 修改远程仓库地址

```bash
git remote set-url origin https://new-url.git
```

### 查看远程仓库

```bash
git remote -v
```

### 删除远程仓库

```bash
git remote remove origin
```

---

## ⚠️ 常见问题

### 1. 推送被拒绝

**错误**: `! [rejected] main -> main (fetch first)`

**原因**: 远程仓库有新的提交

**解决**:
```bash
# 拉取远程更新
git pull origin main

# 如果有冲突，解决后再推送
git push origin main
```

### 2. 合并冲突

**解决步骤**:
```bash
# 1. 查看冲突文件
git status

# 2. 手动编辑冲突文件，删除冲突标记
# <<<<<<< HEAD
# 你的修改
# =======
# 远程的修改
# >>>>>>> branch-name

# 3. 添加解决后的文件
git add conflict-file.txt

# 4. 提交
git commit -m "fix: 解决合并冲突"

# 5. 推送
git push origin main
```

### 3. 忘记添加文件

```bash
# 添加遗漏的文件
git add forgotten-file.txt

# 修改上次提交
git commit --amend --no-edit

# 强制推送（如果已经推送过）
git push -f origin main
```

### 4. 推送到错误的分支

```bash
# 撤销推送（本地）
git reset --hard HEAD^

# 推送到正确的分支
git push origin correct-branch
```

---

## 📋 推送检查清单

推送前检查：

- [ ] 代码已测试，没有明显错误
- [ ] 敏感信息已删除（密码、密钥等）
- [ ] `.gitignore` 已配置正确
- [ ] 提交信息清晰明确
- [ ] 已拉取最新代码（避免冲突）

---

## 🎓 进阶技巧

### 1. 交互式添加

```bash
git add -p
```
可以选择性地添加文件的部分修改

### 2. 暂存修改

```bash
# 暂存当前修改
git stash

# 查看暂存列表
git stash list

# 恢复暂存
git stash pop

# 删除暂存
git stash drop
```

### 3. 查看差异

```bash
# 查看工作区和暂存区的差异
git diff

# 查看暂存区和仓库的差异
git diff --staged

# 查看两次提交的差异
git diff commit1 commit2
```

### 4. 标签管理

```bash
# 创建标签
git tag v1.0.0

# 创建带注释的标签
git tag -a v1.0.0 -m "版本 1.0.0"

# 推送标签
git push origin v1.0.0

# 推送所有标签
git push origin --tags
```

---

## 📱 图形化工具推荐

如果不习惯命令行，可以使用图形化工具：

1. **GitHub Desktop** - 简单易用
2. **SourceTree** - 功能强大
3. **GitKraken** - 界面美观
4. **VS Code** - 内置Git功能
5. **Tower** - Mac专用，功能完善

---

## 🔗 相关资源

- [Git 官方文档](https://git-scm.com/doc)
- [Git 教程 - 廖雪峰](https://www.liaoxuefeng.com/wiki/896043488029600)
- [GitHub Guides](https://guides.github.com/)
- [Git Cheat Sheet](https://education.github.com/git-cheat-sheet-education.pdf)

---

## 💡 最佳实践

1. **频繁提交**: 小步快跑，每完成一个功能就提交
2. **清晰的提交信息**: 让别人（和未来的自己）能看懂
3. **使用分支**: 新功能在新分支开发，完成后合并
4. **定期推送**: 避免本地代码丢失
5. **拉取后推送**: 推送前先拉取最新代码
6. **检查 .gitignore**: 不要提交敏感信息和临时文件
7. **代码审查**: 推送前检查修改内容

---

**最后更新**: 2024-12-XX  
**作者**: NEXT Store Team