# git remote 参考

URL: https://caijiao.org/reference/git/remote
Source: docs/reference/git/remote.md
Description: git remote Reference，整理查看、添加、修改、删除远程仓库，origin、set-url、remote -v、remote show 和常见错误。

`git remote` 用于管理远程仓库地址。最常见的远程名是 `origin`，但一个仓库可以配置多个远程。

## 语法

```bash
git remote -v
git remote add <name> <url>
git remote set-url <name> <url>
```

## 常用命令

查看远程仓库：

```bash
git remote -v
```

添加远程仓库：

```bash
git remote add origin git@github.com:user/repo.git
```

修改远程地址：

```bash
git remote set-url origin git@github.com:user/new-repo.git
```

删除远程：

```bash
git remote remove origin
```

查看远程详情：

```bash
git remote show origin
```

## 常见错误

- HTTPS 和 SSH 地址混用，导致认证方式和凭据不一致。
- 修改 remote 后没有检查 `git remote -v`，仍推送到旧仓库。
- fork 项目里只配置 origin，没有 upstream，后续同步上游不方便。

## 相关内容

- [Git Reference](/reference/git/)
- [Git 如何修改 remote](/how-to/git/change-remote-url)
- [Git 远程仓库添加](/git/remote/add)
- [Git 远程协作](/git/remote/branch-collab)
- [git-remote 官方文档](https://git-scm.com/docs/git-remote)