Git技巧：彻底重置本地仓库与远程同步，同时保留Stash内容

# Git技巧：彻底重置本地仓库与远程同步，同时保留Stash内容

在使用 Git 的过程中，我们有时会遇到需要将本地仓库完全重置为远程仓库的状态，比如要丢弃所有本地的修改、提交，重新开始一个干净的工作目录，但又希望保留之前暂存（stash）的代码片段，以便后续应用。本文将详细介绍如何实现这一目标，并附上获取远程仓库名称的方法作为前置准备。

---

## 1. 查看远程仓库信息

在执行重置操作前，首先需要确认当前仓库关联的远程仓库名称（通常是 `origin`）。如果不确定，可以通过以下命令查看：

### 列出所有远程仓库名称
```bash
git remote
```
输出示例：
```
origin
```

### 查看远程仓库详细信息（含 URL）
```bash
git remote -v
```
输出示例：
```
origin https://github.com/user/repo.git (fetch)
origin https://github.com/user/repo.git (push)
```

### 查看当前分支跟踪的远程仓库
```bash
git branch -vv
```
输出中会显示当前分支跟踪的远程分支，例如：
```
* main abc123 [origin/main] Latest commit message
```
这里的 `origin/main` 表示远程仓库名为 `origin`，远程分支为 `main`。

确认远程仓库名称后，我们就可以进行下一步操作了。通常默认名称为 `origin`，后续命令中将以此为例。

---

## 2. 完全重置本地仓库并保留 Stash

核心思路是利用 `git fetch` 获取远程最新代码，然后用 `git reset --hard` 将本地分支指向远程分支，再用 `git clean` 清除未跟踪的文件。由于 `stash` 是以特殊引用存储在 Git 内部，这些操作不会影响已有的 stash 条目。

### 2.1 检查当前状态
先确认是否有未提交的修改，如果这些修改尚未 stash，后续操作会永久丢失。
```bash
git status
git stash list # 查看现有的 stash 记录
```

如果还有未 stash 的工作（比如正在开发但不想丢失的代码），立即将其存入 stash：
```bash
git stash push -m "临时修改，准备重置仓库"
```
这会将所有未提交的修改（包括暂存区和工作区的修改）保存为一个新的 stash 条目。

### 2.2 获取远程最新代码
从远程仓库拉取所有分支的最新提交，但不自动合并：
```bash
git fetch origin
```
如果远程仓库名不是 `origin`，请替换为实际名称。

### 2.3 重置本地分支到远程分支
假设当前分支名为 `main`（可使用 `git branch --show-current` 查看），执行硬重置：
```bash
git reset --hard origin/main
```
这条命令会将当前分支的 HEAD 指向 `origin/main` 的最新提交，同时重置暂存区和工作区，使其与远程分支完全一致。**所有本地的未提交修改和本地提交都会被丢弃，但 stash 不受影响。**

### 2.4 清理未跟踪的文件和目录
即使重置了工作区，还可能存在未被 Git 跟踪的文件（如编译产物、临时文件等），需要一并清除：
```bash
git clean -fd
```
- `-f`：强制删除
- `-d`：同时删除未跟踪的目录

如果想先预览将被删除的文件，可以执行 `git clean -fdn`，它会显示将要删除的列表，但不会实际删除。

### 2.5 验证 stash 仍然存在
重置和清理完成后，再次查看 stash 列表，确认之前的 stash 条目还在：
```bash
git stash list
```
如果看到之前保存的 stash 记录，说明操作成功。

---

## 3. 恢复和应用 Stash

现在你的本地仓库已经完全与远程同步，且 stash 完好无损。你可以随时根据需要应用这些 stash：

- **应用并删除最近的 stash**：
```bash
git stash pop
```

- **应用指定的 stash 但不删除**：
```bash
git stash apply stash@{0}
```

如果新拉取的代码与 stash 中的修改有冲突，`pop` 或 `apply` 时会提示解决冲突，按照 Git 常规的冲突解决流程处理即可。

---

## 4. 常见问题与注意事项

### Q1：为什么 `stash` 不会在重置时丢失？
A：`stash` 本质上是以特殊引用 `refs/stash` 和 Git 对象的形式存储在 `.git` 目录中。`git reset --hard` 和 `git clean` 只操作工作区、暂存区和当前分支引用，不会触及 stash 的引用或对象，因此 stash 始终保留。

### Q2：如果我有多个分支需要重置怎么办？
A：上述操作仅影响当前分支。如果你需要重置其他分支，请先切换到对应分支（如 `git checkout dev`），然后重复步骤 2.2 到 2.4。注意切换分支前确保当前工作区干净（可用 `git stash` 暂存当前工作）。

### Q3：执行 `git clean -fd` 后，发现误删了未跟踪的重要文件怎么办？
A：`git clean` 会永久删除文件，无法通过 Git 恢复。因此建议在执行前用 `git clean -fdn` 预览，或提前备份重要文件（如配置文件）。如果文件曾经被提交过，可以通过 `git checkout` 恢复，但从未被跟踪的文件将无法找回。

### Q4：重置后如何重新设置上游分支？
A：通常重置后，当前分支仍保留原有的上游设置（因为 `git reset` 不改变分支配置）。如果需要重新设置上游，可以执行：
```bash
git branch --set-upstream-to=origin/main main
```

### Q5：我的远程仓库有多个，如何指定？
A：在 `git fetch` 和 `git reset` 中使用对应的远程名称即可。例如，如果远程名为 `upstream`，则执行 `git fetch upstream` 和 `git reset --hard upstream/main`。

---

## 总结

通过 `git fetch` + `git reset --hard` + `git clean -fd` 的组合，我们可以轻松地将本地仓库完全重置为远程仓库的最新状态，同时保留所有 stash 内容。这种方法非常适合需要丢弃本地修改、清理工作区、但又不想丢失暂存代码的场景。操作前请务必确认当前分支和远程名称，并备份重要数据，以避免意外丢失。

希望本文对你有所帮助，如果你有其他 Git 使用技巧或问题，欢迎在评论区交流讨论。