发布版本时切换生产分支需确保工作区干净、目标分支最新、线上代码可追溯：先 git status 检查状态，用 stash 或 checkout -- 恢复未提交修改；fetch 后 switch main，或用 --track 建立跟踪；切完用 git log、git tag 和 git rev-parse 核验 commit 是否与线上一致。
发布版本时切换生产分支，核心不是“切过去就完事”，而是确保当前工作区干净、目标分支最新、线上代码可追溯。直接 git switch main 很可能失败或埋雷。
切换前必须检查工作区状态
Git 默认禁止在有未提交修改时切换分支，这是保护机制，不是障碍。硬切会丢改动，别用 git checkout -f 强行覆盖。
- 运行
git status看是否有modified、untracked文件 - 如果有临时调试代码但还不想提交：先
git stash暂存，切完再git stash pop - 如果只是误改配置（如
.env），用git checkout -- .env单文件还原 - 千万别对未暂存文件执行
git clean -fd，除非你 100% 确认那些文件不重要
远程生产分支可能本地不存在
常见错误是输 git switch origin/main 报 invalid reference —— 因为 origin/main 是远程引用，不能直接检出。
- 先拉取最新远程信息：
git fetch origin - 再安全切换：
git switch main（Git 2.23+ 会自动关联origin/main） - 如果本地没有
main分支，用git switch --track -c main origin/main显式建立跟踪 - 切完立刻验证：
git log -1 --oneline看 HEAD 是否指向预期的 release commit
切换后要确认是否真同步到线上状态
光切到 main 不代表代码就是线上正在跑的版本。很多团队用 tag 标记发布点，而不是靠分支头指针。
- 查最近发布的 tag：
git tag --sort=-v:refname | head -3 - 检出指定发布版本：
git switch -d v2.1.0（detached HEAD 是正常行为，发布验证就该这样） - 如果必须基于分支发布，且团队约定
main始终等于线上，那就强制同步：git reset --hard origin/main（仅限你确定没人正在往main推送） - VSCode 用户可开启
"git.pullBeforeCheckout": true，但注意它只拉不 reset，仍需手动校验
最常被忽略的一点：切换生产分支不是开发动作的终点，而是部署流程的起点。切完必须核对 git rev-parse HEAD 输出是否与 CI/CD 流水线记录的 commit hash 一致——差一个字符，就不是那个发布版本。
