zshrc 설정으로 맥 환경변수 영구 적용하기

터미널을 닫거나 재시작할 때마다 맥 환경변수가 사라져 다시 설정해야 하는 불편함을 겪고 있나요? 매번 같은 명령어를 입력하거나 설정을 반복해야 하는 상황은 개발 생산성을 크게 저하시킵니다. 이는 쉘이 시작될 때마다 환경변수를 새로 불러오지 않기 때문입니다. 이 글에서는 zshrc 파일을 활용하여 맥 환경변수를 영구적으로 설정하는 구체적인 방법을 단계별로 안내합니다.

함께 보면 좋은 글: 맥 API 키 환경변수 설정, 실수 없이 끝내기

맥 환경변수, 왜 영구 설정이 필요할까?

개발 환경에서 특정 도구나 라이브러리를 사용하려면 해당 프로그램의 실행 파일이 있는 경로를 시스템이 인식하도록 설정해야 합니다. 맥 운영체제에서는 이를 환경변수, 특히 PATH 변수를 통해 관리합니다. PATH 변수에는 시스템이 명령어를 찾을 수 있는 여러 디렉토리 경로가 포함되어 있습니다. 사용자가 임의로 설치한 도구들은 기본 PATH에 포함되지 않아 터미널에서 직접 실행 파일의 전체 경로를 입력해야 하는 번거로움이 발생합니다. 예를 들어, Homebrew로 설치한 git 명령어를 사용하기 위해 매번 /usr/local/bin/git 와 같이 입력하는 것은 비효율적입니다. 이는 개발 워크플로우에서 상당한 시간을 소모하게 만들며, 특히 반복적인 작업 시 피로도를 높입니다.

이러한 문제는 터미널 세션이 종료될 때마다 환경변수 설정이 초기화되기 때문에 발생합니다. 즉, 터미널을 새로 열 때마다 이전 설정을 다시 적용해야 하는 상황이 반복되는 것입니다. 예를 들어, Node.js 버전 관리 도구인 nvm을 설치하고 PATH를 설정했더라도, 새 터미널 창을 열면 nvm 관련 명령어를 인식하지 못하는 현상을 경험할 수 있습니다. 이는 매번 nvm 초기화 스크립트를 다시 실행해야 함을 의미합니다. 이러한 반복적인 설정 과정은 개발자의 집중력을 분산시키고, 실수할 가능성을 높입니다. 특히 여러 프로젝트를 동시에 진행하거나 다양한 도구를 사용하는 개발자에게는 더욱 치명적입니다.

이 글은 이러한 불편함을 해소하기 위해 맥 사용자들이 가장 많이 사용하는 쉘인 Zsh의 설정 파일인 .zshrc 파일을 이용하여 환경변수를 영구적으로 설정하는 방법을 자세히 안내합니다. PATH 변수 설정부터 커스텀 변수 추가까지, 필요한 모든 과정을 단계별로 설명하여 누구나 쉽게 따라 할 수 있도록 구성했습니다. 이 글을 통해 터미널을 열 때마다 반복되는 환경변수 설정의 번거로움에서 벗어나, 더욱 효율적이고 집중력 있는 개발 환경을 구축할 수 있습니다.

Photo by Marc Mueller on Pexels

zshrc 파일이란 무엇인가?

.zshrc 파일은 Z Shell (zsh)의 설정 파일입니다. Zsh는 Bash와 유사하지만 훨씬 강력하고 유연한 기능을 제공하는 쉘로, macOS Catalina (10.15) 버전부터 기본 쉘로 채택되었습니다. .zshrc 파일은 Zsh 쉘이 시작될 때마다 자동으로 실행되는 스크립트 파일입니다. 따라서 이 파일에 환경변수 설정, 별칭(alias) 정의, 함수 정의, 쉘 프롬프트 커스터마이징 등 다양한 설정을 추가하면, 매번 터미널을 열 때마다 해당 설정이 자동으로 적용됩니다. 이는 개발자들 사이에서 반복적인 작업을 자동화하고 개인화된 개발 환경을 만드는 데 필수적인 요소로 여겨집니다. 예를 들어, 특정 명령어를 짧은 별칭으로 등록하거나, 자주 사용하는 디렉토리로 바로 이동하는 함수를 만드는 등의 작업을 .zshrc 파일에 기록해두면 편리합니다.

이 파일의 가장 중요한 역할 중 하나는 환경변수를 영구적으로 설정하는 것입니다. 환경변수는 운영체제나 특정 프로그램이 필요로 하는 설정값으로, 터미널에서 실행되는 모든 프로세스에 영향을 미칩니다. PATH 변수는 이 중에서도 가장 핵심적인 역할을 합니다. PATH 변수에는 실행 파일이 위치할 수 있는 디렉토리들의 목록이 콜론(:)으로 구분되어 저장됩니다. 터미널에서 명령어를 입력하면 쉘은 PATH 변수에 나열된 디렉토리들을 순서대로 검색하여 해당 명령어를 찾습니다. 만약 PATH에 특정 프로그램의 실행 파일이 있는 디렉토리가 포함되어 있지 않다면, 쉘은 해당 명령어를 찾지 못하고 오류를 발생시킵니다. 따라서 새로운 도구를 설치하거나 개발 환경을 설정할 때 PATH 변수에 해당 디렉토리를 추가하는 것이 필수적입니다.

실제 사용자 경험을 보면, .zshrc 파일은 단순한 설정 파일을 넘어 개발 생산성을 좌우하는 중요한 요소입니다. 한 사용자는 "2. Oh-My-Zsh의 로딩속도가 상당히 느린 편인데 비동기로드(프롬프트 로드 후에 로드)를 해서 빠릅니다 3. 내장된 플러그인과 설정, 유틸리티들 - ZSH에 그치지 않고 CLI 환경전반을 다루려 생각하고 있어요. 4. 간단한 추가 플러그인 사용 추가적인 플러그인을" 이라고 언급하며, .zshrc 파일을 통해 쉘의 성능 개선과 기능 확장이 가능하다는 점을 강조했습니다. (출처: clien.net). 이는 .zshrc 파일이 단순히 환경변수 설정뿐만 아니라, 쉘의 전반적인 성능과 사용성을 향상시키는 핵심 도구임을 보여줍니다. 또한, 다른 사용자는 "맥 터미널에서 기본으로 사용하는 zsh의 설정파일 입니다. 아마 플러터 설치하면서 환경변수를 자동으로 설정했거나 했던거 같은데 그냥 사용하셔도 될 것 같네요 나중에 터미널에서 이상한 동작이 지속되면 그때 설정파일만 교체하시면 될거에요" 라고 말하며, .zshrc 파일이 개발 도구 설치 시 자동으로 설정되는 경우가 많으며, 문제 발생 시 복구의 기준이 될 수도 있음을 시사합니다. (출처: clien.net). 이러한 실제 경험담들은 .zshrc 파일의 중요성과 활용성을 더욱 명확히 보여줍니다.

zshrc 파일을 이용한 환경변수 영구 설정 방법

환경변수를 영구적으로 설정하는 가장 일반적이고 효과적인 방법은 .zshrc 파일을 편집하는 것입니다. 이 파일은 사용자의 홈 디렉토리(~)에 위치하며, 일반적으로 숨김 파일이므로 파일 탐색기에서는 보이지 않을 수 있습니다. 터미널을 열고 다음 명령어를 사용하여 .zshrc 파일을 열 수 있습니다. 사용하는 텍스트 편집기에 따라 명령어는 달라질 수 있습니다. 예를 들어, nano 편집기를 사용한다면 다음과 같습니다.

nano ~/.zshrc

만약 .zshrc 파일이 존재하지 않는다면, 위 명령어를 실행했을 때 파일이 생성되므로 그대로 진행하면 됩니다. nano 편집기 화면이 나타나면, 파일의 가장 아래쪽에 추가하고 싶은 환경변수 설정을 입력합니다. 환경변수를 설정하는 기본적인 문법은 export 키워드를 사용하는 것입니다. 예를 들어, MY_VARIABLE이라는 이름의 환경변수에 my_value라는 값을 할당하고 싶다면 다음과 같이 작성합니다.

export MY_VARIABLE="my_value"

이때 주의할 점은, export 키워드를 사용해야만 해당 변수가 현재 쉘뿐만 아니라 자식 프로세스에서도 사용할 수 있는 환경변수로 설정됩니다. 만약 export 없이 MY_VARIABLE="my_value" 와 같이만 작성하면, 이 변수는 현재 쉘 세션에서만 유효하며 다른 프로세스에서는 접근할 수 없습니다. 따라서 대부분의 환경변수 설정에는 export를 붙이는 것이 일반적입니다. 설정을 마쳤다면, Ctrl + X를 누르고, Y를 눌러 변경 사항을 저장한 후, Enter를 눌러 편집기를 종료합니다.

만약 Oh My Zsh와 같은 Zsh 프레임워크를 사용하고 있다면, .zshrc 파일의 역할이 조금 달라질 수 있습니다. Oh My Zsh는 ~/.zshrc 파일을 로드한 후, 자체적인 설정을 추가하거나 관리합니다. 따라서 Oh My Zsh를 사용하는 경우에도 환경변수 설정은 ~/.zshrc 파일의 기존 내용 아래에 추가하면 됩니다. Oh My Zsh는 플러그인 시스템을 통해 다양한 기능을 쉽게 확장할 수 있는데, 이러한 플러그인들도 종종 환경변수 설정을 요구하거나 자동으로 설정해줍니다. 예를 들어, 특정 플러그인을 활성화하기 위해 plugins=(git docker node) 와 같이 .zshrc 파일 내에서 설정하는 부분이 있습니다. 이러한 프레임워크를 사용하더라도, 사용자 정의 환경변수는 일반적으로 .zshrc 파일의 끝에 명시적으로 추가하는 것이 가장 확실합니다.

설정하려는 환경변수가 여러 개이거나 복잡한 경우, .zshrc 파일에 직접 작성하는 것보다 별도의 설정 파일을 만들고 .zshrc 파일에서 해당 파일을 불러오는 방식을 고려해볼 수 있습니다. 예를 들어, ~/.env_vars 와 같은 파일을 만들고, 그 안에 export MY_VARIABLE="my_value" 와 같은 내용을 작성합니다. 그리고 ~/.zshrc 파일의 마지막 부분에 다음과 같은 줄을 추가합니다.

if [ -f ~/.env_vars ]; then
  source ~/.env_vars
fi

이 방식은 .zshrc 파일을 깔끔하게 유지하면서, 관련 설정을 별도의 파일로 관리하여 가독성과 유지보수성을 높일 수 있다는 장점이 있습니다. 특히, 여러 환경에서 동일한 설정을 공유해야 할 때 유용하게 활용될 수 있습니다. 이 방법을 사용하면 ~/.env_vars 파일에 작성된 모든 export 문이 .zshrc 파일이 로드될 때 함께 실행됩니다.

PATH 환경변수 설정 및 관리

PATH 환경변수는 맥에서 명령어를 실행할 때 시스템이 해당 명령어를 찾는 경로들의 목록입니다. 새로운 개발 도구를 설치하거나 스크립트를 특정 위치에 저장했을 때, 해당 프로그램이나 스크립트를 터미널에서 바로 실행하려면 PATH 변수에 해당 경로를 추가해야 합니다. .zshrc 파일에 PATH 변수를 추가하는 방법은 기존 PATH 변수에 새로운 경로를 덧붙이는 방식입니다. 이는 export PATH="..." 문법을 사용하며, 기존 $PATH 변수의 값을 참조하여 새로운 경로를 추가합니다. 예를 들어, /usr/local/my_tools/bin 이라는 경로를 PATH에 추가하려면 다음과 같이 작성합니다.

export PATH="/usr/local/my_tools/bin:$PATH"

이 코드는 /usr/local/my_tools/bin 디렉토리를 PATH 변수의 맨 앞에 추가합니다. 즉, 쉘이 명령어를 찾을 때 가장 먼저 이 디렉토리를 검색하게 됩니다. 이는 동일한 이름의 명령어가 여러 경로에 존재할 경우, PATH에 먼저 나오는 경로의 명령어가 우선적으로 실행되도록 합니다. 따라서 중요한 것은 PATH에 경로를 추가하는 순서입니다. 일반적으로 /usr/local/bin 과 같은 시스템 기본 경로들은 PATH의 뒤쪽에 위치시키고, 사용자가 직접 설치한 도구들의 경로는 앞에 두는 것이 일반적입니다. 이는 시스템 명령어가 사용자가 설치한 도구의 동일한 이름 명령어로 인해 덮어쓰여지는 것을 방지하기 위함입니다.

Homebrew와 같이 패키지 관리자를 통해 설치한 도구들의 경로는 보통 /usr/local/bin 또는