Git冲突：commit your changes or stash them before you can merge

封面图 • 2026-01-08 • git

你遇到的错误信息：

```
fatal: cannot merge with work tree dirty
```

或者类似的提示，例如：

```
commit your changes or stash them before you can merge
```

这表示你在执行 `git merge` 或 `git pull` 之前，**工作目录中有未提交的更改**（即“dirty”），而 Git 不允许在有未提交更改的情况下直接合并。

---

### ✅ 解决方法

#### 方法一：**提交你的更改**

如果你已经完成了修改，并希望保留这些更改，可以先提交它们：

```bash
git add .
git commit -m "Your commit message"
```

然后再次尝试合并：

```bash
git merge <branch-name>
```

或：

```bash
git pull origin <branch-name>
```

---

#### 方法二：**暂存（Stash）你的更改**

如果你不想立即提交这些更改，但想继续合并，可以使用 `git stash` 暂存当前的工作：

```bash
git stash
```

然后执行合并操作：

```bash
git merge <branch-name>
```

合并完成后，如果需要恢复你的更改，可以：

```bash
git stash pop
```

> 注意：如果合并后有冲突，`git stash pop` 可能会失败，建议先解决冲突后再应用暂存的内容。

---

#### 方法三：**强制合并（不推荐）**

如果你确定不需要保留未提交的更改，可以强制覆盖：

```bash
git reset --hard
git merge <branch-name>
```

> ⚠️ 这会丢弃所有未提交的更改，谨慎使用。

---

### 📌 总结

| 情况 | 建议 |
|------|------|
| 有未提交的更改，想要保留 | 使用 `git add` 和 `git commit` 提交 |
| 有未提交的更改，暂时不想提交 | 使用 `git stash` 暂存 |
| 不需要保留更改 | 使用 `git reset --hard` 清空工作目录 |

如果你告诉我你具体做了什么操作（比如 `git pull` 或 `git merge`），我可以给你更具体的建议。