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

你想在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
验证配置是否生效
终端进入项目根目录,执行:golangci-lint run
如果看到类似 Found 3 issues 或 No issues found 的输出,说明配置已加载成功。
若提示 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 文件,但会直接改写你工作区的源码,请确保已提交或暂存当前变更】
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











