一、重命名本地仓库
进入仓库目录 打开终端或命令行工具,进入目标仓库目录:
```bash
cd /path/to/old-repo
```
重命名仓库
使用 `git branch -m` 命令重命名本地分支(需先切换到目标分支):
```bash
git branch -m old-repo-name new-repo-name
```
*注意:若当前分支已存在同名分支,需先重命名或切换其他分支。*
更新远程仓库链接(可选)
若需立即更新远程仓库名称,可先解除当前关联再重新设置:
```bash
git remote rm origin
git remote set-url origin new-repo-url
```
*建议先完成所有提交后再进行此操作,避免数据丢失。*
二、同步远程仓库
推送更改
将本地分支推送到新的远程仓库:
```bash
git push -u origin new-repo-name
```
*若远程仓库已有历史记录,需使用 `--force` 选项强制推送(谨慎使用):*
```bash
git push -u origin --force
```
删除旧远程仓库(可选)
推送完成后,可删除旧的远程仓库(如 `origin`):
```bash
git remote rm origin
```
*需确保所有分支和标签已同步到新仓库。*
三、更新全局配置(可选)
若需更改全局的 Git 用户名或邮箱(与仓库名无关,但需同步远程信息):
修改全局配置
```bash
git config --global user.name new_username
git config --global user.email new_email@example.com
```
推送配置到远程
```bash
git push -u origin --config user.name new_username
git push -u origin --config user.email new_email@example.com
```
注意事项
提交历史修改: 直接重命名仓库会打乱提交历史。若需保留历史,可使用 `git filter-branch` 或 `git rebase -i` 重写历史。 分支管理
服务同步:若仓库托管在 GitHub、GitLab 等平台,需在平台界面同步仓库名称。
通过以上步骤,可安全地更改 Git 仓库名称并同步远程信息。