Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Luacheck

luacheck.readthedocs.io

  • Free plan
  • Windows
  • macOS
  • Linux
  • Self-hosted

What Luacheck is

Luacheck is a free, open-source static analyzer and linter for Lua code. It identifies undefined globals, unused variables and values, uninitialized variables, and unreachable code. The tool checks Lua 5.1 through 5.4 and LuaJIT syntax and runs on those Lua versions. Projects can configure checks with command-line options, configuration files, or comments in source files. Settings can define project-specific globals, standard-global sets, warning filters, and overrides for individual files or paths. Command-line output supports TAP, JUnit XML, Visual Studio/MSBuild, plain text, and default formats. Installation is documented through LuaRocks and a single-file 64-bit Windows binary. Luacheck also runs as a standalone Docker container, including a prebuilt GitHub Container Registry image. The project documents GitHub Actions support and lists integrations for Vim, Sublime Text, Atom, Emacs, Brackets, Visual Studio Code, Nova, and Geany. Parallel checks require LuaLanes. Luacheck uses the MIT License.

Who it suits

Luacheck suits Lua developers who want configurable static checks in local workflows, editors, containers, or CI. It supports projects targeting Lua 5.1–5.4 or LuaJIT.

Good to know, and what to watch

  • Free and MIT-licensed
  • Checks Lua 5.1–5.4 and LuaJIT
  • Supports configurable warning filters
  • Provides multiple CI-friendly output formats
  • Offers GitHub Actions and editor integrations
  • Parallel checking requires LuaLanes
  • Module interface may change between minor releases
  • Free trial is not offered

Luacheck

Free

Open source

The verdict

Luacheck provides broad Lua syntax checking with configurable rules, many output formats, and integrations for editors and GitHub Actions. Its command-line interface is described as fairly stable, while the module interface can change between minor releases.

What the maker publishes

CI integration
The project documents a GitHub Actions workflow and provides a Luacheck GitHub Action. source
Configuration
Checks can be configured through command-line options, configuration files, or comments in checked files. source
Configuration detail
Configuration supports project-specific globals, standard-global sets, warning filters, and per-file or per-path overrides. source
Container
Luacheck can be run as a standalone Docker container, including a prebuilt image published through GitHub Container Registry. source
Editor integrations
The project lists integrations for Vim, Sublime Text, Atom, Emacs, Brackets, Visual Studio Code, Nova, and Geany. source
Installation
The project documents installation through LuaRocks and provides a single-file 64-bit Windows binary. source
License
The project is distributed under the MIT License. source
Lua support
It checks Lua 5.1–5.4 and LuaJIT syntax, and runs on those Lua versions. source
Output
The command line supports built-in TAP, JUnit XML, Visual Studio/MSBuild, plain-text, and default formatters. source
Parallel checks
Parallel checking requires the LuaLanes dependency. source
Purpose
Luacheck is a static analyzer and linter for Lua code. source
Stability note
The README says the module interface may change between minor releases while the command-line interface is fairly stable. source
Support
The project directs users to its GitHub issue tracker for bugs, suggestions, and questions, and says pull requests are welcome. source
Warnings
It detects issues including undefined globals, unused variables and values, uninitialized variables, and unreachable code. source

Checked against the maker's pages on 4 Oct 2026.