Git切换分支报“working tree is dirty”是保护机制，需stash、restore或-f解决；“ambiguous argument”因远程分支未fetch，应先git fetch再switch；切换后代码未变可能因detached HEAD或误切远程分支；子模块需手动init+update。
git checkout 或 git switch 报错“working tree is dirty”
本地有未提交的修改时，Git 默认拒绝切换分支，防止改动被覆盖。这不是 bug，是保护机制。
常见错误信息：error: Your local changes to the following files would be overwritten by checkout 或 error: cannot switch branch with uncommitted changes。
解决思路分三类，按实际需求选：
- 想保留修改：先
git stash暂存，切完分支再git stash pop - 想丢弃修改：用
git restore .（推荐）或git checkout -- .（旧版兼容）清空工作区 - 强制覆盖（极慎用）：加
-f参数，如git switch -f main，但会直接丢弃所有未暂存/未提交变更
注意：git restore 是 Git 2.23+ 引入的明确语义命令，比 git checkout -- 更安全、意图更清晰；若你用的是较老 Git 版本，git checkout -- . 仍有效，但容易和分支切换命令混淆。
git switch 提示“ambiguous argument 'xxx'”
说明 Git 找不到名为 xxx 的本地分支，但它可能存在于远程（比如 origin/feat/login），而你还没把它拉下来。
典型场景：同事刚推了一个新分支，你本地 git branch -a 看不到它，直接 git switch feat/login 就报这个错。
正确做法是先同步远程分支引用：
-
git fetch origin—— 获取所有远程分支最新指针（不改本地任何东西） - 再执行
git switch feat/login—— Git 会自动识别这是个远程跟踪分支，并为你创建同名本地分支，同时设置上游为origin/feat/login
等价于手动执行：git checkout -b feat/login origin/feat/login，但 git switch 更简洁、意图更纯粹（只负责切换，不混杂创建逻辑）。
切换后代码没变？检查是否真在目标分支上
有时终端显示已切换成功，但文件内容还是旧的——大概率是因为当前工作区处于“分离头指针（detached HEAD）”状态，或者你切换的是一个远程跟踪分支（如 origin/main）而非本地分支。
验证方式：
- 运行
git status，看第一行是否显示On branch xxx；如果显示HEAD detached at xxx，说明没在本地分支上 - 运行
git branch，确认星号*是否标在目标分支名前 - 运行
git log --oneline -n 3，对比提交哈希与你预期分支的最新提交是否一致
常见诱因：
- 误执行了
git checkout abc1234（用 commit ID 切换） - 执行了
git switch origin/main（把远程分支当成本地分支切） - VSCode 状态栏显示分支名，但终端里
git branch并未激活该分支（多窗口/多终端不同步）
子模块目录为空，切换分支后不自动更新
Git 默认不会递归初始化或更新子模块，即使你在新分支上看到 .gitmodules 文件，子模块目录也可能是空的——这和分支切换本身无关，而是子模块状态未同步。
关键命令只有两个，缺一不可：
-
git submodule init—— 读取.gitmodules，把子模块路径注册进.git/config -
git submodule update --recursive—— 拉取子模块代码，并检出其对应 commit（含嵌套子模块）
如果你经常切换带子模块的分支，建议把这两步写成 alias：
git config --global alias.su "submodule update --init --recursive"
之后只需 git su 即可一键完成。注意：某些 CI 或 Docker 环境中，--recursive 可能因网络策略失败，需单独处理嵌套层级。
最易被忽略的一点：子模块的 commit ID 是硬编码在父仓库的每次提交里的。切换分支时，Git 只会还原父仓库的 .gitmodules 和子模块的“期望 commit”，但不会自动拉代码——必须显式执行 update。这点和普通文件完全不同，也是多人协作中子模块“突然消失”的根本原因。
