golangci-lint

Roadmap

Table of Contents

💡 Feature Requests

Please file an issue to suggest new features. Vote on feature requests by adding a 👍. This helps maintainers prioritize what to work on.

See Feature Requests

🐛 Bugs

Please file an issue for bugs, missing documentation, or unexpected behavior.

See Bugs

Thanks

Thanks to all contributors! Thanks to alecthomas/gometalinter for inspiration and amazing work. Thanks to bradleyfalzon/revgrep for cool diff tool.

Thanks to developers and authors of used linters:

Changelog

Follow the news and releases on our twitter and our blog. There is the most valuable changes log:

v1.44.1

  1. updated linters:
    • bidichk: from 0.2.1 to 0.2.2
    • errchkjson: from 0.2.1 to 0.2.3
    • thelper: from 0.5.0 to 0.5.1
    • tagliatelle: from 0.3.0 to 0.3.1
    • gopsutil: from 3.21.12 to 3.22.1
    • gci: from 0.2.9 to 0.3.0
    • revive: from v1.1.3 to v1.1.4
    • varnamelen: from v0.5.0 to v0.6.0
  2. documentation:
    • linters: improve configuration pages
    • decorder: fix disable-init-func-first-check: false elaboration
  3. misc:
    • fix debug output

v1.44.0

  1. new linters:
  2. updated linters:
    • asciicheck: bump to v0.1.1
    • bidichk: from 0.1.1 to 0.2.1
    • bodyclose: bump to HEAD
    • decorder: from 0.2.0 to 0.2.1
    • depguard: from 1.0.1 to 1.1.0
    • errchkjson: from 0.2.0 to 0.2.1
    • errorlint: bump to HEAD
    • exhaustive: drop deprecated/unused settings
    • exhaustive: from v0.2.3 to 0.7.11
    • forbidigo: from 1.2.0 to 1.3.0
    • forcetypeassert: bump to v0.1.0
    • gocritic: from 0.6.1 to 0.6.2
    • gocritic: support autofix
    • gocyclo: from 0.3.1 to 0.4.0
    • godot: add period option
    • gofumpt: from 0.1.1 to 0.2.1
    • gomnd: from 2.4.0 to 2.5.0
    • gomnd: new configuration
    • gosec: from 2.9.1 to 2.9.6
    • ifshort: from 1.0.3 to 1.0.4
    • ineffassign: bump to HEAD
    • makezero: to v1.1.0
    • promlinter: from v0.1.0 to HEAD
    • revive: fix enableAllRules
    • revive: from 1.1.2 to 1.1.3
    • staticcheck: from 0.2.1 to 0.2.2
    • tagliatelle: from 0.2.0 to 0.3.0
    • thelper: from 0.4.0 to 0.5.0
    • unparam: bump to HEAD
    • varnamelen: bump to v0.5.0
    • wrapcheck: update configuration to include ignoreSignRegexps
  3. documentation:
    • linters: improve pages about configuration
    • improve page about false-positive
    • nolintlint: fix wrong default value in comment
    • revive: add a more detailed configuration
  4. misc:
    • outputs: Add support for multiple outputs
    • outputs: Print error text in <failure> tag content for more readable JUnit output
    • outputs: ensure that the Issues key in JSON format is a list
    • Return error if any linter fails to run
    • cli: Show deprecated mark in the CLI linters help

November 2021

  1. new linters:
  2. update linters:
    • nestif: from 0.3.0 to 0.3.1
    • rowserrcheck: from 1.1.0 to 1.1.1
    • gopsutil: from 3.21.9 to 3.21.10
    • wrapcheck: from 2.3.1 to 2.4.0
    • gocritic: add support for variable substitution in ruleguard path settings
  3. documentation:
    • improve go-critic documentation
    • improve nolintlint documentation
  4. Misc:
    • cli: don't hide enable-all option

october 2021

  1. new linters:
  2. update linters:
    • gochecknoglobals: to v0.1.0
    • gosec: filter issues according to the severity and confidence
    • errcheck: empty selector name.
    • ifshort: from 1.0.2 to 1.0.3
    • go-critic: from 0.5.6 to 0.6.0
    • gosec: from 2.8.1 to 2.9.1
    • durationcheck: from 0.0.8 to 0.0.9
    • wrapcheck: from 2.3.0 to 2.3.1
    • revive: from 1.1.1 to 1.1.2

September 2021

  1. new linters:
  2. update linters:
    • errcheck: update to HEAD
    • errname: from 0.1.4 to 0.1.5
    • gci: Parse the settings more similarly to the CLI
    • godot: from 1.4.9 to 1.4.11
    • ireturn: from 0.1.0 to 0.1.1
    • nlreturn: add block-size option
    • paralleltest: from 1.0.2 to 1.0.3
  3. Misc:
    • new-from-rev: add support for finding issues in entire files in a diff

August 2021

  1. new linters:
  2. update linters:
    • errname: from 0.1.3 to 0.1.4
    • go-critic: fix invalid type conversions.
    • godot: from 1.4.8 to 1.4.9
    • gomodguard: from 1.2.2 to 1.2.3
    • revive: from 1.0.9 to 1.1.1
    • staticcheck: bump to 2021.1.1 (v0.2.1)
    • wrapcheck: bump to v2.3.0
  3. Misc:
    • build binaries and Docker images with go1.17

July 2021

  1. update linters:
    • errcheck: allow exclude config without extra file
    • exhaustive: from 0.1.0 to 0.2.3
    • gocognit: from 1.0.1 to 1.0.5
    • godot: from 1.4.7 to 1.4.8
    • gomoddirectives: from 0.2.1 to 0.2.2
    • revive: from 1.0.8 to 1.0.9
  2. documentation:
    • improve goconst documentation
    • improve goimports description

June 2021

  1. update linters:
    • durationcheck: from 0.0.7 to 0.0.8
    • gci: from 0.2.8 to 0.2.9
    • goconst: from 0.5.6 to 0.5.7
    • gofumpt: Add lang-version option
    • gomodguard: from 1.2.1 to 1.2.2
    • gosec: from 2.8.0 to 2.8.1
    • revive: add enable-all-rules.
    • revive: allow to disable rule
    • revive: fix exclude comment rule for const block
    • revive: from 1.0.7 to 1.0.8
    • wrapcheck: from 2.1.0 to 2.2.0
  2. documentation:
    • add all integrations to docs introduction page
  3. Misc:
    • 🎉 Un-deprecate enable-all option
    • output: generate HTML report
    • Support RISV64

May 2021

  1. new linters:
  2. update linters:
    • durationcheck: from 0.0.6 to 0.0.7
    • errorlint: bump to HEAD
    • forbidigo: from 1.1.0 to 1.2.0
    • go-critic: from 0.5.5 to 0.5.6
    • godot: from 1.4.6 to 1.4.7
    • ⚠ golint: deprecated
    • gomnd: from 2.3.2 to 2.4.0
    • gomodguard: fix problem where duplicate issues were reported
    • gosec: from 2.7.0 to 2.8.0
    • govet: fix sigchanyzer
    • govet: Update vet passes
    • importas: allow repeated aliases
    • importas: bump to HEAD
    • makezero: bump to HEAD
    • nolintlint: fix false positive
    • revive: convert hard coded excludes into default exclude patterns
    • revive: fix add-constant rule support
    • revive: fix excludes
    • revive: from 1.0.6 to 1.0.7
    • revive: improve 'exported' rule output
    • rowserrcheck: bump to v1.1.0
    • staticcheck: configuration for staticcheck, gosimple, stylecheck
    • staticcheck: from 0.1.3 to 0.1.4
    • staticcheck: from v0.1.4 to v0.2.0
    • wastedassign: from 0.2.0 to 1.0.0
    • wastedassign: from 1.0.0 to v2.0.6
    • wrapcheck: from 1.2.0 to 2.1.0
  3. documentation:
    • improve linters page
    • exhaustivestruct example explanation
    • fix pattern of forbidigo in example config yaml
    • bump documentation dependencies
    • fix typos
  4. Misc:
    • set the minimum Go version to go1.15
    • non-zero exit code when a linter produces a panic

April 2021

  1. new linters:
  2. update linters:
    • godot: from 1.4.4 to 1.4.6
    • wrapcheck: from 1.0.0 to 1.2.0
    • go-mnd: from 2.3.1 to 2.3.2
    • wsl: from 3.2.0 to 3.3.0
    • revive: from 1.0.5 to 1.0.6
    • importas: bump to HEAD
    • staticcheck: configurable Go version
    • gosec: add configuration
    • typecheck: improve error stack parsing
  3. documentation:
    • bump documentation dependencies
    • fix typos
  4. Misc:
    • fix: comma in exclude pattern leads to unexpected results

March 2021

  1. new linters:
  2. update linters:
    • go-critic: from 0.5.4 to 0.5.5
    • gofumpt: from v0.1.0 to v0.1.1
    • gosec: from 2.6.1 to 2.7.0
    • ifshort: bump to v1.0.2
    • importas: bump to HEAD
    • makezero: bump to HEAD
    • nolintlint: allow to fix //nolint lines
    • revive: from 1.0.3 to 1.0.5
    • revive: the default configuration is only applied when no dedicated configuration
    • rowserrcheck: bump to HEAD
    • ⚠ scopelint: deprecated
    • staticcheck: from v0.1.2 (2020.2.2) to v0.1.3 (2020.2.3)
    • 🎉 typecheck: display compilation errors as report instead of error
    • wastedassign: bump to v0.2.0
    • wrapcheck: bump to v1.0.0
  3. documentation:
  4. Misc:
    • Set version command output to Stdout
    • fix linters load mode
    • Restore fast linters meaning

February 2021

  1. new linters:
  2. update linters:
    • prealloc: Use upstream version
    • errcheck: Use upstream version
    • ineffassign: Use upstream version
    • gocyclo: Use upstream version
    • godot from 1.3.2 to 1.4.3
    • exhaustivestruct from 1.1.0 to 1.2.0
    • forbidigo from 1.0.0 to 1.1.0
    • thelper from 0.2.1 to 0.3.1
    • ruleguard: print error message and exit with non-zero status when parsing error occurs
    • fix wrong load mode for asciicheck, exhaustivestruct, exportloopref, and makezero
    • wsl: bump to v3.2.0
    • durationcheck: from 0.0.4 to 0.0.6
    • staticcheck: from 2020.1.6 to v0.1.2 (2020.2.2)
    • thelper from 0.3.1 to 0.4.0
    • bodyclose: bump to HEAD
    • go-err113: bump to HEAD
    • ⚠ interfacer: deprecated
    • ⚠ maligned: deprecated (govet fieldalignment as replacement)
    • govet: use same default linter as go vet
    • go-printf-func-name: to v0.0.0-20200119135958-7558a9eaa5af
    • godox: to v0.0.0-20210227103229-6504466cf951
    • asciicheck: to v0.0.0-20200416200610-e657995f937b
    • wrapcheck: to v0.0.0-20201130113247-1683564d9756
    • unparam: to v0.0.0-20210104141923-aac4ce9116a7
  3. CLI: truncate multiline descriptions
  4. fix: new-from-rev for a large repository
  5. Support RelatedInformation for analysis Diagnostic
  6. use go1.16 to create binaries
  7. fix: MIPS release
  8. documentation:
    • bump documentation dependencies
    • fix go-header usage
    • improve gocritic description
    • update deprecated hyperlink for Sublime Text plugin
    • add docs on using homebrew tap

January 2021

  1. new linters:
  2. update linters:
    • go-critic from 0.5.2 to 0.5.3
    • thelper from 0.1.0 to 0.2.1
    • Validate go-critic settings
    • gofumpt to v0.1.0
    • gci to v0.2.8
    • go-mnd to v2.3.1
    • gosec from 2.5.0 to 2.6.1
    • godot from 1.3.2 to 1.4.3
    • ifshort to v1.0.1
    • rowserrcheck: fix reports false positive
  3. fix: modules-download-mode support
  4. documentation:
    • bump documentation dependencies

December 2020

  1. new linters:
  2. update linters:
    • go-header from v0.3.1 to v0.4.2
    • go-mnd from v2.0.0 to v2.2.0
    • godot from v1.3.0 to v1.3.2
    • gci from v0.2.4 to v0.2.7
    • gomodguard from v1.1.0 to v1.2.0
    • go-errorlint from v0.0.0-20201006195004-351e25ade6e3 to v0.0.0-20201127212506-19bd8db6546f
    • gofumpt from v0.0.0-20200802201014-ab5a8192947d to v0.0.0-20201129102820-5c11c50e9475
    • nolintlint fix comment analysis. (#1571)
  3. result/processors: treat all non-Go source as special autogenerated files
  4. throw an error on panic. (#1540)
  5. resolve custom linters' path relative to config file directory (#1572)
  6. treat all non-Go source as special autogenerated files
  7. documentation:
    • add settings examples for gocritic (#1562)
    • removing reference to no-longer-existing linter-in-the-cloud (#1553)
  8. others:
    • bump gopkg.in/yaml.v2 from 2.3.0 to 2.4.0 (#1528)
    • bump gatsby-remark-responsive-iframe in /docs (#1533)
    • bump gatsby-remark-images from 3.3.29 to 3.6.0 in /docs (#1531)
    • bump ini from 1.3.5 to 1.3.8 in /tools (#1560)
    • bump react-headroom from 3.0.0 to 3.0.1 in /docs (#1532)
    • bump react-live from 2.2.2 to 2.2.3 in /docs (#1534)
    • bump react from 16.13.1 to 16.14.0 in /docs (#1481)
    • Fix forbidigo linter name in reports (#1590)

November 2020

  1. new linters:
  2. update linters:
  3. DefaultExcludePatterns should only be used for specified linter (#1494)
  4. unknown linter breaks //nolint (#1497)
  5. report all unknown linters at once (#1477)
  6. CI:
    • fix Docker tag for Alpine build
  7. documentation:
    • missing sort-results in the docs (#1514)
    • add description of Homebrew's official formula (#1421)
  8. others:
    • bump golang.org/x/text to v0.3.4 (#1293)
    • bump github.com/fatih/color to from 1.9.0 to 1.10.0 (#1485)
    • bump lodash from 4.17.15 to 4.17.19 in /.github/peril (#1252)
    • bump polished from 3.6.6 to 4.0.3 in /docs (#1482)
    • bump gatsby-alias-imports from 1.0.4 to 1.0.6 in /docs (#1479)
    • bump puppeteer from 5.3.1 to 5.4.1 in /docs (#1480)
    • bump gatsby-remark-embedder from 3.0.0 to 4.0.0 in /docs (#1478)

October 2020

  1. new linters:
  2. update linters:
  3. add support for powershell completion (#1408)
  4. add .golangci.yaml to list of configuration files searched on startup (#1364)
  5. support for only specifying default severity (#1396)
  6. documentation:
    • mention macports installation procedure on macOS (#1352)
    • sort linters (#1451)
  7. CI:
    • add codeQL scanning (#1405)
    • fix version details in Docker image (#1471)
    • releasing docker image for arm64 (#1383)
    • change interval for npm to monthly (#1424)
  8. others:
    • use tag version for cobra (#1458)
    • bump nancy to 1.0.1 (#1410)
    • bump gatsby-plugin-catch-links in /docs (#1415)
    • bump gatsby-plugin-mdx from 1.2.40 to 1.2.43 in /docs (#1419)
    • bump gatsby-plugin-sharp from 2.6.31 to 2.6.40 in /docs (#1423)
    • bump gatsby-plugin-sitemap from 2.4.12 to 2.4.14 in /docs (#1417)
    • bump github.com/mattn/go-colorable from 0.1.7 to 0.1.8 (#1413)
    • bump github.com/sirupsen/logrus from 1.6.0 to 1.7.0 (#1412)
    • bump github.com/sourcegraph/go-diff from 0.6.0 to 0.6.1 (#1414)
    • bump golangci/golangci-lint-action from v2 to v2.3.0 (#1447) (#1469)
    • bump puppeteer from 3.3.0 to 5.3.1 in /docs (#1418)

September 2020

  1. update linters:
    • godot from 0.4.8 to 0.4.9
    • exhaustive from v0.0.0-20200708172631-8866003e3856 to v0.0.0-20200811152831-6cf413ae40e0
    • gofumpt from v0.0.0-20200709182408-4fd085cb6d5f to v0.0.0-20200802201014-ab5a8192947d
  2. add support for fish completion (#1201)
  3. documentation:
    • fix typo in performance docs (#1350)
  4. CI:
    • prevent macos to be marked as passing upon failure (#1381)
    • check only for go.mod file (#1397)
    • check if go.mod and go.sum are up to dated (#1377)
    • trigger Netlify (#1358)
  5. others:
    • bump github.com/sourcegraph/go-diff from 0.5.3 to 0.6.0 (#1353)
    • bump github.com/valyala/quicktemplate from 1.6.2 to 1.6.3 (#1385)
    • ignore known dependency failure in nancy (#1378)
    • bump @mdx-js/mdx from 1.6.16 to 1.6.18 in /docs (#1401)
    • bump gatsby from 2.24.52 to 2.24.65 in /docs (#1400)
    • bump gatsby-plugin-canonical-urls in /docs (#1390)
    • bump gatsby-plugin-google-analytics in /docs (#1388)
    • bump gatsby-plugin-manifest from 2.4.23 to 2.4.27 in /docs (#1355)
    • bump gatsby-plugin-mdx from 1.2.35 to 1.2.40 in /docs (#1386)
    • bump gatsby-plugin-offline from 3.2.23 to 3.2.27 in /docs (#1368)
    • bump gatsby-plugin-sharp from 2.6.25 to 2.6.31 in /docs (#1354)
    • bump gatsby-plugin-sitemap from 2.4.11 to 2.4.12 in /docs (#1344)
    • bump gatsby-remark-autolink-headers in /docs (#1387)
    • bump gatsby-remark-images from 3.3.25 to 3.3.28 in /docs (#1345)
    • bump gatsby-remark-images from 3.3.28 to 3.3.29 in /docs (#1365)
    • bump gatsby-remark-mermaid from 2.0.0 to 2.1.0 in /docs (#1369)
    • bump gatsby-source-filesystem in /docs (#1366)
    • bump gatsby-source-filesystem in /docs (#1389)
    • bump gatsby-transformer-sharp in /docs (#1402)
    • bump gatsby-transformer-yaml from 2.4.10 to 2.4.11 in /docs (#1367)
    • bump node-fetch in /.github/contributors (#1363)
    • bump polished from 3.6.5 to 3.6.6 in /docs (#1347)

August 2020

  1. new nlreturn linter: https://github.com/ssgreg/nlreturn
  2. new gci linter: https://github.com/daixiang0/gci
  3. support latest version of golangci-lint in golangci-lint-action
  4. update gosec linter from 2.3.0 to 2.4.0
  5. update godot linter from 0.4.2 to 0.4.8
  6. update go-critic from 0.5.0 to 0.5.2 (#1307)
  7. update nlreturn from 2.0.1 to 2.0.2 (#1287), 2.0.2 to 2.1.0 (#1327)
  8. update gci to v0.2.1 (#1292), to v0.2.2 (#1305), to v0.2.4 (#1337),
  9. update funlen from 0.0.2 to 0.0.3 (#1341)
  10. upgrade to golang 1.15 for smaller binary (#1303)
  11. support short and json formats for version cmd (#1315)
  12. add home directory to config file search paths (#1325)
  13. allow for serializing multiple golangci-lint invocations (#1302)

July 2020

  1. gofumpt linter:
    • update linter
    • add extra-rules option
    • support auto-fixing
  2. upgrade exhaustive linter
  3. upgrade exportloopref linter
  4. improve 'no such linter' error message
  5. sorting result.Issues implementation
  6. enhancements in CI:
    • Run nancy validation for all dependencies
    • Move dependabot config to .github folder
  7. other
    • bump lodash from 4.17.15 to 4.17.19 in /tools
    • bump golangci/golangci-lint-action from v1.2.2 to v2
    • bump github.com/valyala/quicktemplate from 1.5.0 to 1.5.1

June 2020

  1. Add new linters: gofumpt

May 2020

  1. Add new linters: nolintlint, goerr113
  2. Updated linters: godot, staticcheck
  3. Launch a website

April 2020

  1. Add new linters: testpackage, nestif, godot, gomodguard, asciicheck
  2. Add github actions output format
  3. Update linters: wsl, gomodguard, gosec
  4. Support disabled-tags setting for gocritic
  5. Mitigate OOM and "failed prerequisites"
  6. Self-isolate due to unexpected pandemics
  7. Support case-sensitive excludes
  8. Allow granular re-enabling excludes by ID, e.g. EXC0002

September 2019

  1. Support go1.13
  2. Add new linters: funlen, whitespace (with auto-fix) and godox
  3. Update linters: gochecknoglobals, scopelint, gosec
  4. Provide pre-built binary for ARM and FreeBSD
    1. Fix false-positives in unused
  6. Support --skip-dirs-use-default
  7. Add support for bash completions

July 2019

  1. Fix parallel writes race condition
  2. Update bodyclose with fixed panic

June 2019

  1. Treat Go source files as a plain text by misspell: it allows detecting issues in strings, variable names, etc.
  2. Implement richer and more stable auto-fix of misspell issues.

May 2019

  1. Add bodyclose linter.
  2. Support junit-xml output.

April 2019

  1. Update go-critic, new checkers were added: badCall, dupImports, evalOrder, newDeref
  2. Fix staticcheck panic on packages that do not compile
  3. Make install script work on Windows
  4. Fix compatibility with the latest x/tools version and update golang.org/x/tools
  5. Correct import path of module sourcegraph/go-diff
  6. Fix max-issues-per-linter name
  7. Fix linting of preprocessed files (e.g. *.qtpl.go, goyacc)
  8. Enable auto-fixing when running via pre-commit

March 2019

  1. Support the newest go vet (with go/analysis)
  2. Support configuration of go vet: e.g. you can set print functions by linters-settings.govet.settings.printf.funcs
  3. Update megacheck (staticcheck) to 2019.1.1
  4. Add information about controlling space-time trade-off into README
  5. Exclude issues by source code line regexp by issues.exclude-rules[i].source
  6. Build and test on go 1.12
  7. Support --color option
  8. Update x/tools to fix c++ issues
  9. Include support for log level
  10. Sort linters list in help commands

Future Plans

  1. Upstream all changes of forked linters.
  2. Make it easy to write own linter/checker: it should take a minimum code, have perfect documentation, debugging and testing tooling.
  3. Speed up SSA loading: on-disk cache and existing code profiling-optimizing.
  4. Analyze (don't only filter) only new code: analyze only changed files and dependencies, make incremental analysis, caches.
  5. Smart new issues detector: don't print existing issues on changed lines.
  6. Minimize false-positives by fixing linters and improving testing tooling.
  7. Automatic issues fixing (code rewrite, refactoring) where it's possible.
  8. Documentation for every issue type.
Edit this page on GitHub

Prev

FAQ

Next

Trusted By