IntelliJ IDEA 中修改 Git 远程仓库地址

HTTPS 协议示例：

git remote set-url origin https://gitee.com/xx/xx.git 

修改远程地址

git remote set-url origin <新地址>

查看当前远程仓库地址

git remote -v 

方法 2：删除后重新添加远程仓库

添加新的远程仓库地址

git remote add origin <新地址>

删除旧的远程仓库地址

git remote remove origin 

四、高级操作：直接编辑 .git/config 文件

方法 3：手动修改配置文件

1. 定位 .git 目录 打开项目根目录，找到隐藏的 .git 文件夹。
2. 保存并验证 保存文件后，在 Terminal 中运行 git remote -v 确认修改。

编辑 config 文件 使用文本编辑器打开 .git/config 文件，找到 [remote "origin"] 部分，修改 url 字段为新地址。例如：

[remote "origin"]
    url = https://gitee.com/xx/xx.git
    fetch = +refs/heads/*:refs/remotes/origin/*

五、批量修改多个项目的远程仓库地址

场景：多个项目需要统一迁移到新仓库

1. Bash 脚本（Linux/macOS）

#!/bin/bash
# 遍历所有子目录
for dir in */; do
    if [ -d "$dir/.git" ]; then
        echo "正在修改 $dir 的远程地址..."
        cd "$dir"
        git remote set-url origin https://new-remote-url.git
        git remote -v # 验证修改
        cd ..
    fi
done

2. PowerShell 脚本（Windows）

Get-ChildItem -Directory | ForEach-Object {
    if (Test-Path "$($_.FullName)\.git") {
        Write-Host "正在修改 $($_.Name) 的远程地址..."
        Set-Location $_.FullName
        git remote set-url origin https://new-remote-url.git
        git remote -v # 验证修改
    }
}

六、常见问题与解决方案

1. 权限问题

• HTTPS 协议：推送时需输入用户名和密码（或使用 Personal Access Token）。
• SSH 协议：需确保密钥已添加到远程仓库账户，并通过 ssh -T [email protected] 测试连接。

2. 冲突处理

如果新仓库已有内容（如 README.md），需先拉取并合并：

git pull origin main --allow-unrelated-histories 

3. 多远程仓库

修改多个远程仓库时，需分别操作：

git remote set-url origin https://new-origin-url.git
git remote set-url upstream https://new-upstream-url.git 

4. IDEA 缓存问题

• 修改后需刷新远程仓库列表：

打开 VCS > Git > Fetch，或运行：

git remote update 

七、迁移 SSH 密钥（适用于 2FA 启用场景）

步骤 1：导出旧密钥

从旧平台（如 GitHub）的 SSH 密钥页面复制公钥内容，或从本地 .pub 文件中提取。

步骤 2：添加到新平台

登录新平台（如 Gitee），进入 用户设置 > SSH 密钥，粘贴密钥并保存。

步骤 3：生成访问令牌（如启用 2FA）

在新平台的 Access Tokens 页面生成一个带有 repo 权限的 Token，后续 HTTPS 操作可使用 Token 代替密码。

八、推送代码到新仓库

1. 首次推送并设置上游分支

git push -u origin main 

• -u 参数会关联本地分支与远程分支，后续只需运行 git push。

2. 验证推送结果

• 登录远程仓库平台，确认代码已同步。

运行以下命令检查分支跟踪状态：

git branch -vv 

九、总结与最佳实践

最佳实践建议

1. 备份配置：修改前备份 .git/config 文件，防止误操作导致数据丢失。
2. 验证优先：每次修改后运行 git remote -v 验证地址。
3. 权限同步：确保新仓库的访问权限与团队成员一致。
4. 文档记录：将修改步骤记录在项目 Wiki 或团队文档中，便于协作。

十、附录：常用命令速查表