맥 Homebrew 설치 명령어를 입력했는데 비밀번호를 넣어도 화면에 아무것도 뜨지 않거나, 설치 완료 후 터미널에 ‘brew’ 명령어가 인식되지 않아 답답하셨나요? 이는 설치 스크립트 실행 과정이나 시스템 PATH 환경 변수 설정에서 흔히 겪는 일입니다.
당황스러웠던 그 순간을 깔끔하게 해결해 줄 이 글에서는 Homebrew를 완벽하게 설치하고, 기본적인 패키지 관리부터 발생 가능한 문제 해결까지, 개발자 필수 도구인 Homebrew를 100% 활용하는 방법을 알려드립니다.
– Homebrew 설치 시 화면 무반응 및 명령어 미인식 문제 해결법
– 패키지 설치, 업데이트, 삭제 등 3가지 핵심 명령어 사용법
– Homebrew를 활용한 개발 환경 효율적으로 관리하는 노하우
맥 Homebrew 설치를 완료하고, `brew install`, `update`, `upgrade` 등 핵심 패키지 사용법을 한 번에 정리합니다.
Homebrew, 왜 맥 개발자의 필수 도구일까요?
Homebrew는 맥OS용 패키지 관리자로, 복잡한 설치 과정 없이 원하는 소프트웨어(패키지)를 터미널에서 간단한 명령어로 설치하고 관리할 수 있게 해줍니다. 개발자에게 필요한 수많은 도구들, 예를 들어 Python, Node.js, Git, Docker 등을 몇 초 만에 설치할 수 있어 개발 환경 설정 시간을 획기적으로 줄여줍니다.
맥 환경에서 개발을 시작하거나 기존 환경을 효율적으로 관리하고 싶다면 Homebrew는 선택이 아닌 필수입니다. 수동으로 다운로드하고 의존성을 해결하던 번거로운 과정에서 벗어나, 필요한 도구를 언제든 쉽게 설치하고 최신 상태로 유지할 수 있게 됩니다. 현재 80,000개 이상의 다양한 패키지를 지원하며, 전 세계 수백만 개발자들이 애용하고 있습니다.
Homebrew는 일반 응용 프로그램뿐만 아니라, GUI 애플리케이션(크롬, VS Code 등)을 설치할 수 있는 ‘Cask’ 기능도 제공하여 더욱 편리합니다.
Photo by Ruben Boekeloo on Pexels
Homebrew 설치, 문제없이 마무리하는 3단계
Homebrew 설치는 대개 간단하지만, 간혹 독자님처럼 설치 과정에서 화면에 아무것도 뜨지 않거나 설치 후에도 명령어가 인식되지 않는 경우가 발생합니다. 이는 대부분 설치 스크립트가 백그라운드에서 동작 중이거나, 시스템 PATH 설정이 자동으로 적용되지 않아 생기는 문제입니다. 다음 3단계로 완벽하게 설치를 완료해 보세요.
- 설치 스크립트 실행 — 터미널(Terminal)을 열고 아래 명령어를 붙여넣은 후 엔터를 누르세요. 비밀번호를 입력하라는 메시지가 뜨면 입력하고 엔터를 누릅니다. 이때 화면에 아무것도 뜨지 않더라도 당황하지 마세요. 백그라운드에서 설치 파일들을 다운로드하고 있는 중이며, 보통 3분에서 5분 정도 소요됩니다. 완료되면 “Installation successful!”과 같은 메시지가 나타납니다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - PATH 환경 변수 설정 확인 — 설치가 완료되면 터미널에 Homebrew PATH 설정을 추가하라는 메시지가 나타납니다. 보통 `echo ‘eval “$(/opt/homebrew/bin/brew shellenv)”‘`와 `eval “$(/opt/homebrew/bin/brew shellenv)”` 두 줄의 명령어를 복사하여 실행하라고 안내합니다. 해당 명령어를 차례로 실행하여 PATH를 설정해 줍니다.
- 터미널 재시작 및 brew 명령어 테스트 — PATH 설정까지 마쳤다면, 현재 터미널 창을 닫고 새로 터미널을 열어주세요. 그리고 `brew –version` 명령어를 입력했을 때 Homebrew 버전 정보가 정상적으로 출력된다면 설치가 성공적으로 마무리된 것입니다.
설치 완료 후 PATH 설정을 안내하는 메시지를 반드시 복사하여 실행해야 합니다. 이를 건너뛰면 ‘brew’ 명령어를 찾을 수 없다는 오류가 계속 발생합니다. Mac M1/M2(Apple Silicon)의 경우 `/opt/homebrew/bin` 경로를, Intel Mac의 경우 `/usr/local/bin` 경로를 PATH에 추가하라고 안내합니다.
핵심! Homebrew 패키지 관리 명령어 사용법
Homebrew 설치가 완료되었다면 이제 개발에 필요한 다양한 도구들을 자유롭게 설치하고 관리할 차례입니다. 기본적인 명령어만 알아도 Homebrew의 90% 이상을 활용할 수 있습니다. 가장 많이 사용되는 5가지 핵심 명령어를 숙지해 보세요.
Homebrew는 ‘ formulae ‘라는 공식 패키지 목록을 통해 터미널용 도구들을 관리하며, ‘ Casks ‘를 통해 GUI 애플리케이션들을 관리합니다. 사용법은 거의 동일하지만, 명령어 구문에 약간의 차이가 있습니다. 아래 표에서 주요 명령어들을 비교해 볼 수 있습니다.
| 구분 | Formulae (CLI 도구) | Casks (GUI 앱) |
|---|---|---|
| 설치 | `brew install [패키지명]` (예: `brew install git`) | `brew install –cask [앱명]` (예: `brew install –cask visual-studio-code`) |
| 업데이트 | `brew upgrade [패키지명]` (전체: `brew upgrade`) | `brew upgrade –cask [앱명]` (전체: `brew upgrade –cask`) |
| 검색 | `brew search [검색어]` | `brew search [검색어]` (Cask 포함 검색) |
| 설치된 목록 | `brew list` | `brew list –cask` |
| 삭제 | `brew uninstall [패키지명]` | `brew uninstall –cask [앱명]` |
Homebrew 사용 중 자주 묻는 질문과 해결 팁
Homebrew는 안정적이지만, 때로는 시스템과의 충돌이나 설정 오류로 인해 문제가 발생할 수 있습니다. 몇 가지 유용한 명령어와 팁을 통해 이러한 상황에 대처하고 Homebrew를 더욱 효율적으로 관리할 수 있습니다.
가장 먼저 기억해야 할 명령어는 `brew doctor`입니다. 이 명령어는 Homebrew 설치 상태를 진단하고 잠재적인 문제를 알려주며, 해결 방법을 제시해 줍니다. 90% 이상의 일반적인 문제는 `brew doctor`가 안내하는 대로 따라 하면 해결됩니다.
주기적으로 `brew update`와 `brew upgrade` 명령어를 실행하여 Homebrew 자체와 설치된 모든 패키지를 최신 상태로 유지하는 것이 좋습니다. 또한, `brew cleanup` 명령어를 사용하여 더 이상 필요 없는 이전 버전의 패키지 파일들을 삭제하여 디스크 공간을 확보할 수 있습니다.
백그라운드에서 실행되는 서비스(예: MySQL, Redis)를 관리해야 한다면 `brew services` 명령어를 활용하세요. `brew services start [서비스명]`, `brew services stop [서비스명]`, `brew services list`와 같은 명령어로 시스템 시작 시 서비스 자동 실행 설정 및 관리까지 가능합니다. 개발 환경을 더욱 편리하게 구축하는 데 큰 도움이 될 것입니다.
Homebrew 설치 중 겪을 수 있는 문제들을 해결하고, 필수적인 패키지 관리 명령어를 익혔습니다. `brew install`, `brew upgrade`, `brew uninstall` 등 5가지 핵심 명령어로 효율적인 개발 환경을 구축할 수 있습니다. 또한 `brew doctor`와 `brew services`를 활용하여 Homebrew를 더욱 안정적이고 편리하게 관리하는 팁까지 알아보았습니다.
지금 바로 적용해 보세요.
- Homebrew 공식 웹사이트 — Homebrew의 모든 공식 문서를 확인할 수 있습니다.
- Homebrew Manpage — Homebrew 명령어에 대한 상세한 사용법이 정리되어 있습니다.
동영상으로 보는 맥 Homebrew 설치 후 필수 사용법
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. Homebrew로 설치할 수 있는 패키지를 어떻게 검색하나요?
A. `brew search [검색어]` 명령어를 터미널에 입력하여 원하는 패키지를 찾을 수 있습니다. 이 명령은 공식 Homebrew 저장소에 등록된 모든 패키지 중에서 검색어와 일치하거나 유사한 패키지 목록을 보여줍니다.
Q. 원하는 패키지를 찾았다면 어떻게 설치하나요?
A. `brew install [패키지_이름]` 명령어를 사용해 패키지를 설치할 수 있습니다. 예를 들어, `brew install git`이라고 입력하면 Git을 설치할 수 있으며, 설치 과정에서 필요한 의존성 파일들도 자동으로 함께 설치됩니다.
Q. 이미 설치된 패키지들을 최신 버전으로 업데이트하려면 어떻게 해야 하나요?
A. 먼저 `brew update` 명령어로 Homebrew 자체와 패키지 저장소 정보를 최신으로 갱신합니다. 그 후 `brew upgrade` 명령어를 실행하면 설치된 모든 패키지들을 최신 버전으로 한 번에 업데이트할 수 있습니다.
Q. 더 이상 사용하지 않는 패키지는 어떻게 삭제하나요?
A. `brew uninstall [패키지_이름]` 명령어를 사용하여 특정 패키지를 쉽게 제거할 수 있습니다. 패키지 제거 후, `brew cleanup` 명령어를 실행하면 더 이상 필요 없는 오래된 파일이나 링크들을 정리하여 디스크 공간을 확보할 수 있습니다.
📚 함께 읽으면 좋은 글
