pre-commit报错‘Expected a Config map but got a list’如何解决？

这个错误的核心原因是你的.pre-commit-config.yaml文件根结构不符合要求——pre-commit要求配置文件的根节点是映射（map），但当前文件被解析成了列表（list）。以下是具体修复步骤：

• 检查配置文件根结构
  确保配置文件开头没有多余的破折号（-）。错误的写法通常是误将根节点写成了列表，比如：

  - repos:
      - repo: https://github.com/PyCQA/flake8
        rev: 6.0.0
        hooks:
          - id: flake8
  

  正确的根结构应该以repos:直接开头，不需要前置破折号：

  repos:
    - repo: https://github.com/PyCQA/flake8
      rev: 6.0.0
      hooks:
        - id: flake8
  

• 验证配置文件语法
  用Python内置的YAML模块快速校验文件是否存在语法或结构错误，执行命令：

  python -c "import yaml; yaml.safe_load(open('.pre-commit-config.yaml'))"
  

  如果文件有问题，这个命令会抛出具体的错误信息，帮助定位问题位置。

• 回溯最近的配置修改
  既然之前运行正常，问题大概率是最近修改.pre-commit-config.yaml时的误操作导致的（比如复制粘贴时带入了多余的列表符号、缩进错误）。可以通过版本控制工具（如git）查看配置文件的修改记录，定位错误引入的节点。

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