Git 手动改 config 后 WebStorm 未识别分支的解决

git 手动 config 文件后，分支的信息已经修改，但 webstorm 没有识别

解决方法

重新在 webstorm 的 github 管理工具上 fetch 一次最新的分支

为什么 fetch 能解决

WebStorm 不是每次都去读 .git/config，它维护了一份自己的仓库状态缓存：远端列表、分支列表、跟踪关系。这份缓存在打开项目时建立，之后靠文件系统监听和git 操作事件来更新。

手动用编辑器改 .git/config 这个动作，两个触发条件都不满足——它不是 IDE 发起的 git 操作，而 IDE 对 .git/ 目录的监听主要盯着 HEAD、refs/、index 这几个，config 的变化未必会被当成需要重建缓存的信号。所以内存里那份旧的还在用。

fetch 之所以有效，是因为它会走完整的「读 config → 确定远端 URL → 连接 → 更新 refs → 重建分支列表」流程，缓存被整体刷新了一遍。

其他几个刷新手段

按代价从低到高：

Git → Fetch（原文的办法）。最轻，通常够用。
File → Reload All from Disk（Cmd/Ctrl + Alt + Y）。强制重扫文件系统，不联网。
VCS → Refresh File Status。只刷新文件状态，对分支/远端配置的改动帮助有限。
在 IDE 内置终端跑一条 git 命令，比如 git branch -a。IDE 会捕获终端里的 git 调用并触发状态更新（这个行为在不同版本上不太一致，不一定生效）。
File → Invalidate Caches / Restart。彻底重建所有索引，代价是大项目要重新索引几分钟。
关掉项目重新打开。比 Invalidate Caches 轻，够解决大多数状态错乱。

更稳的做法：用 git 命令而不是手改 config

.git/config 是 INI 格式，手工编辑很容易出细微错误——缩进用了空格还是 tab、section 名大小写、URL 里的特殊字符没转义。这些错误 git 有时会静默忽略，表现成「配置好像没生效」，排查起来比 IDE 缓存问题麻烦得多。

改远端和分支跟踪关系一律用命令：

# 改远端 URL
git remote set-url origin git@github.com:user/repo.git

# 加/删远端
git remote add upstream https://github.com/orig/repo.git
git remote remove upstream

# 改远端名字
git remote rename origin github

# 看当前所有远端
git remote -v

# 设置当前分支的上游
git branch --set-upstream-to=origin/main
# 或推送时一并设置
git push -u origin feature/xxx

# 取消上游跟踪
git branch --unset-upstream

# 看分支和上游的对应关系
git branch -vv

用命令改完之后，git 自己写的 config 一定是合法的，而且 IDE 因为监听到了 git 进程的活动，多数情况下会自动刷新，不需要额外操作。

验证 config 到底生效了没

改完 config 想确认它被 git 正确读到了：

# 列出所有生效的配置，带来源文件
git config --list --show-origin

# 只看仓库级配置
git config --local --list

# 查单项
git config --get remote.origin.url
git config --get branch.main.remote

# 检查配置文件语法（有错会直接报出来）
git config --list >/dev/null && echo "config 语法正常"

--show-origin 特别有用。git 的配置分四层，优先级从低到高是：系统级（/etc/gitconfig）→ 全局（~/.gitconfig）→ 仓库级（.git/config）→ 命令行参数。改了仓库级却不生效，有时是被更高优先级的东西覆盖了，--show-origin 一眼能看出某个值是从哪个文件来的。

.git/config 里各段是什么

了解结构之后就知道 IDE 读的是哪些信息：

[core]
	repositoryformatversion = 0
	filemode = true
	bare = false
	autocrlf = input

[remote "origin"]
	url = git@github.com:user/repo.git
	# 决定 fetch 时把远端分支映射到本地哪些引用
	fetch = +refs/heads/*:refs/remotes/origin/*

[branch "main"]
	remote = origin
	merge = refs/heads/main

[branch "xxx"] 段就是「上游跟踪关系」的存储位置。git status 里那句 Your branch is up to date with 'origin/main'、git push 不带参数知道推到哪里，全靠这两行。改分支名之后这一段的 section 名不会自动跟着改，这也是「手改 config 后 IDE 认不出来」的常见触发场景之一。

正确的改分支名方式是：

# 本地改名（git 会自动更新 config 里的 section 名）
git branch -m old-name new-name

# 推新名字并设置上游
git push -u origin new-name

# 删远端的旧分支
git push origin --delete old-name

别去手改 refs 和 index

顺带划一条线：.git/config、.git/info/exclude、.git/hooks/* 这些是文本配置文件，手工编辑虽然不推荐但至少是安全的。.git/index、.git/objects/、.git/refs/ 里的内容是 git 的数据结构，手工改（或者被全局替换脚本误伤）会直接损坏仓库。

要改引用也有命令：

git update-ref refs/heads/main <sha>
git symbolic-ref HEAD refs/heads/main

这两条属于底层命令，日常用不到，但比手写文件安全——它们会做格式校验和引用日志记录。