Homebrew 설치와 완벽한 개발 환경 구축

작성자:

새로운 맥(Mac)을 손에 넣는 것은 개발자에게 가장 설레는 순간 중 하나입니다. 하지만 순정 상태의 macOS는 개발을 위한 ‘준비물’이 완벽히 갖춰진 상태는 아닙니다. 효율적이고 쾌적한 개발 경험을 위해서는 시스템의 뼈대를 잡는 과정이 필수적이며, 많은 개발자들이 이 과정에서 homebrew를 먼저 설치합니다. 특히 개발 환경 구축의 첫 단계에서 homebrew가 중요한 역할을 합니다.

단순히 몇 개의 앱을 설치하는 것을 넘어, 터미널 기반의 워크플로우를 구축하고 패키지 관리 시스템을 정립하는 것이 핵심입니다. 본 가이드에서는 20년 경력의 노하우를 바탕으로, Homebrew 설치부터 쉘 최적화, 언어별 런타임 관리까지 이어지는 ‘전문가급 개발 환경 구축’ 프로세스를 상세히 다룹니다.

1. 첫 단추: 시스템 업데이트 및 개발자 도구 준비

가장 먼저 수행해야 할 작업은 운영체제를 최신 상태로 유지하고, 애플의 기본적인 명령줄 도구를 설치하는 것입니다.

macOS 소프트웨어 업데이트

설정 과정에서 발생할 수 있는 호환성 문제를 방지하기 위해 [시스템 설정] > [일반] > [소프트웨어 업데이트]에서 최신 버전의 macOS를 실행 중인지 확인하십시오.

Xcode 명령줄 도구(Command Line Tools) 설치

Homebrew를 포함한 대부분의 개발 도구는 Xcode 명령줄 도구에 의존합니다. 전체 Xcode 앱(수십 GB)을 설치할 필요 없이, 터미널(Terminal)을 열고 다음 명령어를 입력하여 필수 도구만 가볍게 설치할 수 있습니다.

Bash

xcode-select --install

2. 맥 개발의 심장: Homebrew 설치와 활용

Homebrew는 macOS용 미 패키지 관리자(The Missing Package Manager)로 불립니다. 터미널 명령어 한 줄로 수천 개의 오픈소스 라이브러리와 애플리케이션을 설치, 업데이트, 관리할 수 있게 해줍니다.

Homebrew 설치 프로세스

공식 설치 스크립트를 사용하여 설치를 진행합니다.

  1. 터미널에 다음 스크립트를 복사하여 붙여넣습니다.Bash/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  2. 설치 완료 후, 터미널 창에 나타나는 ‘Next steps’ 안내를 반드시 확인하십시오. 특히 Apple Silicon(M1, M2, M3 등) 맥 사용자는 zprofile에 Homebrew 경로를 추가하는 과정을 거쳐야 brew 명령어가 활성화됩니다.

Homebrew 필수 명령어 익히기

  • brew 보관(install) [패키지명]: 새로운 도구 설치
  • brew 업데이트(update): Homebrew 자체 및 레시피 업데이트
  • brew 업그레이드(upgrade): 설치된 패키지들을 최신 버전으로 갱신
  • brew 청소(cleanup): 불필요한 구버전 파일 삭제

3. 터미널 환경 최적화: iTerm2와 Oh My Zsh

개발자는 하루 중 상당 시간을 터미널에서 보냅니다. 기본 터미널보다 강력한 기능을 제공하는 iTerm2와 쉘의 가독성을 높여주는 Oh My Zsh는 생산성의 필수 요소입니다.

iTerm2: 기본 터미널의 대체제

iTerm2는 화면 분할, 텍스트 검색, 단축키 커스텀 등 강력한 기능을 지원합니다. Homebrew를 통해 즉시 설치할 수 있습니다.

Bash

brew install --cask iterm2

Zsh와 Oh My Zsh 설정

macOS의 기본 쉘인 Zsh를 더욱 강력하게 만들어주는 프레임워크인 Oh My Zsh를 설치합니다.

Bash

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

생산성을 높이는 플러그인 추천

.zshrc 파일의 플러그인 섹션에 다음 두 가지를 추가하는 것을 강력히 추천합니다.

  1. zsh-autosuggestions: 과거 입력했던 명령어를 기반으로 자동 완성을 제안합니다.
  2. zsh-syntax-highlighting: 유효한 명령어인지 색상으로 즉시 알려줍니다.

4. 런타임 관리의 정석: asdf 또는 SDKMAN

프로젝트마다 요구하는 언어(Python, Node.js, Java 등)의 버전이 다를 수 있습니다. 시스템에 전역적으로 언어를 설치하는 대신, 버전 관리 도구를 사용하는 것이 유지보수 측면에서 매우 유리합니다.

asdf: 모든 언어를 아우르는 관리자

과거에는 nvm(Node), pyenv(Python), rbenv(Ruby) 등을 개별적으로 설치했으나, 최근 트렌드는 asdf 하나로 모든 언어 버전을 통합 관리하는 것입니다.

Bash

brew install asdf

asdf를 통해 필요한 플러그인을 추가하고 프로젝트별로 .tool-versions 파일을 만들어 팀원들과 동일한 개발 환경을 공유하십시오.

5. 필수 애플리케이션 및 개발 도구 자동화

Homebrew의 Cask 기능을 활용하면 GUI 기반 애플리케이션도 명령어로 일괄 설치할 수 있습니다. 이는 새로운 맥을 세팅할 때 시간을 극적으로 단축해 줍니다.

추천 Cask 리스트

Bash

# 브라우저 및 커뮤니케이션
brew install --cask google-chrome slack discord zoom

# 코드 에디터 및 도구
brew install --cask visual-studio-code dbeaver postman docker

# 유틸리티
brew install --cask rectangle(화면 분할) hiddenbar(메뉴바 정리)

Brewfile 활용하기

설치한 모든 내역을 Brewfile로 저장해 두면, 나중에 다른 맥에서도 brew bundle 명령어 하나로 동일한 환경을 100% 복구할 수 있습니다.

6. 지속 가능한 개발 환경 유지하기

완벽한 설정보다 중요한 것은 ‘깨끗한 상태를 유지하는 것’입니다. 시스템 전역에 직접 라이브러리를 설치하는 것을 지양하고, 가급적 Homebrew와 버전 관리 도구를 통해 격리된 환경을 구축하십시오.

정기적으로 brew cleanup을 수행하여 저장 공간을 확보하고, 사용하지 않는 패키지는 즉시 삭제하는 습관이 맥의 성능을 오랫동안 유지하는 비결입니다. 이제 구축된 강력한 환경을 바탕으로 위대한 소프트웨어를 만드는 일에만 집중하십시오.

FAQ

Q1. Apple Silicon(M 시리즈) 맥에서 인텔용 앱을 실행할 수 있나요?

A1. 네, Rosetta 2가 자동으로 설치되어 대부분의 인텔 기반 앱을 실행할 수 있습니다. 하지만 성능 최적화를 위해 가급적 ‘Apple Silicon’ 전용 또는 ‘Universal’ 버전의 설치 파일을 확인하는 것이 좋습니다.

Q2. Homebrew 설치 중 ‘Permission Denied’ 오류가 발생합니다.

A2. 대개는 권한 문제입니다. 명령 앞에 sudo를 붙이기보다는, Homebrew가 권장하는 /opt/homebrew 경로(M 시리즈 기준)에 정상적으로 권한이 설정되었는지 확인하고 안내되는 스크립트를 다시 실행하십시오.

Q3. iTerm2와 VS Code 중 어디서 터미널을 써야 하나요?

A3. 전체적인 시스템 설정이나 서버 관리는 iTerm2가 유리하며, 특정 프로젝트의 코드 작성 중 발생하는 빠른 명령 실행은 VS Code 내장 터미널이 효율적입니다. 두 환경의 프로필(테마, 폰트)을 동일하게 맞추는 것을 추천합니다.

Q4. 환경 변수 설정(PATH)이 자꾸 풀려요.

A4. macOS는 Zsh가 기본이므로 .bash_profile이 아닌 .zshrc 또는 .zprofile 파일에 환경 변수를 기록해야 합니다. 수정 후에는 반드시 source ~/.zshrc를 입력하여 즉시 반영하십시오.

Q5. 맥북 용량이 부족한데 개발 환경이 너무 무겁지 않을까요?

A5. Docker 이미지나 오래된 라이브러리 캐시가 주범인 경우가 많습니다. docker system prune 명령어와 Homebrew의 cleanup 기능을 주기적으로 사용하면 수십 GB의 용량을 확보할 수 있습니다.

윈도우 사용자를 위한 mac 사용법

1. macOS 인터페이스 & 기본 조작법

2. 파일 관리 및 생산성 향상

3. macOS 시스템 설정 및 최적화

4. macOS 소프트웨어 및 생태계

5. Trouble Shooting