Bash 스크립트 작성법

스크립트의 뼈대

#!/usr/bin/env bash
set -euo pipefail              # 실패를 숨기지 않는다 (아래 「안전하게 쓰기」)
 
readonly LOG_DIR="/var/log/app"
 
main() {
  local target="${1:?사용법: $0 <대상>}"   # 인자가 없으면 메시지를 내고 종료
  echo "처리: $target"
}
 
main "$@"

• 첫 줄 셔뱅(#!)이 인터프리터를 정한다. /usr/bin/env bash는 PATH에서 bash를 찾는다.
• 실행 권한을 주고(chmod +x) 실행하거나 bash script.sh로 실행한다.
• 로직을 main 함수에 넣고 맨 끝에서 부르면 함수 정의 순서를 신경 쓰지 않아도 된다. 함수는 호출보다 먼저 정의돼 있어야 하기 때문이다.

변수와 매개변수 확장

• 대입은 name=value. = 앞뒤에 공백이 있으면 명령 실행으로 해석돼 오류가 난다.
• 변수는 기본이 전역이다. 함수 안에서는 local을 붙인다. 자식 프로세스에 넘기려면 export.
• 쓸 때는 항상 큰따옴표로 감싼다("$var"). 따옴표가 없으면 단어 분리와 * 확장이 일어난다. 확장 순서와 함정은 셸이 명령을 실행하는 방식에 있다.
• 명령 결과는 $(명령)으로 받는다. 옛 백틱(`명령`)은 중첩이 불편하다.

배열

files=("a.txt" "b c.txt")      # 인덱스 배열 (0부터)
files+=("d.txt")               # 추가
echo "${files[0]}"             # 요소
echo "${#files[@]}"            # 개수
for f in "${files[@]}"; do …   # 공백 든 요소도 안전하게 순회
unset 'files[1]'               # 요소 삭제
 
declare -A port=([web]=80 [db]=5432)   # 연관 배열 (bash 4+)
echo "${port[db]}"; echo "${!port[@]}" # 값, 키 목록

배열은 1차원만 된다. 복사도 copy=("${files[@]}")처럼 따옴표를 붙여야 요소가 쪼개지지 않는다.

조건문

if [[ -f "$file" && "$file" == *.log ]]; then …
elif (( size > 1024 )); then …
else …
fi
 
case "$cmd" in
  start|up) start_server ;;
  stop)     stop_server ;;
  *)        echo "알 수 없는 명령: $cmd" >&2; exit 2 ;;
esac

자주 쓰는 검사: 파일 -f, 디렉터리 -d, 존재 -e, 실행 가능 -x, 빈 문자열 -z, 비어 있지 않음 -n. 문자열 비교는 ==·!=, 숫자 비교는 (( )) 또는 -eq·-lt·-gt.

반복문

for host in web1 web2 web3; do ssh "$host" uptime; done
for ((i = 0; i < 10; i++)); do …; done
for f in ./*.csv; do [[ -e "$f" ]] || continue; …; done   # 일치하는 파일이 없을 때 대비
 
while IFS= read -r line; do
  echo "$line"
done < input.txt              # 파일을 한 줄씩 (공백·역슬래시 보존)
 
until curl -sf localhost:8080/health; do sleep 1; done

ls 출력을 for로 돌리지 않는다. 파일 이름의 공백에서 쪼개진다. 글롭(*.csv)이나 find … -print0 | xargs -0을 쓴다. break는 반복을 끝내고 continue는 다음 회차로 넘어간다.

함수와 인자

함수의 return은 0~255 종료 코드만 돌려준다. 값을 돌려주려면 echo로 출력하고 호출 쪽에서 $(함수)로 받는다. 인자 파싱은 getopts로 한다.

종료 코드와 안전하게 쓰기

종료 코드 0은 성공, 0이 아니면 실패다. if 명령; then, 명령 && 다음, 명령 || 대안이 모두 이 값으로 분기한다.

tmp="$(mktemp -d)"
trap 'rm -rf "$tmp"' EXIT     # 정상 종료든 오류든 임시 파일 정리

• trap '…' EXIT로 정리 코드를, trap '…' INT TERM으로 중단 처리를 건다.
• 오류 메시지는 표준 오류로(echo "…" >&2), 사용법 오류는 2 같은 별도 종료 코드로 낸다.
• 위험한 명령은 변수가 비었을 때를 막는다. rm -rf "$dir/"*에서 dir이 비면 루트를 지운다. set -u와 ${dir:?}로 막는다.

디버깅

• bash -n script.sh: 실행하지 않고 문법만 검사한다.
• set -x(또는 bash -x script.sh): 확장이 끝난 명령을 실행 전에 출력한다. 필요한 구간만 set -x … set +x로 감싼다.
• ShellCheck: 따옴표 누락, $@ 오용, 쓰지 않는 변수 같은 흔한 실수를 정적 분석으로 잡는다. 편집기·CI에 붙여 둔다.

명령줄을 빠르게 쓰는 습관

스크립트가 수십 줄을 넘고 자료 구조·오류 처리가 복잡해지면 Python 같은 범용 언어로 옮기는 편이 낫다.

정리

• 변수는 늘 큰따옴표로, 인자는 늘 "$@"로 넘긴다.
• bash 스크립트의 조건은 [[ ]], 산술은 (( )).
• set -euo pipefail과 trap … EXIT로 실패를 드러내고 뒷정리를 보장한다.
• ShellCheck과 bash -n, set -x로 실수를 잡는다.

관련 노트: 셸이 명령을 실행하는 방식, 자주 쓰는 리눅스 명령어 지도, The Missing Semester: CS 교육에서 빠진 도구 학기, 리눅스 서버 점검: 부하·메모리·자원 한도