Git本地仓库异常：未修改文件阻止pull及分支切换求助

问题根源 #

报错提示中的Encountered 2 files that should have been pointers, but weren't说明这两个图片文件是通过Git LFS管理的大文件，但本地副本被意外转换为普通文件而非LFS指针，因此Git将其识别为本地修改，阻止了git pull操作。

修复步骤 #

• 确保Git LFS已安装并在仓库中初始化：

  # 若未安装Git LFS，先执行对应系统的安装命令，例如：
  # macOS: brew install git-lfs
  # Ubuntu: sudo apt-get install git-lfs
  git lfs install
  

• 强制恢复异常文件的LFS指针并拉取正确内容：

  git lfs checkout docs/user-guide/images/Databricks/initscript.png docs/user-guide/images/Databricks/initscript_ucx.png
  

• 清理之前错误存储的stash记录：

  git stash drop
  

• 重新执行同步操作：

  git pull
  

其他分支处理 #

切换到存有修改的分支后，重复执行git lfs checkout命令处理这两个异常文件，即可正常进行后续操作，无需删除并重新克隆仓库。

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