Mac에서 개발 환경 설정을 위해 PATH나 alias를 .zshrc에 분명히 추가했는데, 터미널을 껐다 켜거나 재부팅하고 나면 싹 사라져버려 매번 다시 입력해야 하는 답답한 상황을 겪고 계신가요? 이 문제는 .zshrc 파일이 올바르게 로드되거나 변경 사항이 즉시 적용되지 않아서 발생하는 경우가 대부분입니다.
이 글에서는 Mac 환경에서 zshrc 파일을 통해 환경변수를 영구적으로 설정하고, 재부팅 후에도 설정이 그대로 유지되도록 하는 정확하고 구체적인 방법을 단계별로 안내합니다.
– .zshrc 파일의 정확한 이해와 위치 확인 방법을 알 수 있습니다.
– 환경변수와 alias를 .zshrc에 영구적으로 설정하는 3단계 과정을 배울 수 있습니다.
– 설정 변경 후, 즉시 적용하고 제대로 작동하는지 검증하는 방법을 이해할 수 있습니다.
재부팅해도 사라지지 않도록 맥 환경변수를 zshrc 파일에 영구적으로 설정하는 방법을 안내합니다.
.zshrc 파일, 무엇이며 왜 중요한가?
.zshrc 파일은 Zsh 쉘이 시작될 때마다 자동으로 실행되는 스크립트 파일입니다. 이 파일에 여러분이 자주 사용하는 개발 도구의 PATH, 커스텀 alias, 그리고 기타 환경 설정들을 정의하면 터미널을 열 때마다 이 설정들이 자동으로 로드되어 편리하게 작업할 수 있습니다. Mac의 기본 쉘이 Bash에서 Zsh로 변경된 지 꽤 되었기 때문에, 대부분의 Mac 사용자들은 이 .zshrc 파일을 활용하게 됩니다.
이 파일은 홈 디렉토리에 숨김 파일 형태로 존재하며, 파일명 앞의 점(.)이 이를 의미합니다. 만약 이 파일을 제대로 활용하지 못하면, 매번 수동으로 환경변수를 설정해야 하는 비효율적인 상황이 반복될 수 있습니다. 여러분의 개발 생산성을 획기적으로 높이는 첫걸음은 이 .zshrc 파일을 정확히 이해하고 관리하는 것에서 시작됩니다.
숨김 파일을 찾기 어려울 경우, 터미널에서 ‘ls -a ~’ 명령어를 입력하여 홈 디렉토리의 모든 파일 목록을 확인해 보세요. .zshrc 파일 외에도 .bash_profile, .profile 등 다른 쉘 설정 파일도 함께 보일 수 있습니다.
환경변수와 alias 영구 설정을 위한 3단계
이제 .zshrc 파일을 직접 편집하여 환경변수와 alias를 영구적으로 설정하는 구체적인 단계를 살펴보겠습니다. 이 과정은 크게 세 가지 핵심 단계로 나눌 수 있으며, 각 단계를 정확히 따라 하는 것이 중요합니다.
- .zshrc 파일 열기 — 터미널을 열고 ‘nano ~/.zshrc’ 또는 ‘vi ~/.zshrc’를 입력하여 .zshrc 파일을 엽니다. nano는 초보자에게 더 친숙한 텍스트 편집기이며, vi는 강력하지만 사용법이 다소 복잡할 수 있습니다. 파일이 없다면, 새 파일이 생성됩니다.
- 환경변수 및 alias 추가/수정 — 파일 가장 아래에 원하는 환경변수나 alias를 추가합니다. 예를 들어, 특정 개발 도구의 경로를 추가하려면 ‘export PATH=”/opt/homebrew/bin:$PATH”‘와 같이 작성합니다. alias는 ‘alias ll=”ls -alF”‘와 같이 정의할 수 있습니다. 이때 ‘export’ 키워드는 환경변수를 하위 프로세스에도 전달할 때 사용되며, alias는 단순한 명령 단축키 역할을 합니다.
- 파일 저장 및 닫기 — nano 에디터의 경우 Ctrl+X를 누른 후 Y(저장)와 Enter(파일 이름 확인)를 눌러 저장하고 닫습니다. vi 에디터의 경우 ‘:wq’를 입력하고 Enter를 누릅니다.
PATH를 설정할 때는 기존 PATH를 덮어쓰지 않도록 “$PATH”를 함께 포함해야 합니다. 만약 “$PATH”를 빼고 작성하면 기존 PATH가 모두 사라져 시스템 명령어를 찾지 못하는 심각한 문제가 발생할 수 있습니다.
Photo by Break Media on Pexels
설정 변경 후 즉시 적용 및 올바른 검증 방법
.zshrc 파일을 수정하고 저장했다고 해서 바로 변경 사항이 적용되는 것은 아닙니다. 현재 실행 중인 쉘은 이 변경 사항을 인지하지 못하기 때문입니다. 따라서 수정된 .zshrc 파일을 현재 쉘에 “source” 해주어 변경 내용을 즉시 반영해야 합니다. 이 과정은 5초도 걸리지 않는 매우 간단한 작업입니다.
- 변경 사항 즉시 적용 — 터미널에 ‘source ~/.zshrc’를 입력하고 Enter를 누릅니다. 이 명령은 .zshrc 파일을 다시 읽어들여 현재 쉘 세션에 적용시키는 역할을 합니다.
- 환경변수 검증 — 설정한 환경변수가 올바르게 적용되었는지 확인합니다. 예를 들어 PATH를 추가했다면 ‘echo $PATH’를 입력하여 새로운 경로가 PATH에 포함되었는지 확인합니다. alias를 설정했다면, ‘type ll’ (ll은 예시 alias)와 같이 입력하여 정의된 alias가 출력되는지 확인합니다.
- 재부팅 후 확인 — 터미널을 완전히 닫았다가 다시 열거나, 시스템을 재부팅한 후에도 설정이 잘 유지되는지 다시 한번 확인합니다. 이 과정까지 성공했다면, 환경변수 영구 설정이 완벽하게 완료된 것입니다.
Photo by John Tekeridis on Pexels
환경변수 설정 시 자주 묻는 질문과 해결책
많은 분들이 환경변수 설정 과정에서 몇 가지 공통적인 문제에 직면하곤 합니다. 이러한 문제들은 대부분 간단한 확인 절차를 통해 해결할 수 있습니다. 특히, 오타나 경로 오류가 80% 이상의 문제를 차지합니다.
| 문제 상황 | 가능한 원인 | 해결책 |
|---|---|---|
| ‘command not found’ 오류 발생 | PATH에 지정된 경로가 잘못되었거나 오타가 있는 경우 | .zshrc 파일을 다시 열어 PATH 경로에 오타가 없는지, 실제 파일 경로와 일치하는지 꼼꼼히 확인합니다. |
| alias가 작동하지 않음 | alias 정의에 문법 오류가 있거나 source 명령을 실행하지 않음 | alias 구문을 정확히 확인하고, ‘source ~/.zshrc’를 다시 실행합니다. ‘type [alias이름]’으로 확인합니다. |
| 변경 사항이 재부팅 후 사라짐 | .zshrc 파일이 아닌 다른 쉘 설정 파일을 편집한 경우 (.bashrc, .profile 등) | Mac의 기본 쉘이 Zsh인지 확인하고, 반드시 ~/.zshrc 파일을 편집했는지 다시 확인합니다. |
설정 오류가 의심될 경우, .zshrc 파일 내용을 터미널에 ‘cat ~/.zshrc’ 명령어로 출력하여 한 줄 한 줄 검토해 보는 것이 효과적인 디버깅 방법이 될 수 있습니다.
Mac에서 개발 환경 변수를 영구적으로 설정하는 것은 .zshrc 파일을 정확히 이해하고 올바르게 편집하는 것에 달려 있습니다. PATH와 alias를 설정한 후에는 반드시 ‘source ~/.zshrc’ 명령으로 변경 사항을 즉시 적용하고, ‘echo $PATH’ 등의 명령으로 검증하는 습관을 들이는 것이 중요합니다.
지금 바로 적용해 보세요.
- Zsh Documentation — Zsh 쉘의 공식 문서로, .zshrc 파일을 포함한 다양한 설정에 대한 심층적인 정보를 제공합니다.
- Apple Developer Documentation: Shell Scripting Primer — macOS 환경에서 쉘 스크립팅의 기초와 환경변수 설정에 대한 유용한 가이드를 확인할 수 있습니다.
동영상으로 보는 맥 zshrc 환경변수 영구 설정
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. `~/.zshrc` 파일은 정확히 무엇이며, 왜 중요한가요?
A. `~/.zshrc` 파일은 Zsh 셸이 시작될 때마다 자동으로 실행되는 스크립트 파일입니다. 이 파일에 환경변수, 함수, 별칭(alias) 등을 설정하면 해당 설정들이 터미널 세션 전반에 걸쳐 적용되어 사용자별 작업 환경을 맞춤 설정하는 데 핵심적인 역할을 합니다.
Q. 왜 환경변수를 설정해도 재부팅하거나 터미널을 닫으면 사라지는 건가요?
A. 이는 대부분 환경변수를 현재 셸 세션에만 유효하도록 일시적으로 설정했기 때문입니다. 예를 들어, `export VAR=value` 명령어를 터미널에 직접 입력하면 현재 세션에서만 유효하며, 터미널을 닫거나 시스템을 재부팅하면 해당 설정이 초기화됩니다. `~/.zshrc` 같은 셸 초기화 스크립트에 저장해야 영구적으로 적용됩니다.
Q. `~/.zshrc` 파일을 수정했는데, 바로 적용되지 않는 것 같아요. 어떻게 해야 하나요?
A. `~/.zshrc` 파일을 수정한 후에는 변경사항을 적용하기 위해 새로운 터미널 세션을 열거나 현재 셸을 다시 로드해야 합니다. 가장 간단한 방법은 터미널에서 `source ~/.zshrc` 명령어를 실행하여 수정된 파일을 현재 셸에 즉시 다시 불러오는 것입니다.
Q. 환경변수가 제대로 영구 설정되었는지 어떻게 확인할 수 있나요?
A. 설정한 환경변수를 확인하려면 터미널에 `echo $변수명`을 입력하여 값이 올바르게 출력되는지 확인하세요. 더 확실하게는 터미널을 완전히 닫았다가 다시 열거나, 시스템을 재부팅한 후 동일하게 `echo $변수명` 명령어를 다시 실행하여 값이 여전히 유지되는지 확인하면 됩니다.
📚 함께 읽으면 좋은 글