答案：需创建名为.golangci.yml的基础配置文件，启用govet、errcheck、staticcheck、gosimple、unused、ineffassign六个核心linter，并设置timeout: 5m、concurrency: 4、skip-dirs: - vendor - testdata及issues限制。

你想在Go项目里快速启用代码质量检查，但又不想被上百条规则淹没，需要一份开箱即用、不报错、不卡死的基础配置文件。

创建.golangci.yml基础配置文件

在项目根目录下新建一个名为 【.golangci.yml】 的纯文本文件——注意开头是英文点号，不是 .yaml 或 .yml 拼写错误，否则工具会直接忽略。

粘贴以下内容并保存：

run:
 timeout: 5m
 concurrency: 4
 skip-dirs:
   - vendor
   - testdata

linters:
 enable:
   - govet
   - errcheck
   - staticcheck
   - gosimple
   - unused
   - ineffassign

issues:
 max-issues-per-linter: 50
 max-same-issues: 5

立即学习“go语言免费学习笔记（深入）”；

验证配置是否生效

终端进入项目根目录，执行：golangci-lint run

如果看到类似 Found 3 issues 或 No issues found 的输出，说明配置已加载成功。

Golangci-lint 2.12.2

Golangci-lint 2.12.2 版本下载，修复 gomodguard_v2 blocked 配置并更新 iface，适合模块依赖规则检查。

下载

若提示 no config found，请确认文件名是 【.golangci.yml】（不是 .golangci.yaml/.toml/.json），且位于 【go.mod 所在的同一级目录】。

按需启用自动修复功能

方法一：临时开启单次修复

运行 golangci-lint run --fix，仅对支持 fix 的 linter（如 gofmt、goimports）生效。

方法二：在配置中默认启用（谨慎操作）

在 .golangci.yml 的 run: 区块下追加一行：fix: true。此后每次 golangci-lint run 都会尝试自动修复。

【注意：--fix 不会修改未跟踪的文件或 git ignored 文件，但会直接改写你工作区的源码，请确保已提交或暂存当前变更】