Как проверить синтаксис сценария Bash, не запуская его?

Время меняет все. Вот веб-сайт, который обеспечивает онлайн-проверку синтаксиса для сценария оболочки.

Я обнаружил, что это очень мощное средство для обнаружения распространенных ошибок.

О ShellCheck

ShellCheck – это инструмент статического анализа и проверки скриптов sh/bash. В основном он сосредоточен на обработке типичных синтаксических ошибок и ловушек начального и среднего уровня, когда оболочка просто выдает загадочное сообщение об ошибке или странное поведение, но также сообщает о нескольких более сложных проблемах, где крайние случаи могут вызвать отложенные сбои.

Исходный код Haskell доступен на GitHub!

Я также включаю опцию «u» для каждого сценария bash, который я пишу, чтобы выполнить дополнительную проверку:

set -u 

Это сообщит об использовании неинициализированных переменных, как в следующем скрипте «check_init.sh».

#!/bin/sh
set -u
message=hello
echo $mesage

Запуск скрипта:

$ check_init.sh

Сообщит следующее:

./check_init.sh[4]: сообщение: Параметр не установлен.

Очень полезно ловить опечатки

sh  -n   script-name 

Запустите это. Если в скрипте есть какие-либо синтаксические ошибки, он возвращает такое же сообщение об ошибке. Если ошибок нет, то выходит без каких-либо сообщений. Вы можете проверить это немедленно, используя echo $?, который безошибочно вернет 0, подтверждающий успешное выполнение.

Это сработало для меня хорошо. Я запускал ОС Linux, Bash Shell.

На самом деле я проверяю все сценарии bash в текущем каталоге на наличие синтаксических ошибок БЕЗ запуска их с помощью инструмента find:

Пример:

find . -name '*.sh' -exec bash -n {} \;

Если вы хотите использовать его для одного файла, просто отредактируйте подстановочный знак с именем файла.

пустая команда [двоеточие] также полезна при отладке, чтобы увидеть значение переменной

set -x
for i in {1..10}; do
    let i=i+1
    : i=$i
done
set - 

Существует плагин BashSupport для IntelliJ IDEA, который проверяет синтаксис.

Если вам нужно указать в переменной допустимость всех файлов в каталоге (перехватчик git pre-commit, сборка скрипта lint), вы можете перехватить вывод stderr команд «sh -n» или «bash -n» (см. ответы) в переменной и иметь "if/else" на основе этого

bashErrLines=$(find bin/ -type f -name '*.sh' -exec sh -n {} \;  2>&1 > /dev/null)
  if [ "$bashErrLines" != "" ]; then 
   # at least one sh file in the bin dir has a syntax error
   echo $bashErrLines; 
   exit; 
  fi

Замените «sh» на «bash» в зависимости от ваших потребностей.

Только для проверки синтаксиса:

shellcheck [programPath]

Для запуска программы только в том случае, если синтаксис проходит успешно, поэтому отладка как синтаксиса, так и выполнения:

защищенный [programPath]