Go Linting

Go modules are linted using golangci-lint, a fast linters aggregator for Go.

Configuration

The lint configuration is defined in .golangci.yml at the workspace root. This is the single source of truth for Go linting rules, used by both the CLI and IDE integrations.

Config Location

workspace/
├── .golangci.yml          # Lint rules (source of truth)
└── go/
    └── eac/
        └── commands/      # Module uses workspace config

Enabled Linters

The default configuration enables these linter categories:

Category	Linters
Standard	errcheck, govet, ineffassign, staticcheck, unused
Quality	misspell, revive, unconvert, unparam
Security	gosec
Performance	prealloc, gocyclo
Style	godot, whitespace, gocritic
Formatting	gofmt, goimports, gofumpt

Key Settings

# .golangci.yml (excerpt)
version: "2"

run:
  timeout: 5m
  tests: true

linters:
  default: none
  enable:
    - errcheck      # Unchecked errors
    - govet         # Subtle bugs
    - staticcheck   # Comprehensive analysis
    - gosec         # Security issues
    - gocyclo       # Complexity
    # ... see full config

Usage

# Lint Go modules
r2r eac update lint eac-commands

# Lint with auto-fix (formatters only)
r2r eac update lint eac-commands --fix

# Use custom config
r2r eac update lint eac-commands --config .golangci-strict.yml

Auto-Fix Support

The --fix flag automatically fixes issues for these linters:

gofmt - Formatting
goimports - Import ordering
gofumpt - Stricter formatting
whitespace - Trailing whitespace

Other linters report issues but cannot auto-fix.

IDE Integration

VS Code

Install the Go extension and configure:

// .vscode/settings.json
{
  "go.lintTool": "golangci-lint",
  "go.lintFlags": ["--fast"]
}

GoLand/IntelliJ

Go to Settings > Tools > File Watchers
Add golangci-lint watcher
Point to workspace .golangci.yml

Output Example

=== Linting Go files ===
Running: golangci-lint run --config C:\projects\eac\.golangci.yml ./...

internal/docker/hosting-env.go:45:2: ineffectual assignment to err (ineffassign)
internal/docker/hosting-env.go:89:9: Error return value of `cmd.Run` is not checked (errcheck)

✗ Go lint issues found

System Requirements

Tool	Minimum Version	Install Command
golangci-lint	2.0+	`go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest`

Verify installation:

golangci-lint version
# golangci-lint has version v2.x.x ...

Troubleshooting

Timeout errors

Increase timeout in .golangci.yml:

run:
  timeout: 10m

Linter disagreements

Suppress specific issues with //nolint directives:

//nolint:errcheck // intentionally ignoring error for cleanup
_ = file.Close()

Prefer specific suppressions over blanket //nolint comments.