Monorepo中如何配置pre-commit安装本地flake8插件？

方案1：使用pre-commit模板变量指定仓库根路径 #

pre-commit支持模板上下文变量，其中{{ repo_root }}会被替换为当前Git仓库的根目录路径，完美适配多环境（本地/CI/其他开发者机器）。修改你的.pre-commit-config.yaml如下：

repos:
  - repo: https://github.com/PyCQA/flake8
    rev: 5.0.4
    hooks:
      - id: flake8
        additional_dependencies:
          - "{{ repo_root }}/my_flake8_plugin"

这个配置会让pip从仓库根目录下的my_flake8_plugin目录安装插件，无论执行环境在哪里，路径都会自动对应正确的位置。

方案2：通过PYTHONPATH加载插件（无需安装） #

如果不想安装插件，而是直接让flake8识别到它，可以自定义一个本地pre-commit钩子，通过环境变量PYTHONPATH将插件目录加入Python的模块搜索路径：

repos:
  - repo: local
    hooks:
      - id: flake8-local-plugin
        name: flake8 (with local plugin)
        entry: flake8
        language: python
        types: [python]
        additional_dependencies: [flake8==5.0.4]
        env:
          PYTHONPATH: "{{ repo_root }}/my_flake8_plugin:$PYTHONPATH"

这种方式不需要安装插件，flake8会直接从PYTHONPATH指定的目录加载你的自定义插件，适合插件还在快速迭代、不需要正式打包的场景。

方案3：将插件作为项目依赖声明 #

如果你的Monorepo已经用pyproject.toml或setup.py管理依赖，可以把自定义插件声明为项目的本地依赖，比如在pyproject.toml中添加：

[project.dependencies]
# 其他依赖...
my-flake8-plugin = { path = "./my_flake8_plugin" }

然后在pre-commit配置中直接依赖这个包名：

repos:
  - repo: https://github.com/PyCQA/flake8
    rev: 5.0.4
    hooks:
      - id: flake8
        additional_dependencies:
          - my-flake8-plugin

pre-commit会自动从项目的依赖配置中找到插件的本地路径并安装。

原配置失败原因 #

原配置中使用./my_flake8_plugin是相对路径，但pre-commit会将flake8仓库克隆到本地缓存目录（比如你报错中的/Users/dtv/.cache/pre-commit/repo0620p39l/），这个相对路径是相对于缓存目录的，而非你的项目根目录，所以会找不到插件文件。

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