使用pre-commit时VSCode版本控制提交提示找不到pylint可执行文件

报Executable 'pylint' not found本质是钩子运行时的PATH环境变量里找不到pylint可执行文件，两个常见触发场景：

• 终端执行提交操作前没激活项目的Python venv虚拟环境，系统全局环境中没有安装pylint
• 用VSCode内置Git面板提交时，VSCode不会自动加载终端里手动激活的venv环境变量，哪怕你终端已经进入venv，提交钩子的运行环境照样读不到venv下的可执行文件路径

原配置有个明显问题：给本地pylint钩子设置了language: python，但没有声明additional_dependencies，pre-commit为这个钩子创建的独立运行环境里根本没装pylint，默认也不会复用你本地venv里安装的依赖，自然找不到对应命令。

根据使用习惯二选一即可：

方法1：直接复用项目venv内的pylint（和本地开发版本完全一致） #

修改.pre-commit-config.yaml里的pylint本地钩子配置，把直接调用pylint的方式改为通过Python模块调用，同时让钩子直接使用当前环境绑定的Python解释器：

-   repo: local
    hooks:
    -   id: pylint
        name: pylint
        entry: python -m pylint
        language: system
        types: [python]
        args: 
         - --rcfile=.pylintrc

改完执行一遍pre-commit install重写钩子脚本。如果用VSCode提交，先按快捷键Ctrl+Shift+P（macOS为Cmd+Shift+P）调出命令面板，选择「Python: 选择解释器」，选中你项目venv目录下的Python解释器即可。之后不管是终端忘了激活venv提交，还是点击VSCode内置面板的提交按钮，都会自动调用选中解释器对应环境内的pylint，不会再触发找不到可执行文件的报错。

方法2：让pre-commit独立管理pylint依赖（完全不依赖本地venv） #

不想绑定本地解释器配置的话，可以让pre-commit在自己的隔离环境中安装指定版本的pylint，从根源上规避环境变量不一致的问题，配置修改如下：

-   repo: local
    hooks:
    -   id: pylint
        name: pylint
        entry: pylint
        language: python
        types: [python]
        args: 
         - --rcfile=.pylintrc
        additional_dependencies:
          - pylint==2.17.4 # 替换为你项目实际使用的pylint版本号

这种配置下pre-commit会自动创建独立环境安装对应版本的pylint，完全不依赖本地venv状态，任何场景下提交都不会报找不到命令的错误。如果你使用了pylint的第三方扩展插件，把对应的包名和版本也加到additional_dependencies列表里即可。

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