맥 터미널 껐다 켜면 사라지는 환경변수, zshrc 영구 설정 딱 정리

맥 터미널에서 `export PATH=/usr/local/bin:$PATH` 명령어로 환경변수를 설정했는데, 터미널을 껐다 켜니 설정이 사라져 당황스러우셨나요? 이는 터미널에서 `export` 명령어가 현재 세션에만 임시로 적용되기 때문입니다.

이 글에서는 macOS 환경에서 환경변수를 영구적으로 설정하는 핵심 방법인 `zshrc` 파일을 활용한 3단계 해결책을 명확히 제시합니다. 더 이상 반복적인 설정으로 시간을 낭비할 필요가 없습니다.

환경변수, 왜 터미널을 끄면 사라질까요?

대부분의 맥 사용자들이 겪는 공통적인 문제입니다. 터미널에서 `export` 명령어를 사용하여 `PATH`와 같은 환경변수를 설정하면, 해당 변수는 현재 실행 중인 쉘(Shell) 프로세스 내에서만 유효하게 됩니다. 즉, 터미널 창을 닫거나 새로운 터미널을 열면 이전에 설정했던 모든 변수들이 초기화되어 사라지는 것이죠.

이러한 특성 때문에 개발 환경을 설정할 때 불편함이 발생합니다. 예를 들어, 특정 프로그래밍 언어의 경로, 버전 관리 시스템(Git) 설정, 또는 사용자 정의 스크립트 실행 경로 등을 매번 수동으로 설정해야 한다면 작업 효율은 크게 떨어질 수밖에 없습니다. 특히 macOS는 기본 쉘로 `zsh`를 사용하기 때문에, `zsh`가 시작될 때 자동으로 로드되는 파일에 설정을 추가해야 영구적으로 유지됩니다.

영구적인 환경변수 설정은 개발자들에게 필수적인 과정이며, 복잡해 보이지만 한 번만 제대로 설정해두면 80% 이상의 반복 작업을 줄일 수 있습니다.

Photo by Giuseppe Di Maria on Pexels

`.zshrc` 파일로 환경변수 영구 설정하는 3단계 과정

이제 맥에서 환경변수를 영구적으로 설정하는 구체적인 방법을 알아보겠습니다. 이 과정은 총 3단계로 구성되며, 차분히 따라오시면 누구나 쉽게 적용할 수 있습니다.

1. 단계 1: `~/.zshrc` 파일 확인 및 생성 — 가장 먼저 할 일은 홈 디렉터리에 `.zshrc` 파일이 존재하는지 확인하는 것입니다. 터미널을 열고 다음 명령어를 입력하세요.

   ls -a ~ | grep .zshrc

   만약 `.zshrc` 파일이 보인다면 다음 단계로 넘어가시고, 파일이 존재하지 않는다면 다음 명령어로 생성할 수 있습니다.

   touch ~/.zshrc

   이 명령어는 `.zshrc`라는 이름의 빈 파일을 생성합니다. 파일 이름 앞에 점(.)이 붙어 숨김 파일로 처리됩니다.

2. 단계 2: `~/.zshrc` 파일에 환경변수 추가 — 이제 `.zshrc` 파일을 열어 원하는 환경변수를 추가해야 합니다. 터미널 편집기인 `nano`를 사용하는 것이 가장 직관적이고 쉽습니다.

   nano ~/.zshrc

   `nano` 편집기가 열리면, 파일의 가장 마지막 줄에 원하는 환경변수 설정을 추가합니다. 예를 들어, 특정 경로를 `PATH`에 추가하려면 다음과 같이 작성할 수 있습니다.

   export PATH="/usr/local/bin:$PATH"
   export MY_VARIABLE="Hello World"

   `PATH` 변수를 설정할 때는 `$PATH`를 뒤에 붙여 기존 경로를 유지하는 것이 중요합니다. 편집이 완료되면 `Control + X`를 누르고, `Y`를 눌러 변경 사항을 저장한 후 `Enter`를 누르면 `nano`가 종료됩니다.

3. 단계 3: 변경 사항 적용 및 확인 — 파일에 내용을 추가했지만, 현재 열려있는 터미널에는 아직 적용되지 않았습니다. 변경된 `.zshrc` 파일을 현재 쉘 세션에 반영하기 위해 다음 명령어를 입력합니다.

   source ~/.zshrc

   이 명령어는 `.zshrc` 파일의 내용을 다시 불러와 현재 쉘에 적용시킵니다. 이제 설정이 올바르게 적용되었는지 확인해볼 차례입니다. `echo` 명령어를 사용하여 변수 값을 확인하거나, 새로 추가한 도구가 잘 실행되는지 테스트해보세요.

   echo $PATH
   echo $MY_VARIABLE

   새로운 터미널 창을 열어서도 설정이 유지되는지 확인하는 것이 가장 중요합니다. 만약 새로운 터미널에서도 설정이 잘 유지된다면 성공입니다. 약 5초 안에 모든 과정이 끝나는 간단한 작업입니다.

`.zshrc` 설정 시 알아두면 좋은 팁과 주의사항

`.zshrc` 파일을 잘 활용하면 터미널 환경을 개인에게 최적화할 수 있지만, 몇 가지 팁과 주의사항을 알아두면 더욱 안전하고 효율적으로 사용할 수 있습니다.

`$PATH` 변수에 경로를 추가할 때, 순서가 매우 중요합니다. `export PATH=”/새로운/경로:$PATH”`와 같이 새로운 경로를 `$PATH` 앞에 두면 해당 경로가 기존 경로들보다 우선순위를 갖게 됩니다. 이는 시스템에 동일한 이름의 명령어가 여러 개 존재할 때, 어떤 명령어를 실행할지 결정하는 데 영향을 줍니다.

또한, `.zshrc` 외에 `.zshenv`, `.zprofile`, `.zlogin` 등 다른 Zsh 설정 파일들이 있지만, 대부분의 경우 환경변수 설정은 `.zshrc` 파일에 집중하는 것이 가장 일반적이고 권장되는 방식입니다. 이 파일은 인터랙티브 쉘이 시작될 때마다 로드되기 때문에 설정한 내용이 항상 적용됩니다.