터미널을 닫았다 다시 열거나 맥을 재부팅할 때마다 설정했던 환경변수가 사라져서 답답하셨나요?
이는 환경변수가 현재 세션에만 임시로 적용되었기 때문에 발생하는 흔한 문제입니다.
이 글에서는 맥의 zshrc 파일을 활용하여 환경변수를 터미널 재시작이나 재부팅 후에도 변함없이 유지하는 3단계 영구 설정 방법을 명확하게 설명합니다.
– 환경변수는 ~/.zshrc 파일에 저장해야 영구적으로 유지됩니다.
– 파일 수정 후 source ~/.zshrc 명령어로 변경 사항을 즉시 적용할 수 있습니다.
– 잘못된 설정은 터미널 실행에 문제를 일으킬 수 있으므로 항상 파일 백업 및 내용 확인이 중요합니다.
맥 환경변수 임시 설정과 영구 설정의 차이
사용자가 터미널에서 export PATH=/usr/local/bin:$PATH와 같이 환경변수를 설정하는 방식은 현재 터미널 세션에만 유효합니다. 이 세션을 닫거나 맥을 재부팅하면 설정은 말끔히 사라지고, 매번 다시 입력해야 하는 불편함이 발생합니다. 개발 환경을 지속적으로 사용해야 하는 사용자에게는 이러한 임시 설정 방식이 매우 비효율적입니다.
이러한 임시 설정은 특정 작업을 위해 일시적으로 경로를 추가하거나 변수를 변경해야 할 때 유용하지만, 매번 반복적으로 사용해야 하는 변수라면 영구적인 설정이 필수적입니다. 영구 설정은 쉘이 시작될 때마다 자동으로 환경변수를 로드하여 사용자의 불편함을 획기적으로 줄여주며, 약 90% 이상의 상황에서 권장되는 방법입니다.
| 구분 | 임시 설정 | 영구 설정 |
|---|---|---|
| 유효 범위 | 현재 터미널 세션 | 모든 ZSH 쉘 세션 |
| 적용 방식 | export 명령어 수동 입력 |
~/.zshrc 파일 자동 로드 |
| 재시작 후 유지 여부 | 유지 안 됨 | 유지 됨 |
~/.zshrc 파일을 이용한 환경변수 영구 설정 방법
ZSH 쉘은 시작 시 사용자의 홈 디렉토리에 있는 ~/.zshrc 파일을 읽어 환경을 구성합니다. 따라서 여기에 환경변수를 추가하면 터미널이 열릴 때마다 자동으로 로드되어 영구적으로 유지됩니다. 이 파일은 숨김 파일 형태이며, 텍스트 편집기로 쉽게 수정할 수 있습니다.
예를 들어, 특정 개발 도구의 경로를 PATH에 추가하거나, 자주 사용하는 디렉토리 경로를 변수로 정의할 때 이 방법을 사용합니다. 올바른 설정을 위해 파일의 내용을 정확히 이해하고 단계별로 수정하는 것이 중요합니다. 이 과정은 단 3단계로 이루어집니다.
- 1단계: .zshrc 파일 열기 — 터미널에서
open ~/.zshrc명령어를 입력하여 기본 텍스트 편집기로~/.zshrc파일을 엽니다. 만약 파일이 없다면touch ~/.zshrc명령어를 통해 쉽게 생성할 수 있습니다. - 2단계: 환경변수 추가 — 파일 하단에 원하는 환경변수를 추가합니다. 예를 들어, 새로운 실행 경로를 PATH에 추가하려면
export PATH="$HOME/.bin:$PATH"와 같이 작성하고, 특정 값을 가진 변수를 정의하려면export MY_VARIABLE="value"와 같이 작성합니다. 변수명과 값 사이에 공백이 없도록 주의하세요. - 3단계: 파일 저장 및 닫기 — 변경 사항을 저장하고 텍스트 편집기를 닫습니다. 일반적으로 맥에서는
Command + S로 저장한 후Command + W로 창을 닫습니다.
Photo by Mingyang LIU on Pexels
설정 적용 및 확인, 그리고 주의사항
~/.zshrc 파일을 수정했다고 해서 바로 변경 사항이 적용되는 것은 아닙니다. 수정된 파일을 쉘에 다시 로드해야 합니다. 가장 간단한 방법은 터미널을 완전히 닫았다가 다시 여는 것이지만, source ~/.zshrc 명령어를 사용하면 현재 세션에서 약 1초 만에 즉시 적용할 수 있어 시간을 획기적으로 절약할 수 있습니다.
설정을 적용한 후에는 변수가 제대로 반영되었는지 반드시 확인해야 합니다. echo $PATH 또는 echo $MY_VARIABLE 명령어를 통해 설정된 값을 직접 확인할 수 있습니다. 잘못된 설정은 터미널 실행 오류를 유발할 수 있으므로, 항상 신중하게 접근하는 것이 중요합니다. 특히 PATH 변수 수정 시에는 기존 경로가 손상되지 않도록 주의해야 합니다.
~/.zshrc 파일에 오타나 잘못된 구문이 있으면 터미널 실행에 문제가 생길 수 있습니다. 중요한 변경을 하기 전에는 항상 파일 백업(예: cp ~/.zshrc ~/.zshrc_backup)을 해두는 것을 강력히 권장합니다. 특히 PATH 변수를 잘못 설정하면 기본적인 명령어(ls, cd 등)도 작동하지 않을 수 있으니 각별히 유의해야 합니다.
~/.zprofile이나 ~/.zshenv와 같은 다른 설정 파일들도 존재하지만, 대부분의 사용자 환경변수 설정은 ~/.zshrc에 하는 것이 일반적입니다. 쉘의 종류(로그인 쉘, 비로그인 쉘)에 따라 로드되는 파일이 다르다는 점을 이해하면 더욱 정교한 환경 설정이 가능합니다. 이 블로그에서는 기본적인 개발 환경 설정에 최적화된 ~/.zshrc 사용을 권장합니다.
맥에서 환경변수를 영구적으로 설정하려면 ~/.zshrc 파일을 수정하고 source ~/.zshrc 명령어로 적용하는 것이 핵심입니다. 이 3단계 과정을 통해 터미널 재시작이나 시스템 재부팅 후에도 설정이 완벽하게 유지되어 개발 효율을 크게 높일 수 있습니다.
지금 바로 적용해 보세요.
- Zsh 공식 문서 — Zsh 쉘의 다양한 설정 및 환경변수 관리에 대한 공식 자료입니다.
- Apple 지원: 터미널에서 셸 스크립트 실행 — 맥OS 터미널의 기본적인 쉘 스크립트 실행과 관련된 내용을 다룹니다.
동영상으로 보는 맥 환경변수 zshrc 영구 설정
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. 맥에서 환경변수를 영구적으로 설정하기 위해 ~/.zshrc 파일이 왜 중요한가요?
A. ~/.zshrc 파일은 macOS의 기본 셸인 Zsh의 주요 설정 파일입니다. 이 파일에 환경변수를 정의하면, 터미널을 다시 시작하거나 새로운 터미널 세션을 열 때마다 해당 변수들이 자동으로 로드되어 영구적으로 적용됩니다. 이를 통해 매번 수동으로 변수를 설정할 필요 없이 개발 환경을 일관되게 유지할 수 있습니다.
Q. 환경변수를 ~/.zshrc 파일에 추가하고 적용하는 구체적인 방법은 무엇인가요?
A. 먼저 `nano ~/.zshrc`와 같은 텍스트 편집기로 파일을 열고, `export MY_VARIABLE=”my_value”` 형식으로 원하는 환경변수를 추가합니다. 파일을 저장한 후, 현재 터미널 세션에 변경사항을 적용하기 위해 `source ~/.zshrc` 명령어를 실행하거나, 단순히 새로운 터미널 창이나 탭을 열면 됩니다.
Q. 터미널에 직접 `export` 명령어를 입력하는 것과 ~/.zshrc에 추가하는 것의 차이는 무엇인가요?
A. 터미널에 직접 `export` 명령어를 입력하면 해당 변수는 현재 터미널 세션 내에서만 유효하며, 터미널을 닫으면 사라집니다. 반면, ~/.zshrc 파일에 추가하면 이 변수가 영구적으로 저장되어, 새로운 Zsh 셸을 시작할 때마다 자동으로 로드되어 모든 터미널 세션과 재시작 후에도 유지됩니다.
Q. 환경변수를 ~/.zshrc에 추가했는데도 터미널에서 인식이 안 될 경우, 어떤 점을 확인해야 하나요?
A. 먼저 ~/.zshrc 파일이 올바르게 저장되었는지, 그리고 환경변수 이름이나 값에 오타가 없는지 확인해야 합니다. 그 다음, 현재 터미널에 변경사항을 반영하기 위해 `source ~/.zshrc` 명령어를 실행했는지, 또는 완전히 새로운 터미널 창을 열었는지 확인해 보세요. 파일이 홈 디렉터리에 올바르게 위치하고 읽기 권한이 있는지도 점검하는 것이 좋습니다.
📚 함께 읽으면 좋은 글