Go代码检查工具指南：golangci-lint配置与最佳实践

go-linting by cxuu/golang-skills

289 周安装量

56 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/cxuu/golang-skills --skill go-linting

开发 Go 代码质量

🇨🇳中文介绍

Go 代码检查

来源 : Uber Go 风格指南

核心原则

比任何“官方推荐”的检查工具集更重要的是：在整个代码库中保持一致的检查规范。

一致的代码检查有助于发现常见问题，并为代码质量设立高标准，同时避免不必要的硬性规定。

最低推荐检查工具

来源 : Uber Go 风格指南

这些检查工具能在保持高质量标准的同时，捕获最常见的问题：

检查工具	用途
errcheck	确保错误得到处理
goimports	格式化代码并管理导入
revive	常见风格错误（golint 的现代替代品）
govet	分析代码中的常见错误
staticcheck

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

776,000 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

261,300 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

210,800 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

140,500 周安装

linters:
  enable:
    - errcheck
    - goimports
    - revive
    - govet
    - staticcheck

linters-settings:
  goimports:
    local-prefixes: github.com/your-org/your-repo
  revive:
    rules:
      - name: blank-imports
      - name: context-as-argument
      - name: error-return
      - name: error-strings
      - name: exported

run:
  timeout: 5m

任务	命令/操作
安装 golangci-lint	`go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest`
运行检查工具	`golangci-lint run`
在路径上运行	`golangci-lint run ./pkg/...`
配置文件	项目根目录下的 `.golangci.yml`
CI 集成	在流水线中运行 `golangci-lint run`

当你需要...	使用
错误处理覆盖率	errcheck
导入格式化	goimports
风格一致性	revive
错误检测	govet, staticcheck
以上所有	使用配置好的 golangci-lint

🇺🇸English

Go Linting

Source : Uber Go Style Guide

Core Principle

More important than any "blessed" set of linters: lint consistently across a codebase.

Consistent linting helps catch common issues and establishes a high bar for code quality without being unnecessarily prescriptive.

Minimum Recommended Linters

Source : Uber Go Style Guide

These linters catch the most common issues while maintaining a high quality bar:

Linter	Purpose
errcheck	Ensure errors are handled
goimports	Format code and manage imports
revive	Common style mistakes (modern replacement for golint)
govet	Analyze code for common mistakes
staticcheck	Various static analysis checks

Note : revive is the modern, faster successor to the now-deprecated golint.

Lint Runner: golangci-lint

Source : Uber Go Style Guide

Use golangci-lint as your lint runner:

Performance : Optimized for large codebases
Unified config : Configure many linters at once
Extensible : Add linters as needed for your project

See the example .golangci.yml from uber-go/guide.

Example Configuration

Create .golangci.yml in your project root:

linters:
  enable:
    - errcheck
    - goimports
    - revive
    - govet
    - staticcheck

linters-settings:
  goimports:
    local-prefixes: github.com/your-org/your-repo
  revive:
    rules:
      - name: blank-imports
      - name: context-as-argument
      - name: error-return
      - name: error-strings
      - name: exported

run:
  timeout: 5m

Running

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

# Run all linters
golangci-lint run

# Run on specific paths
golangci-lint run ./pkg/...

Quick Reference

Task	Command/Action
Install golangci-lint	`go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest`
Run linters	`golangci-lint run`
Run on path	`golangci-lint run ./pkg/...`
Config file	`.golangci.yml` in project root
CI integration	Run `golangci-lint run` in pipeline

Linter Selection Guidelines

When you need...	Use
Error handling coverage	errcheck
Import formatting	goimports
Style consistency	revive
Bug detection	govet, staticcheck
All of the above	golangci-lint with config

Go代码检查工具指南：golangci-lint配置与最佳实践

🇨🇳中文介绍

Go 代码检查

核心原则

最低推荐检查工具

相关 Skills

检查运行器：golangci-lint

配置示例

运行

快速参考

检查工具选择指南

另请参阅

🇺🇸English

Go Linting

Core Principle

Minimum Recommended Linters

Lint Runner: golangci-lint

Example Configuration

Running

Quick Reference

Linter Selection Guidelines

See Also

最新 Skills