核心结论:切换分支 ≠ 已经更新预览页面,dev 服务、缓存、旧构建产物、未提交改动都会让浏览器继续跑旧分支代码;标准校验思路是:先确认本地 git 工作区确实切到目标分支,然后停止旧预览进程、清理缓存、重新启动服务,再用 commit 哈希双向比对,确认浏览器里加载的代码和当前 git HEAD 一致。
根本原因:前端 / 后端本地 dev 服务大多是常驻进程,不会自动监听 git 分支切换;webpack、vite、tserver 会保留内存里的旧模块;dist、.next 等构建目录残留旧产物;还有 stash、未提交改动覆盖分支文件,造成 “分支切过去了,预览还是老代码”。
一、分步校验流程(按顺序执行)
- 确认 git 当前工作区分支和 commit(终端执行)
只看分支名
git branch --show-current
拿到当前commit完整hash(最关键凭证)
git rev-parse HEAD
看状态:有没有未提交、未跟踪文件
git status
重点:git status 如果有红色改动,说明文件被脏修改覆盖,分支切了但文件不是仓库版本。
- 停止正在运行的预览服务(必做)
- 终端按 Ctrl+C 杀掉 npm run dev /vite/serve /python -m http.server 等进程
- 不要直接切分支后刷新浏览器,旧进程还在内存里跑旧代码
- 清理旧构建缓存(高频踩坑点)
前端常见
rm -rf node_modules/.cache dist .next .vite
python/静态项目:删除__pycache__、build
- 重新启动本地预览服务
示例
npm run dev
yarn dev
pnpm dev
- 双向验证:让页面输出 commit,和终端 hash 比对
方案 A(临时调试,最快):在入口文件加一行,浏览器控制台打印 commit
console.log('current commit:', '__GIT_COMMIT__')
启动时注入,vite/webpack 可以用 define 注入;刷新页面,console 拿到 hash,和 git rev-parse HEAD 输出对比,一致 = 预览是当前分支代码。
方案 B(浏览器人工特征校验):在当前分支加一个唯一标记(比如页面角落文字、一个独特 console.log),切分支后看标记是否出现。
- 兜底比对:直接对比文件内容
拿同一个文件,对比仓库版本和浏览器 source 面板里的源码:
git show HEAD:src/App.js
和浏览器 DevTools Sources 里的 App.js 对比。
二、一张表区分:工作区、服务进程、浏览器缓存
| 对象 | 是否自动跟随 git 切换 | 影响 |
|---|---|---|
| git 工作区文件 | ✅ 切换分支会更新(无冲突时) | 文件源头 |
| dev 服务进程内存模块 | ❌ 不会自动刷新 | 最常见元凶 |
| dist / 构建产物目录 | ❌ 残留旧打包结果 | 静态预览坑 |
| 浏览器内存缓存、http 缓存 | ❌ 强缓存 | 刷新也没用,需要硬刷新 Ctrl+Shift+R |
| IDE 自动保存临时文件 | ❌ 未提交改动会覆盖 | git status 能看到 |
三、自动化方案(长期根治)
- 启动脚本自动注入 branch、commit 到页面全局变量,浏览器 console 直接查看
- 开发脚本前置检查:启动 dev 前校验 git 分支、打印 hash,有未提交改动告警
- vite/webpack 插件:监听 git HEAD 变化,自动重启服务(不推荐默认开启,耗性能)
- 专用组件:开发环境页面角落渲染 branch+commit 标签,生产环境自动移除npm
四、高频坑清单
- 只看 IDE 右下角分支,不杀 dev 服务:IDE 分支是 git 状态,和服务进程无关
- 有 stash 暂存:切换分支后 stash pop,会把别的分支改动带进来
- 分离 HEAD(detached HEAD):没有分支名,只能靠 commit hash 判断
- 框架 SSR/SSG:Next、Nuxt 的缓存特别顽固,只清.cache 不够
- 多终端:一个终端跑 dev,另一个终端切分支,两个终端互相独立
【相关 FAQ】
问题 1:git 已经切换分支,为什么刷新页面预览还是旧代码?
回答 1:本地 dev 服务是常驻进程,内存里缓存了旧模块,不会感知 git 分支切换;需要 Ctrl+C 停掉服务,清缓存,重新启动 dev,再刷新。
问题 2:怎么最稳妥确认浏览器预览跑的 commit 和本地 git 一致?
回答 2:终端执行 git rev-parse HEAD 获取 commit 哈希;在页面注入 commit 并打印到浏览器 console,两边哈希完全一致,才代表预览是当前分支代码。
问题 3:git status 显示干净,重启 dev 之后页面还是不对,下一步查哪里?
回答 3:优先检查构建缓存目录(.vite、.next、dist)、浏览器强缓存;用 Ctrl+Shift+R 硬刷新,或者打开 DevTools 勾选 Disable cache。
问题 4:能不能让 dev 服务自动跟随 git 分支切换、自动重启?
回答 4:可以用插件监听 git HEAD 变更自动重启,但不建议默认开启;分支切换频繁时会频繁重启打断开发,更推荐手动校验 + 脚本注入 commit 的方式。
【参考资料】
[2026-03-10] git 官方文档 git rev-parse /git branch --show-current
[2026-04-17] vite 开发服务模块缓存机制
[2026-07-02] branch-beacon 前端分支标记组件说明
[2025-12-01] 前端本地开发:分支切换后缓存排查实践
免责声明
这套校验流程适用于绝大多数前端、静态站点、简单后端本地预览;不同框架(Next、Nuxt、Astro、Django)缓存目录、dev 服务行为有差异;如果是容器、docker 本地预览,还要额外确认容器内代码卷同步。
本文来自作者[辰轨接力站]投稿,不代表华夏商讯网立场,如若转载,请注明出处:https://www.bbshuaxia.cn/rgzn/202611/9061.html
评论列表(4条)
我是华夏商讯网的签约作者“辰轨接力站”!
希望本篇文章《切换分支以后,怎样确认本地预览跑的是哪份代码》能对你有所帮助!
本站[华夏商讯网]内容主要涵盖:互联网行业的追踪与探索
本文概览:核心结论:切换分支 ≠ 已经更新预览页面,dev 服务、缓存、旧构建产物、未提交改动都会让浏览器继续跑旧分支代码;标准校验思路是:先确认本地 git 工作区确实切到目标分支,然后停止旧预览进程、清理缓存、重新启动服务,再用 commit 哈希双向比对,确认浏览器里加载的代码和当前 git HEAD 一致。