| Property | Value |
|---|---|
| Severity | Style |
| Category | Style |
| Default | Enabled |
| Auto-fix | Yes (safe) |
Description
Multiple consecutive blank lines add visual noise and waste vertical space. This rule limits the number of consecutive empty lines allowed anywhere in a Dockerfile, as well as at the beginning and end of the file. It mirrors ESLint’sno-multiple-empty-lines rule.
A line is considered empty if it contains only whitespace characters (spaces, tabs).
Heredoc handling
- RUN heredocs with a parseable shell (bash, sh, mksh): blank lines are flagged and fixable.
- RUN heredocs with an unknown shebang (e.g.,
#!/usr/bin/env python3): skipped entirely. - COPY heredocs: skipped entirely (opaque file content).
Examples
Bad
Good
Configuration
Default (no config needed):Options
| Option | Type | Default | Description |
|---|---|---|---|
max | integer | 1 | Maximum consecutive empty lines allowed anywhere in the file |
max-bof | integer | 0 | Maximum consecutive empty lines at the beginning of the file |
max-eof | integer | 0 | Maximum consecutive empty lines at the end of the file |