Homebrew 설치하기

macOS에서 Node.js, Java, Docker 같은 개발 도구를 하나씩 수동으로 설치하고 있다면, 패키지 매니저가 필요합니다.

Homebrew 는 macOS(및 Linux)에서 사용하는 오픈소스 패키지 매니저입니다. 터미널 명령 한 줄로 개발 도구, 라이브러리, 애플리케이션을 설치/업데이트/삭제할 수 있습니다.

Homebrew가 필요한 이유

macOS에는 기본적으로 git, curl 같은 도구가 포함되어 있지만, 개발에 필요한 대부분의 도구(node, python, java, docker 등)는 별도로 설치해야 합니다. Homebrew를 사용하면 다음과 같은 이점이 있습니다.

설치 방법

1. 설치 명령어 실행

Homebrew 공식 사이트에 안내된 설치 스크립트를 터미널에 붙여넣습니다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

** 참고 **: Checking for 'sudo' access (which may request your password) 메시지가 나타나면 macOS 로그인 비밀번호를 입력합니다. 비밀번호 입력 시 화면에 아무것도 표시되지 않는 것은 정상입니다.

2. PATH 환경 변수 설정

설치가 완료되면 터미널에 echo 명령어 두 줄이 표시됩니다. 이 명령어를 그대로 복사하여 실행합니다.

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

** 이 단계가 필요한 이유 **: Apple Silicon(M1/M2) Mac에서 Homebrew는 /opt/homebrew/ 경로에 설치됩니다. 이 경로는 기본 PATH에 포함되어 있지 않기 때문에, 쉘이 시작될 때마다 Homebrew 경로를 자동으로 추가하도록 설정하는 것입니다. Intel Mac의 경우 /usr/local/에 설치되므로 이 단계가 필요하지 않을 수 있습니다.

설치 확인

brew --version

아래와 같이 버전 정보가 출력되면 정상적으로 설치된 것입니다.

Homebrew 4.x.x

자주 사용하는 명령어

문제 해결

brew 명령어를 찾을 수 없는 경우

PATH 설정이 적용되지 않았을 가능성이 높습니다. 터미널을 새로 열거나, 아래 명령어를 직접 실행합니다.

eval "$(/opt/homebrew/bin/brew shellenv)"

그래도 해결되지 않으면 ~/.zprofile 파일에 위 설정이 정상적으로 추가되었는지 확인합니다.

cat ~/.zprofile

주의할 점

Apple Silicon vs Intel Mac 경로 차이

Apple Silicon(M1/M2) Mac에서 Homebrew는 /opt/homebrew/에 설치되지만, Intel Mac에서는 /usr/local/에 설치됩니다. 온라인 가이드를 따라할 때 경로가 다르면 이 차이를 먼저 확인합니다.

PATH 설정을 .zprofile이 아닌 .zshrc에 추가

.zprofile은 로그인 셸에서만 로드되고, .zshrc는 모든 터미널 세션에서 로드됩니다. IDE의 내장 터미널에서 brew를 찾지 못하는 경우, .zshrc에도 설정을 추가해야 할 수 있습니다.

정리