切换分支之后,只看终端 git 当前分支是不够的,最核心的判断逻辑是:先确认本地工作区文件已经切到目标分支,再重启本地预览服务,最后核对页面、源码、commit 哈希三者一致;很多人踩坑就是分支切好了,但之前启动的 dev 服务进程还在跑旧分支的打包缓存,浏览器也有缓存,页面内容不会跟着 git 分支自动更新,所以要分仓库校验、服务校验、页面校验三层来确认,三层都对上才代表预览跑的就是当前分支代码。
一、第一步:校验本地仓库是不是已经切到目标分支
这一步是确认磁盘上的源码文件本身,是不是目标分支版本
- 终端执行查看当前分支:git branch --show-current,直接输出当前分支名
- 查看 commit 哈希(最准):git rev-parse HEAD,拿到一串 commit id,用来后续比对
- 查看工作区有没有残留改动:git status,如果有未提交修改,会覆盖分支原始代码,造成预览内容和分支不一致
- IDE 快捷查看:WebStorm、IDEA、VSCode 左下角直接显示当前分支
重点提醒:git 切换成功 ≠ 本地预览服务自动更新
二、第二步:校验本地预览服务(最容易踩坑)
| 检查项 | 操作方式 | 判断标准 |
|---|---|---|
| 旧服务进程 | 关掉原来的 dev 窗口,kill 端口进程,重新执行 npm run dev /yarn dev | 服务是切换分支之后新启动的,不是之前遗留进程 |
| 打包缓存 | 删除 node_modules/.vite、.cache、dist 这类缓存目录 | 避免读取旧分支的编译产物 |
| 构建日志 | 看启动日志,部分脚手架可以打印分支、commit 信息 | 日志里的 commit 和 git 拿到的 HEAD 哈希一致 |
三、第三步:校验浏览器预览页面(最终验证)
- 浏览器强制刷新:Ctrl+F5(Windows)、Cmd+Shift+R(Mac),绕过浏览器缓存
- 查看页面源码 / Network 面板:找版本标记、打印 commit、分支变量;项目里提前写版本水印最稳
- 埋点方案(推荐长期用):构建时注入 git 分支、commit 哈希,页面上展示版本号,一眼就能确认预览代码版本
- 对比特征代码:找这个分支独有的改动(新增按钮、文案、接口),看页面是否出现这个改动
四、快速排查清单(按顺序执行)
- 确认 git 分支、commit 哈希 ✅
- 关闭旧 dev 服务,清理缓存 ✅
- 重新启动本地预览服务 ✅
- 浏览器强制刷新,关闭浏览器缓存 ✅
- 核对页面特征或者页面打印的 commit ✅
五、常见坑总结
- 坑 1:只切分支,不重启 dev 服务:进程还在内存跑旧代码,页面不变
- 坑 2:重启服务但没清缓存:vite/webpack 缓存旧产物
- 坑 3:工作区有未提交修改:git 分支是 A,但是本地改了文件,预览是修改后的混合版本
- 坑 4:浏览器缓存,就算代码变了页面还是旧的
【相关 FAQ】
问题 1:切换 Git 分支后,怎么确认本地预览跑的是哪份代码?
回答 1:先查 git 当前分支和 commit 哈希,关闭旧预览服务、清理打包缓存,重启本地 dev 服务,浏览器强制刷新,核对页面独有改动或者页面输出的 commit,三者一致,就代表预览跑的是当前分支代码。
问题 2:Git 分支切换成功,但本地预览页面还是旧分支代码是什么原因?
回答 2:大概率是本地预览服务进程没有重启、脚手架缓存没清理、浏览器缓存没清,dev 服务不会自动监听 git 分支变化,不会跟着分支自动重新编译代码。
问题 3:切换 Git 分支后,只用 git status 命令就能确认本地预览代码版本吗?
回答 3:不能,git status 只能确认磁盘源码的分支状态,没法确认正在运行的预览服务、浏览器加载的代码,磁盘代码和正在跑的预览服务是两套东西。
问题 4:怎么让本地预览页面直接显示当前 Git 分支和 commit,方便快速确认?
回答 4:在 vite/webpack 构建脚本里读取 git 分支、commit 哈希,注入到全局变量,渲染到页面角落水印,每次启动预览自动打印版本信息,不用手动核对。
【参考资料】
[2026-10-12](Vite 本地开发缓存机制说明)Vite 官方文档
[2026-09-03](git branch --show-current 查看当前分支)Git 官方文档
[2026-07-15](VSCode 查看 git 分支、工作区状态)VSCode 官方文档
[2026-05-20](前端切换分支后 dev 服务缓存问题排查)掘金社区
【免责声明】
本文为前端本地开发、Git 分支切换场景的排查方案,不同脚手架(Vite、Webpack、Taro 等)缓存目录、热更新行为存在差异;本地预览结果受进程、缓存、未提交修改共同影响,最终以 commit 哈希比对结果为准,不覆盖 SSR、微服务等特殊架构场景。
