git config --global --show-origin --list 是最可靠的命令，能准确显示每个全局配置项的实际来源文件路径，不受环境变量干扰，直接揭示 git 当前读取的全局配置位置。
git config --global --show-origin --list 是最可靠的命令
这个命令能直接告诉你每个全局配置项来自哪个文件，不靠猜、不依赖系统默认路径。Git 本身负责解析环境变量（如 HOME 或 USERPROFILE），所以输出的 file: 路径一定是它实际读取的位置。
常见错误现象：运行 git config --global --list 只看到键值对，却不知道配置写在哪；或者在 Windows 上改了 C:\Users\XXX\.gitconfig，但 Git 仍读的是 %HOME%\.gitconfig（如果 HOME 被设为其他盘符）。
- 必须加
--show-origin，否则看不到来源 - 加
| head -n 3就够用，第一行就是路径 - 如果输出里没有
file:开头的行，说明当前没设任何全局配置（不是文件不存在）
Windows 下别只认 C:\Users\XXX\.gitconfig
Git 在 Windows 上优先检查 HOME 环境变量，其次才是 USERPROFILE。很多工具（如 MSYS2、某些 IDE 内置终端）会主动设置 HOME 到非系统盘或自定义路径，导致 .gitconfig 被创建在 D:\myhome\.gitconfig 这类位置。
实操建议：
- 先查环境变量：
echo %HOME%（CMD）或$env:HOME（PowerShell） - 再确认该路径下是否存在
.gitconfig：dir %HOME%\.gitconfig - 如果
HOME为空，再查%USERPROFILE%\.gitconfig - 注意：Git Bash 默认设
HOME为/c/Users/XXX，而 CMD 不设，所以同一台机器上不同终端可能读不同文件
macOS / Linux 用户要留意 XDG 规范路径
较新版本 Git（2.35+）在未找到 ~/.gitconfig 时，会 fallback 到 ~/.config/git/config。这个路径遵循 XDG Base Directory 规范，但不是所有 Git 版本都默认启用。
批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。 当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。 触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。
容易被忽略的点：
-
~/.config/git/config和~/.gitconfig是互斥的——Git 只读其中一个，不会合并 - 如果两个文件都存在，Git 通常只读
~/.gitconfig；但某些打包版本（如 Homebrew 安装的 Git）可能行为不同 - 用
git config --global --show-origin --list是唯一能确认当前生效路径的方式 - 手动创建
~/.config/git/config后，需确保目录权限正确：chmod 700 ~/.config/git
配置没生效？先确认你改的是哪一层
Git 配置有 system / global / local 三级，同名 key 以 local 为准。很多人以为改了 --global 就全局生效，结果发现当前仓库里还是旧值——大概率是 .git/config 里写了同名配置覆盖了它。
排查步骤：
- 运行
git config --list --show-origin（不带任何作用域），看所有层级的配置和来源 - 重点检查输出中是否有
file:.git/config行，且其值与file:/xxx/.gitconfig不一致 - 删掉本地仓库里的干扰项：
git config --unset user.name（不加--global就作用于 local） - 注意：
git config --global永远只操作全局文件，不会碰.git/config，也不会自动同步到已有仓库
真正麻烦的从来不是找不到文件，而是多个配置源共存且优先级隐晦。只要记住 --show-origin 是唯一真相，其它都是辅助验证。
