我来帮你搞定这个困扰——首先得明确：git update-index --assume-unchanged是本地仓库的临时状态标记，它只存在于当前分支的索引（.git/index）里，Git不会在分支切换时同步这个标记，这就是你切换分支时出错的核心原因。不过我们可以通过手动流程或者简单脚本，实现你想要的「保存文件→切分支→恢复文件+标记」的效果。

先处理当前的错误场景 #

你遇到的error: Entry 'conf/local.conf' not uptodate. Cannot merge.，是因为Git发现你标记为“不会修改”的文件实际上有改动，同时索引里的assume-unchanged状态导致它无法正常处理分支切换。先按以下步骤解决当前卡壳的情况：

git update-index --no-assume-unchanged conf/local.conf

实现你期望的三步流程（手动版） #

接下来按你的需求完成分支切换和文件恢复：

1. 保存conf/local.conf文件

你有两种可靠的保存方式：

• 本地备份文件（最简单）：

  cp conf/local.conf conf/local.conf.backup
  

• 用Git Stash暂存（适合需要保留改动记录的场景）：

  git stash push -m "backup local config" conf/local.conf
  

2. 切换分支

现在文件状态已被Git识别，就能正常切换分支了：

git checkout 296-ToS-component

3. 恢复保存的版本并重新标记

• 如果用的是本地备份：

  cp conf/local.conf.backup conf/local.conf
  # 重新设置assume-unchanged标记
  git update-index --assume-unchanged conf/local.conf
  # 可选：删除备份文件
  rm conf/local.conf.backup
  

• 如果用的是Git Stash：

  # 恢复暂存的改动
  git stash apply stash@{0}
  # 或者用git stash pop，恢复后直接删除该stash记录
  # git stash pop stash@{0}
  # 重新设置标记
  git update-index --assume-unchanged conf/local.conf
  

更高效的自动化脚本 #

如果经常需要切换分支，你可以写一个简单的bash脚本，一键完成所有操作：

#!/bin/bash

# 检查是否传入分支名
if [ -z "$1" ]; then
  echo "Usage: $0 <branch-name>"
  exit 1
fi

TARGET_BRANCH=$1
CONFIG_FILE="conf/local.conf"
BACKUP_FILE="${CONFIG_FILE}.backup"

# 步骤1：备份文件并取消标记
cp "$CONFIG_FILE" "$BACKUP_FILE"
git update-index --no-assume-unchanged "$CONFIG_FILE"

# 步骤2：切换分支
git checkout "$TARGET_BRANCH"

# 步骤3：恢复文件并重新标记
cp "$BACKUP_FILE" "$CONFIG_FILE"
git update-index --assume-unchanged "$CONFIG_FILE"

# 清理备份
rm "$BACKUP_FILE"

echo "Switched to branch $TARGET_BRANCH and restored local config!"

把脚本保存为switch-with-config.sh，赋予执行权限：chmod +x switch-with-config.sh，之后切换分支时直接运行：

./switch-with-config.sh 296-ToS-component

补充小知识点 #

如果是需要长期忽略本地配置文件的改动，其实更推荐用git update-index --skip-worktree（它的优先级更高，更适合本地配置场景），不过它同样是本地状态，切换分支后也需要重新设置，流程和上面一致。

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