git切换分支提示有未提交修改但工作树干净 各类修复方案均失效

这类“工作树干净但切分支报本地变更会被覆盖”的矛盾，本质是本地Git索引的状态和实际文件不匹配：当前apps/content/package.json的工作树内容和当前分支的提交版本完全一致，因此git status判定工作树无变更、git stash也找不到可暂存的内容；但跨分支对比时发现staging分支上该文件的版本和本地存储的版本有差异，叠加文件残留的特殊标记，就会触发这个逻辑矛盾的报错。

按从低干预到高干预的顺序执行以下操作就能解决：

• 全量刷新Git索引缓存
  执行git update-index --refresh，让Git重新扫描所有工作树文件，和索引做一次全量状态对齐，清除残留标记带来的状态偏差。执行完再试一次切分支。
• 排查并清除文件的特殊隐藏标记
  执行git ls-files -v apps/content/package.json查看该文件的Git属性：
  • 如果输出行开头是小写s，说明文件被开启了skip-worktree标记，这个标记会让Git完全忽略该文件的所有工作树修改，是这类矛盾报错的最常见诱因。执行git update-index --no-skip-worktree apps/content/package.json关闭标记。
  • 如果输出行开头是小写h，说明文件被开启了assume-unchanged标记。这个标记你之前已经执行过命令关闭，可跳过该类标记的处理。
    标记全部清除后再次尝试切分支。
• 重置目标文件的索引条目
  如果清完标记还是报错，执行git checkout HEAD -- apps/content/package.json，用当前分支提交里存储的该文件版本，强制覆盖本地索引里的对应条目，彻底消除索引的状态偏差。执行完再试切分支。
• 全量重置本地索引状态
  前面的操作都失效的话，执行git read-tree --reset -u HEAD，把整个本地索引重置到和当前分支提交完全匹配的状态。这个操作不会改动工作树里的实际文件内容，能解决绝大多数索引和工作树不同步的顽固问题。执行完再试切分支。
• 零影响兜底方案：用Git Worktree临时检出目标分支
  所有常规操作都失效时，完全不需要改动当前工作树的异常状态，直接执行git worktree add ./temp-staging staging，就会在当前目录下生成独立的staging分支工作目录，需要的操作都可以在这个临时目录里完成。处理完后执行git worktree remove ./temp-staging就能清掉临时目录，绕开本地索引的所有异常。

内容的提问来源于stack exchange，提问作者user254694