koalaman/shellcheck

Что это?

Ключевые возможности

• 01Находит ошибки с кавычками, некорректные условия и неправильное использование команд в скриптах bash и sh.
• 02Выявляет проблемы переносимости с учётом shebang скрипта — аналогично checkbashisms.
• 03Объясняет каждое предупреждение и даёт ссылки на подробные страницы вики.
• 04Интегрируется со многими редакторами и CI-сервисами.
• 05Выводит результаты в виде текста, JSON, XML в формате CheckStyle или сообщений, совместимых с GCC.

Сценарии использования

• Проверка shell-скриптов в CI-пайплайне, чтобы сборка завершалась с ошибкой при появлении новых предупреждений.
• Поиск переменных без кавычек и опасных шаблонов для rm или find до запуска скрипта.
• Проверка, что скрипт для /bin/sh не использует возможности, доступные только в bash.
• Получение подсказок прямо в редакторе во время работы над shell-скриптами.

Быстрый старт

1. 1

   Установите ShellCheck с помощью Homebrew

   brew install shellcheck
2. 2

   Запустите ShellCheck для скрипта

   shellcheck yourscript

Что важно знать

• !Распространяется по лицензии GPL-3.0 с копилефтом.
• !Для компиляции из исходного кода требуется около 2 ГБ оперативной памяти.

В подборках

Темы

Частые вопросы

Что такое shellcheck?

Инструмент статического анализа, который находит ошибки, проблемы переносимости и вредные привычки в скриптах bash и sh. ShellCheck анализирует скрипты оболочки и выдаёт предупреждения и рекомендации о синтаксических ошибках, проблемах в логике и малозаметных ловушках, из-за которых скрипт может работать неверно или завершиться с ошибкой. Он проверяет скрипты bash и sh и указывает, например, на переменные без кавычек, неправильное использование операторов test, некорректные шаблоны для find или grep и скрытые коды завершения, а также объясняет каждое предупреждение.

shellcheck можно использовать бесплатно? Какая у него лицензия?

shellcheck распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

shellcheck всё ещё поддерживается?

Активно поддерживается. Последний коммит в shellcheck — 5 нояб. 2026 г..

Для чего можно использовать shellcheck?

Проверка shell-скриптов в CI-пайплайне, чтобы сборка завершалась с ошибкой при появлении новых предупреждений. Поиск переменных без кавычек и опасных шаблонов для rm или find до запуска скрипта. Проверка, что скрипт для /bin/sh не использует возможности, доступные только в bash. Получение подсказок прямо в редакторе во время работы над shell-скриптами.

Как установить shellcheck?

Установите ShellCheck с помощью Homebrew: brew install shellcheck Запустите ShellCheck для скрипта: shellcheck yourscript

Где скачать shellcheck?

Исходный код и инструкции по установке — на GitHub: https://github.com/koalaman/shellcheck