执行git filter-branch提示Access is denied的问题排查求助

被拒绝访问的对象分析 #

你遇到的「Access is denied」，大概率是Git在操作本地仓库的核心文件时没有权限：

• 最可能是.git/index索引文件，或者.git/objects目录下的历史提交对象，因为git filter-branch需要改写仓库历史，必须读写这些文件。
• 也可能是系统后台进程（比如杀毒软件、同步工具）锁定了.git目录里的文件，导致Git无法修改。

排查解决方法 #

• 彻底关闭所有占用仓库的程序：除了Visual Studio，还要关掉打开仓库目录的文件管理器、实时扫描的杀毒软件、OneDrive/网盘这类同步工具，确保没有进程盯着.git文件夹。
• 检查.git目录的权限：右键点击仓库里的.git文件夹→属性→安全，确认当前用户有「完全控制」权限，没有的话添加权限并应用。
• 换用官方推荐的git filter-repo：git filter-branch已经被官方标记为过时，filter-repo更稳定且权限问题更少。安装后执行：

  git filter-repo --path <TheFolderIWantToDelete> --invert-paths
  

• 换Git Bash执行命令：别用CMD，打开管理员模式的Git Bash再跑命令，有时候CMD的权限环境会有奇怪的限制。
• 清理仓库锁定文件：如果.git目录下有index.lock文件，直接删掉它，这是Git操作中断后留下的锁定标记，会阻止后续操作。

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