如何在VSCode中为Golang配置严格lint检查以符合官方编码规范

1. 安装核心Lint工具 #

Go生态当前主流的聚合Lint工具为golangci-lint，支持覆盖几乎所有官方规范和自定义规则检查，替代已废弃的原生golint。
全局安装命令：

go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest

安装完成后执行golangci-lint version，输出版本号即为安装成功。

2. 配置VSCode官方Go扩展 #

首先确认你已经安装了VSCode官方发布的Go扩展，之后进行以下配置：

• 打开VSCode设置页（Windows/Linux按Ctrl+,，Mac按Cmd+,）
• 搜索go.lintTool，将值修改为golangci-lint
• 搜索go.lintOnSave，设置为workspace，每次保存文件时自动扫描整个工作区的代码问题
• 搜索editor.formatOnSave，勾选开启保存自动修复
• 搜索go.formatTool，设置为goimports，保存时自动修复格式、导入包排序等可自动修复的问题

3. 配置严格检查规则 #

在Go项目根目录新建.golangci.yml配置文件，填入以下内容开启你需要的严格规则：

linters:
  # 开启需要的检查器
  enable:
    - revive # 覆盖命名规范、注释规范等基础Go规范检查
    - govet # Go官方自带的语法、逻辑错误检查
    - stylecheck # 代码风格规范检查
    - gofmt # 代码格式统一检查
    - misspell # 代码拼写检查
    - gosimple # 冗余代码简化建议
linters-settings:
  revive:
    rules:
      # 强制函数/类型注释必须以对应名称开头
      - name: comment-format
        arguments: ["check-function", "check-type"]
      # 强制变量/结构体字段使用驼峰命名，可在参数中添加允许的特殊全大写命名
      - name: var-naming
        arguments: [["ID", "URL", "API"], []]
      # 强制包名使用小写蛇形命名，禁止大写、特殊字符
      - name: package-naming
      # 强制注释格式规范
      - name: comment-spacings
  stylecheck:
    # 开启所有风格检查，可通过-前缀关闭不需要的个别规则
    checks: ["all"]

如果需要所有Go项目全局生效规则，可将上述配置文件放在系统用户根目录下，项目内的配置会自动覆盖全局配置。

4. 效果验证 #

重启VSCode后打开Go文件即可生效：

• 不符合规范的代码会直接出现波浪线标注，hover可查看具体错误说明
• 所有代码问题会统一展示在VSCode的「问题」面板中
• 可自动修复的问题会在保存文件时自动修正

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