Git Bash执行git add .自动生成.git/index.lock且无法运行git push如何解决

基础锁文件清理操作 #

说明：.git/index.lock是Git为了避免多进程并发修改索引文件生成的临时锁，正常情况下Git执行完对应命令就会自动删除该文件，反复生成锁、无法自动删除的核心原因通常是进程冲突、权限不足或索引文件损坏。

• 先关闭所有关联当前Git仓库的程序：包括其他Git Bash窗口、IDE内置的Git功能、正在后台跑的仓库监听脚本，避免后台进程持续重新生成锁文件
• 执行命令手动删除残留锁文件：

  rm -f .git/index.lock
  

• 如果删除时提示权限不足，直接检查当前仓库下.git目录的读写权限，确保当前登录的Windows/Git Bash用户拥有该目录的完全读写权限，不要随意用高权限账号执行Git操作。

排查反复生成锁文件的核心原因 #

• 排查仓库目录的同步类工具：如果仓库存放在OneDrive、Dropbox等自动同步的路径下，同步工具的实时扫描会持续访问.git目录，并发触发Git内部索引操作生成锁。这类问题可以通过把.git目录加入同步工具的排除列表，或直接将仓库移出同步路径解决。
• 排查杀毒软件的拦截行为：Windows Defender、第三方杀毒软件的实时扫描会频繁读取.git下的文件，甚至错误拦截Git的索引写入操作，导致临时锁无法被正常释放。需要把整个仓库路径加入杀毒软件的扫描排除列表。
• 修复损坏的Git索引文件：如果是索引文件本身损坏导致Git操作异常卡死，执行以下命令重建当前索引：

  git read-tree HEAD
  

  命令执行无报错后，再重试git add .操作，观察锁文件是否还会无故生成。

功能验证流程 #

• 先执行git status，确认终端没有输出锁文件相关的警告
• 重新执行git add .，确认命令执行完成后，.git/index.lock会被Git自动清理（正常流程下锁文件仅在命令执行过程中临时存在，命令结束就会自动删除）
• 依次完成提交流程后，执行git push，即可恢复正常的远程推送功能。

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