첫 셸 스크립트 만들고 실행하기 — shebang·실행 권한·PATH

터미널에 명령을 한 줄씩 치는 것과, 그 명령들을 파일 하나로 묶어 실행하는 것 사이에는 작지만 분명한 문턱이 있다. shebang은 뭐고, 왜 chmod +x를 해야 하고, 왜 script.sh가 아니라 ./script.sh로 불러야 하는가 — 이 첫걸음을 넘고 나면 셸 스크립트 문법 종합 가이드의 문법이 얹힐 바닥이 생긴다. 이 글은 딱 그 문턱을 넘는 데까지만 다룬다.

가장 짧은 스크립트

빈 파일 hello.sh를 만들고 두 줄을 넣는다.

#!/usr/bin/env bash
echo "hello, $(whoami)"

이걸 실행하는 방법은 세 가지다. 셋의 차이가 이 글의 본론이다.

bash hello.sh     # (1) 인터프리터를 직접 지정
./hello.sh        # (2) 파일 자체를 실행 (권한 필요)
hello             # (3) PATH에 등록해 어디서나

shebang — 첫 줄 #!가 하는 일

첫 줄 #!/usr/bin/env bash를 shebang(셔뱅)이라 부른다. #!로 시작하는 이 줄은 “이 파일을 실행할 때 어떤 인터프리터에 넘길지“를 커널에게 알려준다.

./hello.sh처럼 파일을 직접 실행하면, 커널이 첫 줄을 읽어 /usr/bin/env bash hello.sh로 바꿔 실행한다. shebang이 없으면 커널은 이 파일을 무엇으로 돌려야 할지 몰라, 셸이 대신 자기(sh/bash)로 실행을 시도한다 — 운 좋으면 되지만, 의도한 인터프리터라는 보장이 없다.

#!/bin/bash가 아니라 #!/usr/bin/env bash를 쓰는 이유:

env bash는 PATH에서 bash를 찾아 실행한다. bash 위치가 시스템마다 다를 때(예: Homebrew로 설치한 최신 bash는 /opt/homebrew/bin/bash, 시스템 bash는 /bin/bash) env가 알아서 골라준다. 반면 #!/bin/bash는 경로를 못 박아, 그 위치에 없으면 깨진다. 이식성이 필요하면 env, 위치를 확정하고 싶으면 절대경로 — 요즘 관행은 env 쪽이다.

macOS에서 특히 주의할 점: mac 기본 셸은 zsh지만, 시스템에 딸려 오는 /bin/bash는 2007년에 멈춘 3.2 버전이다. 스크립트에 bash 4+ 문법(연관 배열 declare -A 등)을 쓴다면 Homebrew bash를 깔고 shebang을 #!/usr/bin/env bash로 두어 최신 bash가 잡히게 해야 한다.

chmod +x — 실행 권한

./hello.sh로 실행하려면 파일에 실행 권한이 있어야 한다. 갓 만든 파일엔 없어서, 그냥 실행하면 이렇게 막힌다.

$ ./hello.sh
zsh: permission denied: ./hello.sh

chmod +x로 실행 비트를 켠다.

chmod +x hello.sh
./hello.sh          # 이제 실행됨

ls -l로 보면 권한 문자열에 x가 붙은 걸 확인할 수 있다.

$ ls -l hello.sh
-rwxr-xr-x  1 user  staff  38  7  4 09:00 hello.sh

bash hello.sh로 실행할 때는 권한이 필요 없다. 이 경우 파일을 “실행”하는 게 아니라, bash에게 “이 파일을 읽어서 처리해”라고 넘기는 것이기 때문이다. shebang도 이때는 그냥 주석(#)으로 무시된다.

./는 왜 붙이나 — PATH 이야기

권한까지 줬는데도 이름만으로는 안 된다.

$ hello.sh
zsh: command not found: hello.sh
$ ./hello.sh
hello, user

이유는 PATH다. 셸은 명령 이름을 받으면 PATH에 나열된 디렉토리들만 뒤져 실행 파일을 찾는다. 현재 디렉토리(.)는 보안상 PATH에 없다 — 만약 있었다면, 어떤 폴더에 들어가서 ls를 쳤을 때 그 폴더에 숨겨둔 악성 ls가 실행될 수 있다.

그래서 “지금 이 폴더에 있는 이 파일을 실행하라”를 명시적으로 말해야 하고, 그게 ./다. .은 현재 디렉토리, ./hello.sh는 “현재 디렉토리의 hello.sh”.

PATH에 등록해 어디서나 부르기

./도 매번 붙이기 번거롭고, 진짜 도구라면 아무 데서나 이름만으로 부르고 싶다. 그러려면 스크립트를 PATH에 있는 디렉토리에 두면 된다. 개인 스크립트는 보통 ~/bin이나 ~/.local/bin에 모은다.

mkdir -p ~/.local/bin
mv hello.sh ~/.local/bin/hello     # 확장자 떼는 게 관례 (아래 참고)

그리고 이 디렉토리를 PATH에 추가한다. 셸 설정 파일에 한 줄 넣으면 된다 — 어느 파일에 넣어야 하는지는 초기화 파일 로딩 순서 글을 참고.

# ~/.zshrc (zsh) 또는 ~/.bashrc (bash)
export PATH="$HOME/.local/bin:$PATH"

새 터미널을 열거나 source ~/.zshrc로 반영하면, 이제 어느 폴더에서든 hello로 실행된다.

.sh 확장자는 필수가 아니다. 셸은 파일 내용(shebang)으로 실행 방법을 정하지 확장자를 보지 않는다. 그래서 PATH에 넣는 “명령”은 git·ls처럼 확장자 없이 두는 게 관례다. 반대로 다른 스크립트가 source로 읽어 들이는 라이브러리성 파일은 .sh를 붙여 구분한다.

첫날 흔한 함정

증상	원인	해결
permission denied	실행 권한 없음	chmod +x script.sh
command not found	PATH에 없는데 이름만 부름	./script.sh 또는 PATH 등록
bad interpreter: ... ^M	Windows에서 만든 파일의 CRLF 줄바꿈	sed -i '' 's/\r$//' script.sh (또는 에디터에서 LF로 저장)
shebang 무시됨	#!가 첫 줄 첫 칸이 아님 / 앞에 공백·빈 줄	shebang을 파일 맨 첫 줄로
문법은 맞는데 이상 동작	sh script.sh로 돌려 bash 확장 문법이 안 먹힘	bash script.sh 또는 ./로 shebang 태우기

특히 bad interpreter: ...^M은 Windows·웹에서 복사해 온 스크립트에서 자주 나온다. CRLF 줄바꿈의 \r이 shebang 경로 끝에 붙어 /usr/bin/env bash\r라는 없는 인터프리터를 찾게 되는 것. 눈에 안 보여서 처음엔 당황스럽다 — 줄바꿈·인코딩을 다루는 셸 기법과 같은 결의 문제다.

여기까지 오면

명령을 파일로 묶고, 실행 권한을 주고, ./나 PATH로 실행하는 — 스크립트의 실행 골격이 잡혔다. 이제 그 안을 채우는 문법(변수·조건·반복·함수)이 필요하다. 셸 스크립트 문법 종합 가이드로 이어서, set -euo pipefail로 견고하게 만드는 데까지가 셸 로드맵의 다음 걸음이다. </content>