터미널 닫으면 사라지는 맥 환경변수 — zshrc 영구 설정 딱 정리

개발 도구를 사용하기 위해 PATH를 설정했는데, 터미널을 닫고 다시 열 때마다 환경변수가 사라져 매번 같은 명령어를 입력하고 계신가요? 이는 현재 세션에만 영향을 주는 일시적인 설정 방식 때문입니다.

이 글에서는 맥의 zsh 환경에서 환경변수를 다시 설정하는 불편함을 영구적으로 해결하는 방법을, 3단계의 구체적인 과정으로 명확하게 정리해 드립니다.

환경변수가 사라지는 이유와 ~/.zshrc의 역할

맥 터미널에서 `export PATH=/usr/local/bin:$PATH`와 같은 명령어를 입력하면 해당 환경변수는 현재 열려있는 터미널 세션에서만 유효합니다. 터미널을 닫는 순간, 이 세션은 종료되고 함께 설정했던 모든 환경변수는 초기화됩니다. 마치 잠시 책상 위에 펼쳐둔 노트를 덮는 것과 같습니다. 다음에 다시 터미널을 열면 새로운 빈 책상이 펼쳐지는 셈이죠.

이러한 불편함을 해결하기 위해 zsh 셸은 `.zshrc`라는 특별한 파일을 사용합니다. `~/.zshrc` 파일은 사용자가 터미널을 열 때마다 자동으로 실행되는 스크립트 파일입니다. 여기에 환경변수를 설정해두면, 터미널을 새로 열 때마다 항상 동일한 환경변수가 자동으로 로드되어 영구적인 효과를 낼 수 있습니다.

개발 환경을 구축하거나 특정 명령어가 올바르게 인식되게 하려면 이 `.zshrc` 파일을 정확하게 이해하고 활용하는 것이 중요합니다. 이 파일을 통해 여러분은 매번 반복되는 수동 설정의 번거로움에서 완전히 벗어날 수 있습니다.

~/.zshrc 파일을 이용한 환경변수 영구 설정 3단계

이제 `.zshrc` 파일을 활용하여 환경변수를 영구적으로 설정하는 구체적인 3단계 과정을 살펴보겠습니다. 이 단계를 순서대로 따라 하면 단 1분 만에 환경변수 설정을 마무리하고 더 이상 신경 쓸 필요가 없어집니다.

1. zshrc 파일 열기 — 터미널에서 다음 명령어를 입력하여 `.zshrc` 파일을 텍스트 편집기로 엽니다. 만약 파일이 없다면 새로 생성됩니다. `open ~/.zshrc` 또는 `vi ~/.zshrc`를 사용할 수 있습니다. Vim 편집기가 익숙하지 않다면 `open` 명령이 기본 텍스트 편집기로 파일을 열어 편리합니다.
2. 환경변수 추가/수정 — 열린 `.zshrc` 파일의 가장 아랫줄에 원하는 환경변수 설정을 추가합니다. 예를 들어, Homebrew로 설치한 특정 경로를 PATH에 추가하려면 다음과 같이 작성합니다.

   export PATH="/opt/homebrew/bin:$PATH"

   export MY_VARIABLE="Hello World"

   PATH에 새로운 경로를 추가할 때는 기존 PATH 값을 덮어쓰지 않고 콜론(`:`)으로 구분하여 추가하는 것이 중요합니다. `$PATH`는 기존 PATH 값을 의미합니다.

3. 변경 사항 적용 — 파일을 저장하고 닫은 다음, 터미널로 돌아와 다음 명령어를 입력하여 변경된 `.zshrc` 파일을 현재 세션에 적용합니다.

   source ~/.zshrc

   이 명령은 `.zshrc` 파일을 다시 읽어 현재 터미널 세션에 환경변수를 즉시 반영합니다. 또는 터미널을 완전히 닫았다가 다시 열어도 변경 사항이 적용됩니다.

환경변수 적용 확인 및 주의사항

환경변수를 설정한 후에는 반드시 제대로 적용되었는지 확인하는 절차가 필요합니다. 터미널에 `echo $PATH` 또는 `printenv` 명령어를 입력하여 새로 추가한 경로 또는 설정한 변수가 목록에 나타나는지 확인합니다. 예를 들어, `echo $PATH`를 실행했을 때 `/opt/homebrew/bin`이 포함되어 있다면 성공적으로 적용된 것입니다.

환경변수를 설정할 때 몇 가지 주의할 점이 있습니다. 특히 PATH 변수를 다룰 때는 기존 경로를 실수로 삭제하거나 잘못된 순서로 지정하여 시스템 명령어가 작동하지 않는 문제가 발생할 수 있습니다. 예를 들어, `$PATH`를 누락하고 `export PATH=”/new/path”`라고만 설정하면 기존의 필수 시스템 경로들이 모두 사라져 `ls`, `cd` 같은 기본 명령어조차 사용할 수 없게 됩니다.

또한, `.zshrc` 파일에 문법 오류가 있으면 터미널을 열 때마다 오류 메시지가 나타나거나 셸이 제대로 시작되지 않을 수 있습니다. 이런 경우 당황하지 말고 다른 텍스트 편집기(예: Visual Studio Code)를 이용해 `.zshrc` 파일을 열어 오류를 수정하거나, 문제가 되는 부분을 주석 처리하여 원래대로 돌릴 수 있습니다.