pre-commit报错missing config value GIT_CONFIG_VALUE_0及提交覆盖问题求助

核心问题分析 #

报错源于Git解析命令行配置时遇到无效的GIT_CONFIG_VALUE_0项，大概率是Avast杀毒软件中断扫描时破坏了本地Git环境变量或临时配置，导致pre-commit调用Git命令失败。

分步解决步骤 #

1. 清理异常Git环境变量 #

• 打开系统环境变量（右键「此电脑」→「属性」→「高级系统设置」→「环境变量」）
• 在「用户变量」和「系统变量」中查找带GIT_CONFIG前缀的变量（比如GIT_CONFIG_VALUE_0），若存在空值或不完整的配置项，直接删除
• 重启电脑使环境变量生效

2. 重置Github Desktop自带Git配置 #

• 打开Github Desktop，进入目标仓库的「设置」页面，找到Git配置区域，点击「重置为默认值」
• 或手动启动Github Desktop自带的Git Bash（路径示例：C:\Users\UsrName\AppData\Local\GitHubDesktop\app-3.4.2\resources\app\git\mingw64\bin\bash.exe），执行以下命令：

  git config --global --unset-all GIT_CONFIG_VALUE_0
  git config --global --reset core.autocrlf
  

3. 彻底重置pre-commit环境 #

• 删除pre-commit缓存目录：C:\Users\UsrName\.cache\pre-commit
• 进入项目虚拟环境，重新安装pre-commit：

  pip uninstall -y pre-commit
  pip install pre-commit
  pre-commit install
  

4. 临时规避杀毒软件干扰 #

• 提交前暂时关闭Avast的实时保护，避免其再次拦截Git或pre-commit的文件操作，提交完成后再恢复保护

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