如何修复lint-staged出现failed due to a git error的Git报错

故障表现 #

运行lint-staged时持续失败，抛出lint-staged due to a git error错误，控制台输出如下：

✖ lint-staged failed due to a git error.
 Cleaning up temporary files...
  Any lost modifications can be restored from a git stash:

    > git stash list
    stash@{0}: automatic lint-staged backup
    > git stash apply --index stash@{0}

报错提示已自动完成临时文件清理，丢失的修改可通过git stash指令恢复。

第一步：优先恢复未提交代码 #

出现该报错时lint-staged会自动把未提交的改动存入git stash，先执行以下操作找回代码，避免改动丢失：

• 执行git stash list，确认存在标注为automatic lint-staged backup的备份记录，通常序号为stash@{0}
• 执行git stash apply --index stash@{0}即可把所有暂存、未暂存的改动完整恢复到工作区

常见原因及修复方法 #

• git工作区存在中断状态
  执行git status检查是否存在未解决的合并冲突、未完成的merge/rebase/cherry-pick操作，先把所有git中断流程处理完毕、工作区回到正常状态后，再重新触发lint-staged即可。
• v13.0.3版本自身兼容bug
  13.0.3是lint-staged的早期版本，存在处理特殊字符文件名、git子模块、无上游分支场景时的git调用逻辑bug，可选择升级到v13分支最终稳定版，或降级到验证无问题的旧版本：
  升级到v13稳定版执行：npm install lint-staged@13.2.2 -D
  降级到v12稳定版执行：npm install lint-staged@12.5.0 -D
• git钩子无执行权限
  执行ls -la .git/hooks/查看pre-commit等钩子文件的权限配置，如果没有可执行权限，执行chmod +x .git/hooks/*给所有钩子添加执行权限后重试。
• git锁文件冲突
  关闭所有打开项目的代码编辑器、git GUI客户端，删除.git目录下的index.lock锁文件，再重新触发提交操作即可。

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