使用dnephin/pre-commit-golang时goimports提示找不到可执行文件如何解决

以下是经过验证的可行解决步骤，按优先级依次尝试即可：

1. 验证goimports全局安装状态 #

• 执行go env GOPATH查看当前Go环境的GOPATH路径，go install安装的二进制文件默认会存放在$GOPATH/bin（Linux/macOS）或%GOPATH%\bin（Windows）目录下
• 执行echo $PATH（Linux/macOS）或echo %PATH%（Windows），确认上述bin目录已经加入系统环境变量PATH
• 直接在终端执行goimports --version，如果无法输出版本信息，重新执行安装命令：go install golang.org/x/tools/cmd/goimports@latest

2. 修复pre-commit运行环境的PATH差异问题 #

如果全局执行goimports --version正常，但pre-commit仍然报错，是pre-commit的运行环境没有读取到你的用户PATH配置，可选择以下任意一种方案解决：

• 方案A：修改项目根目录下的.pre-commit-config.yaml配置，为goimports钩子指定绝对路径，示例配置：

  - repo: https://github.com/dnephin/pre-commit-golang
    rev: v0.5.0 # 替换为你实际使用的版本号
    hooks:
      - id: goimports
        entry: /替换为你的GOPATH实际路径/bin/goimports
  

• 方案B：如果是通过GUI类Git工具（VSCode内置终端、SourceTree等）提交报错，直接改用系统终端执行git commit命令提交，大部分情况可直接规避环境变量不一致的问题
• 方案C：执行提交命令前先手动导入PATH，Linux/macOS执行export PATH=$PATH:$(go env GOPATH)/bin，Windows执行set PATH=%PATH%;%GOPATH%\bin，之后再执行commit命令即可临时生效

3. 配置pre-commit自动安装依赖 #

如果上述方案都不生效，可以修改钩子配置让pre-commit自动拉取安装对应依赖：

- id: goimports
  additional_dependencies: ['golang.org/x/tools/cmd/goimports@latest']

修改完成后执行pre-commit autoupdate重新更新钩子配置即可。

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