맥에 Homebrew를 설치하려고 터미널 명령어를 입력했는데 에러가 뜨거나, 분명 설치는 완료했는데 ‘brew’ 명령어가 작동하지 않아 답답하셨을 겁니다. 이는 주로 환경 변수 설정 문제나 설치 과정 중 발생한 작은 오류 때문입니다.
이 글에서는 Homebrew를 깔끔하게 설치하고, 흔히 발생하는 에러들을 단계별로 해결하며, 제대로 활용하는 필수 팁까지 알려드립니다.
– 맥 Homebrew 설치 시 권한 및 환경 변수 PATH 오류 해결
– ‘brew’ 명령어 인식 못 할 때 셸 설정 변경 및 터미널 재시작
– Homebrew 핵심 명령어 5가지와 효율적인 관리 방법
맥 Homebrew 설치 후 명령어 에러는 PATH 설정 문제일 수 있으며, 이 글에서 해결법과 필수 사용법을 정리했습니다.
Homebrew 설치, 에러 없이 시작하기
맥에서 Homebrew는 개발자들에게 필수적인 패키지 관리 도구입니다. 복잡한 설치 과정 없이 원하는 프로그램을 터미널 명령 한 줄로 쉽게 설치하고 관리할 수 있게 돕습니다. 하지만 처음 설치할 때 예상치 못한 에러에 부딪히면 당황스럽기 마련입니다.
설치 명령어는 간단하지만, 시스템 환경에 따라 권한 문제나 Xcode Command Line Tools 미설치 등으로 인해 오류가 발생할 수 있습니다. 다음 단계에 따라 Homebrew를 안전하고 정확하게 설치해 보세요.
- Xcode Command Line Tools 설치 확인 — 터미널에
xcode-select --install을 입력하여 설치 여부를 확인하거나, 필요한 경우 설치를 진행합니다. 이 도구는 Homebrew 작동에 필수적인 구성 요소들을 제공합니다. - 공식 설치 명령어 사용 — Homebrew 공식 웹사이트에서 제공하는
'/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"'명령어를 터미널에 복사하여 실행합니다. 설치 중sudo비밀번호를 요청할 수 있으니, 맥 로그인 비밀번호를 입력하면 됩니다. - 설치 스크립트 진행 확인 — 설치 스크립트가 실행되면 필요한 파일들을 다운로드하고 설정합니다. 약 3~5분 정도 소요될 수 있으며, 설치 완료 메시지가 나타나는지 확인합니다.
Photo by panumas nikhomkhai on Pexels
‘brew’ 명령어가 먹통일 때? PATH 설정 점검
Homebrew 설치를 성공적으로 마쳤는데도 터미널에서 brew 명령어를 인식하지 못하는 경우가 있습니다. 이는 대부분 시스템의 PATH 환경 변수에 Homebrew의 실행 파일 경로가 제대로 등록되지 않았기 때문입니다. PATH는 셸이 명령어를 찾을 때 검색하는 디렉토리 목록을 의미합니다.
이 문제를 해결하려면 Homebrew가 설치된 경로를 셸이 인식할 수 있도록 PATH에 추가해야 합니다. 최신 macOS에서는 기본 셸이 zsh인 경우가 많으며, 이전 버전에서는 bash를 사용합니다. 자신의 셸에 맞는 설정 파일을 수정해야 합니다.
셸 설정 파일을 수정한 후에는 반드시 새 터미널 창을 열거나,
source ~/.zshrc 또는 source ~/.bash_profile 명령어를 실행하여 변경사항을 즉시 적용해야 합니다. 이 과정을 생략하면 ‘brew’ 명령어를 여전히 인식하지 못할 수 있습니다.
- Homebrew 설치 경로 확인 — 일반적으로 Homebrew는
/opt/homebrew(Apple Silicon) 또는/usr/local/homebrew(Intel Mac)에 설치됩니다. 설치 완료 시 터미널에 해당 경로가 안내됩니다. - 셸 설정 파일 열기 — 사용하는 셸에 따라
~/.zshrc(Zsh) 또는~/.bash_profile(Bash) 파일을 텍스트 편집기로 엽니다. 예를 들어,nano ~/.zshrc명령어를 사용할 수 있습니다. - PATH 환경 변수 추가 — 파일 하단에
export PATH="/opt/homebrew/bin:$PATH"(Apple Silicon) 또는export PATH="/usr/local/bin:$PATH"(Intel Mac) 와 같은 줄을 추가합니다. 자신의 Homebrew 설치 경로에 맞게 수정해야 합니다. - 변경사항 적용 및 확인 — 파일을 저장하고 닫은 후, 터미널을 완전히 종료했다가 다시 시작하거나,
source명령어를 실행합니다. 그 다음brew --version을 입력하여 Homebrew 버전 정보가 제대로 출력되는지 확인합니다.
Homebrew 핵심 명령어, 이것만 알면 충분합니다
Homebrew 설치와 에러 해결을 마쳤다면, 이제 본격적으로 Homebrew를 활용할 차례입니다. Homebrew는 수많은 유틸리티와 프로그램을 단 몇 초 만에 설치하고 관리할 수 있게 해줍니다. 기본적인 명령어들을 익히면 개발 환경을 훨씬 효율적으로 구축하고 유지할 수 있습니다.
여기서는 개발 과정에서 가장 자주 사용하게 될 Homebrew 명령어 5가지를 소개합니다. 이 명령어들만으로도 대부분의 작업을 수행할 수 있으며, 필요에 따라 더욱 다양한 명령어를 공식 문서에서 찾아볼 수 있습니다.
| 명령어 | 기능 | 예시 |
|---|---|---|
brew install [패키지명] |
새로운 패키지를 설치합니다. | brew install git |
brew update |
Homebrew 자체와 패키지 목록을 최신 상태로 업데이트합니다. | brew update |
brew upgrade |
설치된 모든 패키지를 최신 버전으로 업그레이드합니다. | brew upgrade |
brew search [검색어] |
설치 가능한 패키지를 검색합니다. | brew search node |
brew uninstall [패키지명] |
설치된 패키지를 삭제합니다. | brew uninstall git |
정기적으로
brew update와 brew upgrade를 실행하는 것이 좋습니다. 이를 통해 설치된 패키지들을 최신 상태로 유지하고, 보안 취약점 패치나 새로운 기능을 즉시 적용할 수 있습니다. 한 달에 한 번 정도 실행하면 쾌적한 개발 환경을 유지할 수 있습니다.
지금까지 맥에서 Homebrew 설치 시 발생할 수 있는 에러를 해결하고, 기본 사용법과 핵심 명령어를 익히는 방법을 자세히 알아봤습니다. PATH 환경 변수 설정만 제대로 한다면, 90% 이상의 Homebrew 관련 문제를 해결할 수 있습니다. 이제 Homebrew를 통해 필요한 모든 개발 도구를 손쉽게 관리하며 생산성을 크게 높일 수 있을 겁니다.
지금 바로 적용해 보세요.
- Homebrew 공식 웹사이트 — Homebrew의 최신 설치 명령어, 문서, 그리고 더 많은 고급 사용법을 확인할 수 있습니다.
동영상으로 보는 맥 Homebrew 설치 오류 해결 사용법
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. Homebrew 설치 후 ‘brew: command not found’ 에러가 발생해요. 어떻게 해결하나요?
A. 이 에러는 Homebrew의 실행 경로가 시스템 PATH에 올바르게 추가되지 않았을 때 발생합니다. 보통 터미널 설정 파일(.zshrc 또는 .bash_profile)에 Homebrew 경로를 추가하고 터미널을 재시작하면 해결됩니다. 설치 시 Homebrew가 제안하는 명령어를 참고하여 PATH를 설정해주세요.
Q. Homebrew로 새로운 프로그램을 설치하고 싶어요. 어떻게 해야 하나요?
A. Homebrew로 프로그램을 설치하려면 `brew install [패키지명]` 명령어를 사용하면 됩니다. 예를 들어, `wget`을 설치하고 싶다면 터미널에 `brew install wget`을 입력하고 엔터를 누르면 됩니다. 설치하려는 패키지명을 정확히 아는 것이 중요합니다.
Q. 설치된 Homebrew나 패키지들을 최신 상태로 유지하려면 어떻게 해야 하나요?
A. Homebrew 자체를 최신 상태로 만들려면 `brew update`를 실행하고, 이어서 설치된 모든 패키지를 업데이트하려면 `brew upgrade` 명령어를 사용합니다. `update`는 Homebrew의 패키지 정의 파일을, `upgrade`는 실제 설치된 프로그램들을 최신 버전으로 업데이트합니다.
Q. `brew doctor`는 어떤 명령어이고 언제 사용해야 하나요?
A. `brew doctor`는 Homebrew 설치에 문제가 없는지 진단하고 잠재적인 문제나 권장 사항을 알려주는 명령어입니다. 어떤 에러가 발생했을 때 이 명령어를 먼저 실행하여 문제의 원인을 파악하고 해결 방법을 찾는 데 유용합니다. 녹색으로 ‘Your system is ready to brew.’ 메시지가 나오면 정상입니다.
함께 읽으면 좋은 글