# 常见错误汇总

URL: https://caijiao.org/git/appendix/errors
Source: docs/git/appendix/errors.md
Description: 本章汇总 Git 使用过程中常见错误及解决方案，帮助用户快速排查和修复问题。

在使用 Git 时，可能会遇到各种错误，以下是一些典型问题及解决方法。

## 1. “fatal: not a git repository”

原因：当前目录不是 Git 仓库。

解决：确认路径正确，或执行 `git init` 初始化。

## 2. “error: failed to push some refs”

原因：远程仓库有更新，本地分支落后。

解决：

```bash
git pull --rebase
git push
```

## 3. “Merge conflict”

原因：合并时文件冲突。

解决：手动解决冲突，添加并提交。

## 4. “detached HEAD”

原因：当前 HEAD 指向某个具体提交，而非分支。

解决：切换到分支 `git checkout <branch>`。

## 5. 权限拒绝（Permission denied）

原因：SSH key 未配置或权限不足。

解决：配置 SSH key 或使用 HTTPS。

## 6. “Your branch is ahead/behind”

原因：本地分支与远程分支不同步。

解决：使用 `git pull` 同步更新。

保持良好操作习惯，及时备份，遇到错误时先查阅错误信息，合理使用命令，有助于高效解决问题。