맥에 Homebrew 설치 스크립트를 실행한 후 ‘Next steps’ 메시지를 보고 ‘이게 뭐야, 설치된 건가?’ 싶어 당황하셨나요? 분명 설치가 끝난 것 같은데, 터미널에 익숙하지 않다면 이 메시지가 무엇을 의미하는지 파악하기 어려울 수 있습니다.
이 메시지는 Homebrew의 핵심 기능 중 하나인 ‘환경 변수 설정’이 아직 완료되지 않았음을 뜻하며, 이 설정을 마무리해야 Homebrew를 정상적으로 사용할 수 있습니다.
이 글에서는 ‘Next steps’ 메시지의 정확한 의미부터, 단 3단계로 환경 변수를 완벽히 설정하고 Homebrew를 활용하는 필수 명령어까지 모두 알려드려 여러분의 개발 환경 설정을 쾌적하게 만들어 드릴 것입니다.
– ‘Next steps’는 Homebrew가 정상적으로 작동하기 위한 환경 변수 설정을 안내하는 메시지입니다.
– 터미널 명령어를 통해 지정된 경로를 PATH 환경 변수에 추가하면 Homebrew 설치가 최종 완료됩니다.
– Homebrew는 brew install, brew update, brew upgrade 등 몇 가지 핵심 명령어로 쉽게 관리할 수 있습니다.
맥 Homebrew 설치 후 나타나는 ‘Next steps’ 메시지 해결 방법부터 필수 경로 설정, 패키지 사용법까지 총정리했습니다.
‘Next steps’ 메시지, 진짜 의미는 무엇인가요?
Homebrew 설치 스크립트를 실행하면 대부분의 파일은 이미 여러분의 맥에 성공적으로 복사됩니다. 하지만 터미널에서 brew 명령어를 인식하고 실행하려면 운영체제가 해당 명령어가 어디에 있는지 알아야 합니다. 이 정보를 알려주는 것이 바로 ‘환경 변수(PATH)’입니다.
‘Next steps’ 메시지는 Homebrew 실행 파일의 경로를 시스템의 PATH 환경 변수에 추가하라는 안내입니다. 이 과정을 생략하면 설치는 되었지만 터미널이 brew 명령어를 찾지 못해 ‘command not found’ 오류가 발생할 수 있습니다.
이 과정은 마치 새로 지은 집의 주소를 내비게이션에 등록하는 것과 같습니다. 주소 등록이 끝나야 목적지까지 헤매지 않고 찾아갈 수 있겠죠. Homebrew도 마찬가지로 이 환경 변수 설정을 통해 비로소 맥 환경에서 온전히 제 기능을 발휘하게 됩니다.
‘Next steps’ 메시지에 나오는 경로는 맥의 프로세서(Intel 또는 Apple Silicon)나 macOS 버전에 따라 조금씩 다를 수 있습니다. 반드시 여러분의 터미널에 출력된 경로를 정확히 확인하고 사용해야 합니다.
Homebrew 환경 변수 설정, 30초면 충분합니다
‘Next steps’ 메시지에 당황하셨겠지만, 이 설정은 생각보다 훨씬 간단합니다. 터미널에 몇 가지 명령어를 입력하는 것만으로 30초 안에 이 문제를 해결할 수 있습니다. 아래 단계를 따라 Homebrew 환경 변수를 완벽하게 설정해 보세요.
참고로, 최근 macOS는 기본 셸로 Bash 대신 Zsh를 사용합니다. 따라서 주로 .zshrc 파일을 수정하게 됩니다. Bash를 사용한다면 .bash_profile 또는 .bashrc 파일을 확인하시면 됩니다.
- 셸 설정 파일 확인 및 열기 — 먼저 현재 사용 중인 셸의 설정 파일을 확인하고 편집기로 엽니다. 대부분의 경우 Zsh를 사용하므로
open ~/.zshrc명령어를 사용하면 됩니다. 만약 파일이 없다고 나오면touch ~/.zshrc로 파일을 생성한 뒤 다시 열어줍니다. - PATH 환경 변수 추가 — ‘Next steps’ 메시지에 나온
eval "$(홈브루 경로 --prefix)/bin/brew shellenv)"와 유사한 명령어를 복사하여 설정 파일의 맨 아래에 붙여넣고 저장합니다. 경로는 맥 환경에 따라/opt/homebrew/bin/brew또는/usr/local/bin/brew등으로 다를 수 있으니, 여러분의 터미널에 나온 정확한 경로를 사용해야 합니다. - 셸 설정 파일 적용 — 변경된 설정 파일을 현재 터미널 세션에 적용하기 위해
source ~/.zshrc(Zsh의 경우) 또는source ~/.bash_profile(Bash의 경우) 명령어를 입력합니다. 이제brew help를 입력했을 때 정상적인 도움말이 나오면 설정이 완료된 것입니다.
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc와 같이 경로를 직접 파일에 추가하는 명령어를 사용할 수도 있습니다. 이 방법은 파일을 열지 않고 한 번에 처리할 수 있어 편리합니다. 이 경로는 Apple Silicon 맥 기준입니다. Intel 맥 사용자는 /usr/local/bin/brew 경로를 확인해야 합니다.
Photo by Jakub Zerdzicki on Pexels
이제 시작! Homebrew 필수 명령어 5가지
환경 변수 설정이 완료되었다면, 이제 Homebrew를 활용하여 개발 환경을 풍성하게 만들 시간입니다. Homebrew는 수천 가지의 유용한 개발 도구와 유틸리티를 손쉽게 설치하고 관리할 수 있게 해줍니다. 여기 가장 많이 사용되는 필수 명령어 5가지를 소개합니다.
이 명령어들은 여러분의 개발 생산성을 획기적으로 향상시켜 줄 것입니다. 터미널에 직접 입력하며 각 기능들을 익혀보세요.
- 소프트웨어 설치:
brew install [패키지명]— 예를 들어, 이미지 처리 도구인 ImageMagick을 설치하려면brew install imagemagick을 입력합니다. Homebrew가 자동으로 의존성을 해결하며 설치를 진행합니다. - 설치된 소프트웨어 검색:
brew search [검색어]— 설치하려는 소프트웨어의 정확한 이름을 모를 때 사용합니다.brew search git과 같이 입력하면 Git과 관련된 다양한 패키지를 찾아줍니다. - Homebrew 및 패키지 업데이트:
brew update&brew upgrade—brew update는 Homebrew 자체를 최신 버전으로 업데이트하고,brew upgrade는 Homebrew로 설치된 모든 패키지를 최신 버전으로 업데이트합니다. 정기적으로 실행하여 보안 및 기능 개선을 적용하는 것이 좋습니다. - 설치된 소프트웨어 정보 확인:
brew info [패키지명]— 특정 패키지의 버전, 설치 경로, 의존성 등 자세한 정보를 알고 싶을 때 사용합니다.brew info node와 같이 입력합니다. - 소프트웨어 삭제:
brew uninstall [패키지명]— 더 이상 필요 없는 소프트웨어를 삭제할 때 사용합니다. 예를 들어, Node.js를 삭제하려면brew uninstall node를 입력합니다. 관련 의존성은brew autoremove로 정리할 수 있습니다.
맥 Homebrew 설치 후 ‘Next steps’ 메시지는 환경 변수 설정을 통해 Homebrew 명령어를 시스템에 인식시키라는 중요한 안내입니다. 터미널에 표시된 경로를 정확히 확인하고 셸 설정 파일(예: .zshrc)에 추가한 뒤, source 명령어로 적용하면 설치가 최종적으로 완료됩니다.
이후에는 brew install, brew update, brew upgrade 등 몇 가지 핵심 명령어로 맥 개발 환경을 매우 효율적으로 관리할 수 있습니다.
지금 바로 적용해 보세요.
- Homebrew 공식 웹사이트 — Homebrew의 모든 정보와 최신 설치 방법, 문서 등을 확인할 수 있습니다.
- Homebrew Installation Documentation — 공식 설치 가이드에서 ‘Next steps’를 포함한 상세한 설치 과정을 볼 수 있습니다.
동영상으로 보는 맥 Homebrew 설치 후 Next steps 해결
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. 맥 Homebrew 설치 후 ‘Next steps’ 메시지는 정확히 무엇을 의미하나요?
A. ‘Next steps’ 메시지는 Homebrew가 설치된 후, 사용자의 셸 환경(Bash, Zsh 등)이 Homebrew 명령어를 인식할 수 있도록 `PATH` 변수를 설정하는 방법을 안내하는 것입니다. 이는 Homebrew의 실행 파일 경로를 시스템에 알려주는 필수적인 과정입니다. 오류 메시지가 아니라, 설치를 완료하기 위한 중요한 지시사항입니다.
Q. Next steps에서 제시하는 `echo` 및 `eval` 또는 `source` 명령어를 반드시 실행해야 하나요?
A. 네, 반드시 실행하는 것이 좋습니다. 이 명령어들은 Homebrew가 설치된 경로를 사용자 셸의 환경 변수(`PATH`)에 추가하거나, 관련 설정 파일을 불러와 셸이 `brew` 명령어를 인식하고 실행할 수 있도록 해줍니다. 이 과정을 건너뛰면 `brew: command not found`와 같은 오류가 발생할 수 있습니다.
Q. Next steps를 완료한 후, Homebrew가 제대로 설치되었는지 어떻게 확인할 수 있나요?
A. ‘Next steps’에서 안내한 명령어를 실행한 후, 새 터미널 창을 열고 `brew –version`을 입력해보세요. Homebrew의 버전 정보가 출력되면 정상적으로 설치 및 설정이 완료된 것입니다. 추가적으로 `brew doctor` 명령어를 실행하여 설치 환경에 문제가 없는지 진단해볼 수도 있습니다.
Q. Homebrew 설치 완료 후 가장 기본적으로 알아야 할 필수 명령어는 무엇인가요?
A. 가장 중요한 명령어는 소프트웨어를 설치하는 `brew install [패키지명]`과 설치된 소프트웨어를 업데이트하는 `brew upgrade`입니다. Homebrew 자체를 최신 상태로 유지하려면 `brew update`를 사용하며, 설치된 목록을 보려면 `brew list`, 소프트웨어를 삭제하려면 `brew uninstall [패키지명]`을 사용합니다.
함께 읽으면 좋은 글