仓库改名与远程地址迁移

仓库改名不是重新初始化项目，也不是强制覆盖远程历史。正确做法是：先在平台确认新名称，再核对本地工作区和远程地址，最后用一次可验证的推送完成迁移。

1. 迁移前的安全检查

不要在用户根目录初始化仓库。先进入项目自己的目录，并确认 Git 状态：

cd "C:\path\to\project"
git rev-parse --show-toplevel
git status

如果有未提交改动，先决定提交、暂存或另行备份；不要在状态不明时改远程地址。

git remote -v
git branch --show-current
git log --oneline -5

迁移前至少确认三件事：当前分支名称、远程仓库所有者、远程仓库旧名称。

在 GitHub 的仓库设置中修改 Repository name。平台通常会保留旧地址的跳转，但本地配置不应依赖这个跳转，应主动写入新地址。

如果仓库是 GitLab，操作顺序相同；只需将主机名和项目路径替换为 GitLab 的地址。

git remote set-url origin https://github.com/用户名/新仓库名.git
git remote -v

HTTPS 推送应使用 GitHub Token 或平台要求的凭据，不要把账号密码写进命令、脚本或笔记。

git remote set-url origin git@github.com:用户名/新仓库名.git
git remote -v

先验证 SSH 身份，再测试远程读取：

ssh -T git@github.com
git ls-remote origin HEAD

看到平台返回已识别的用户名，且 git ls-remote 能返回 HEAD，才说明认证和仓库路径都正确。SSH 密钥、ssh-agent 与代理配置见代码托管与版本控制中的独立排障笔记。

git fetch origin
git status
git push -u origin main

如果默认分支不是 main，将命令中的分支名替换为实际分支。推送后再次检查：

git remote -v
git log --oneline --decorate -5
git ls-remote --heads origin

本地最新提交的短哈希应能在远程分支列表中找到。若仓库是私有仓库，还要确认当前 Token 或 SSH 身份对该仓库具有读写权限。

在代理环境中，HTTPS 可能出现 TLS connect error、unexpected EOF 或连接超时。不要立即使用 git push -f，按下面顺序定位：

git remote -v：确认地址没有仍指向旧仓库。
git ls-remote origin：区分“地址/权限错误”和“提交阶段网络错误”。
git config --show-origin --get-regexp "http.*proxy|https.*proxy"：确认 Git 代理是否指向仍在运行的本地端口。
用浏览器或 curl 验证代理本身，再决定继续使用 HTTPS 还是切换 SSH。

如果 SSH 已配置完成，通常只需切换远程地址，不需要重新复制项目或重写提交历史。

代理只改变网络路径，不会修复错误的仓库地址或权限。切换代理后重新执行 git ls-remote origin，不要把“能连上 GitHub”误认为“能写入目标仓库”。

只有在明确确认远程历史可以被本地替换时，才考虑：

git push --force-with-lease origin main

--force-with-lease 仍然可能覆盖远程提交；普通改名迁移不需要强制推送。

现象	判断	处理
`repository not found`	路径错误或身份没有仓库权限	核对所有者、仓库名与 Token/SSH 身份
`permission denied (publickey)`	SSH 未加载正确密钥	检查 `ssh-add -l`、`ssh -T git@github.com` 与 `~/.ssh/config`
`TLS connect error`	HTTPS 与代理或证书链路不稳定	先检查 Git 代理，再切换 SSH
`non-fast-forward`	远程有本地没有的提交	`git fetch` 后比较历史，必要时合并；不要直接强推
推送成功但网页仍显示旧内容	站点构建或缓存尚未更新	检查 CI/Pages 部署状态和实际 commit，不要重复推送

仓库改名的最小安全流程是：保存本地状态 → 平台改名 → 更新 origin → git ls-remote 验证 → 普通推送 → 核对远程提交。SSH 代理属于网络排障，不应和仓库改名混成一份无层次的命令堆。