Easily Find Bugs In Shell Scripts With ShellCheck

Brief: ShellCheck is a handy utility tool that warns you of possible syntax and simple logical errors, without executing. You can also use it with Atom text editor.

As we all know, the terminal is an inseparable part of the Linux system. And behind everything we do in the terminal, there is the shell — a program that interacts with the operating system itself. Every command we enter in the terminal is ultimately interpreted by the shell and then it acts accordingly.

ShellCheck command line tool

Shell as a Programming Language

There is more to shell though. A UNIX shell is not a command interpreter only, it serves as a programming language too! Shell as a programming language provides variables, flow control constructs, quoting and functions.

A file containing shell commands and codes is called Shell Script. So, you can accomplish various complex tasks and automation for you system using shell scripts.

Anyway, as we are humans, we make mistakes. So obviously, while writing shell scripts you will make mistakes too, such as – syntactical errors, typos, bad patterns etc. Here, we are going to know about the tool — ShellCheck — that will help us with that.


ShellCheck is a static analysis tool for you shell scripts. It is open-source and developed mainly for Bash or sh scripts. Now you might wonder, what the heck is Static Analysis? Well, static analysis is a method for debugging a program by examining its (static) codes rather than running/executing it.

Let’s take a look at what types of things ShellCheck checks for:

  • Quoting: Shell has specific ways for using variables and strings. If you’ve used them incorrectly ShellCheck will warn you.
  • Conditionals: It will check for incorrect uses of test statements.
  • Frequently Misused Commands: ShellCheck will warn you about incorrectly used shell commands.
  • Common Beginner’s Mistakes: Various syntax errors that beginner Shell users make as Shell uses various strict syntax rules that differ from other programming languages. For example: you can’t put spaces around the = sign while declaring variables. Most languages wouldn’t care but here it matters.
  • Style: ShellCheck will provide suggestions for improving your code’s style.
  • Data & Typing errors: Various issues related to data and typing.
  • Robustness, Portability & Others: ShellCheck will give suggestions for making your scripts robust, warn you about portability issues with different shells (bash,sh,ksh,dash etc.) and various other things.

For documentation and various useful information, do not forget to check the ShellCheck GitHub Project:

ShellCheck on GitHub

Installing ShellCheck

For offline usage, you can install ShellCheck package on your system. On Ubuntu, enter the following command in your terminal:

sudo apt install shellcheck

For other distributions, check the GitHub ReadMe Installing section.

If you use Atom text editor, you can also use ShellCheck within you editor window on-the-fly. Just install the necessary atom packages for ShellCheck:

apm install linter linter-shellcheck

ShellCheck supports other editors, such as – Vim, Emacs, Sublime etc., as well. You can find a complete list on the GitHub ReadMe section.

Using ShellCheck


You can use ShellCheck online without installing anything on your system (you will need a web browser though, haha!).

  • Copy your shell script’s codes.
  • Visit the ShellCheck website.
  • Paste your codes in the editor.
  • It will show the ShellCheck output.

Here’s an example:

Using ShellCheck Online
Using ShellCheck Online

Command-line interface

After installing the necessary packages for ShellCheck on your system, you can use it from your terminal without any net connectivity. Just type the following command:

shellcheck <filename>

Replace the <filename> part with the filename of your shell script.

ShellCheck Command-line interface
ShellCheck Command-line interface

Editor Extensions

After installing necessary extensions for your text editor, you can see the ShellCheck output on-the-fly, without running the shellcheck command manually. Here’s how it looks on the Atom editor:

Atom with Linter-ShellCheck
Atom with Linter-ShellCheck

Pros & Cons

Whether you are a seasoned Shell programmer or just a beginner, you have everything to gain and nothing to lose by using ShellCheck. Whenever you are writing shell scripts, check it with ShellCheck, you will be able to catch errors and bugs early and overall be more productive with Linux.

Have you ever tried to write a shell script before? Did you use ShellCheck? If you did, how was your experience? Do share with us! :)

0 (0)
Article Rating (No Votes)
Rate this article
There are no attachments for this article.
There are no comments for this article. Be the first to post a comment.
Full Name
Email Address
Security Code Security Code
Related Articles RSS Feed
RHCS6: Luci - the cluster management console
Viewed 799 times since Sun, Jun 3, 2018
How to deal with dmesg timestamps
Viewed 534 times since Wed, Oct 3, 2018
Nagrywanie sesji SSH do pliku
Viewed 934 times since Thu, May 24, 2018
How to do a Filesystem Resize (ext3/ext4) on Redhat running on VMware
Viewed 1182 times since Wed, Jul 25, 2018
How to Synchronize Directories Using Lsyncd in Linux
Viewed 1024 times since Wed, Oct 31, 2018
How To Find Largest Top 10 Files and Directories On Linux / UNIX / BSD find
Viewed 427 times since Mon, Oct 29, 2018
How to Register and Enable Red Hat Subscription, Repositories and Updates for RHEL 7.0 Server
Viewed 1020 times since Mon, Oct 29, 2018
Jak wygenerować silne hasła jednorazowe w Linuksie?
Viewed 844 times since Thu, May 24, 2018
RHEL: Bonding network interfaces
Viewed 970 times since Sat, Jun 2, 2018
3 Ways to Check Linux Kernel Version in Command Line
Viewed 665 times since Fri, Apr 19, 2019