Mac에서 brew cleanup과 autoremove로 Homebrew 정리하기

Homebrew는 예전보다 이전 버전과 캐시된 다운로드를 더 적극적으로 관리합니다. 자동 정리가 꺼져 있지 않다면, 설치와 업그레이드가 해당 formula를 정리하고, Homebrew는 주기적으로 모든 formula를 정리합니다. 오래 사용한 설치 환경에도 다운로드, 고정(pinned) 버전, 빌드 산출물, 의존성이 쌓일 수 있습니다. prefix 아래를 삭제하기 전에 Homebrew 자체의 메타데이터를 먼저 확인하세요.

Homebrew가 남겨 두는 것

세 종류의 잔여물이 쌓입니다.

• 이전 버전. 정리는 보통 대체된 버전을 제거하지만, 유지된 버전이나 최근에 업그레이드한 버전은 한동안 Cellar에 남을 수 있습니다.
• 다운로드된 아카이브. bottle과 cask 다운로드는 모두 Homebrew 캐시에 저장되며, 다시 받지 않도록 보관됩니다.
• 사용하지 않는 의존성. 현재 Homebrew의 정리와 제거 작업은 보통 더 이상 필요 없는 formula를 제거합니다. 다만 자동 제거가 꺼져 있으면 그렇지 않습니다. 오래된 설치나 중단된 작업 때문에 일부가 남을 수 있습니다.

다운로드 캐시 크기는 다음과 같이 바로 확인할 수 있습니다.

brew --cache
du -sh "$(brew --cache)" 2>/dev/null

세 저장소를 따로 측정하기

전체 용량만 보면 무엇을 정리할 수 있는지 알기 어렵습니다. 정리 전에 설치된 formula, cask 메타데이터, 다운로드 캐시의 크기를 각각 기록하세요.

du -sh "$(brew --cellar)" "$(brew --caskroom)" "$(brew --cache)" 2>/dev/null

캐시는 다시 다운로드할 수 있으므로 공간을 확보하기 쉬운 대상입니다. Cellar는 대부분 설치된 소프트웨어이며, cleanup은 그중 이전 버전을 정리합니다. Caskroom이 크다고 앱 번들이 그 안에 있다는 뜻은 아닙니다. 앱은 보통 /Applications에 있습니다. 정리한 뒤 같은 명령으로 어느 저장소가 얼마나 줄었는지 확인하세요.

정리하는 방법

먼저 Homebrew가 제거할 이전 버전과 다운로드 캐시를 확인하세요. 다음 명령은 삭제하지 않습니다.

brew cleanup -n

표시된 경로를 확인하세요. 정상 종료 후 삭제 후보가 없다면 해당 범위에 정리할 항목이 없는 것입니다. 오류는 항목이 없다는 뜻이 아닙니다. 이전 버전이나 오프라인 다운로드가 필요하지 않은지 확인한 뒤 일반 정리를 실행하세요.

brew cleanup

현재 Homebrew 매뉴얼에 따르면, 일반 cleanup은 기본적으로 이전에 설치된 버전과 120일이 지난 다운로드를 제거합니다. HOMEBREW_CLEANUP_MAX_AGE_DAYS로 그 기간을 바꿀 수 있습니다. 미리 보려면 -n을 사용하세요. 더 깊은 -s 모드는 현재 설치된 formula와 cask용 다운로드는 남기면서 캐시된 다운로드를 더 많이 정리합니다.

더 넓은 캐시 정리는 별도로 미리 확인해야 합니다. 첫 번째 명령의 목록을 검토하고 그 범위를 받아들일 때만 두 번째 명령을 따로 실행하세요.

brew cleanup -s -n

brew cleanup -s

Homebrew cleanup과 uninstall은 이제 기본적으로 사용하지 않는 formula 의존성을 제거합니다. 그 의존성 판단을 직접 확인하고 싶을 때 brew autoremove가 여전히 유용합니다.

brew autoremove --dry-run

brew autoremove

brew list는 설치된 패키지를, brew outdated는 대기 중인 업데이트를 보여 줍니다. 경로를 /opt/homebrew처럼 고정하지 말고 brew --cellar, brew --caskroom, brew --cache로 확인하세요. Intel과 Apple silicon 설치 경로는 다릅니다.

설계상 안전한 이유

Homebrew cleanup은 Cellar 디렉터리를 손으로 지우는 것보다 위험이 낮습니다. 버전과 의존성 메타데이터를 사용하기 때문입니다. 그래도 롤백용 버전이나 오프라인에서 쓰려던 캐시 bottle을 제거할 수 있습니다. cleanup과 autoremove를 모두 미리 보고, 고정했거나 운영상 중요한 버전은 의도적으로 유지하세요.

내부 구조: Cellar, Caskroom, cleanup 판단 방식

Homebrew는 각 formula를 brew --cellar가 보고하는 Cellar의 버전별 디렉터리에 설치한 뒤, 활성 버전을 prefix에 링크합니다. 업그레이드는 심볼릭 링크를 다시 가리키기 전에 새 버전을 이전 버전 옆에 둡니다. Cask는 Caskroom 아래에 버전별 메타데이터를 두고, 앱 번들은 보통 /Applications에 둡니다. 다운로드는 brew --cache가 보고하는 경로를 쓰며 Homebrew 정책에 따라 보관됩니다. brew cleanup은 현재가 아닌 디렉터리를 전부 지우지 않고, 설치된 버전·보관 기간·의존성 메타데이터를 사용합니다. brew autoremove는 의존성만 다루는 부분을 별도 명령으로 노출합니다. 둘 다 추측이 아니라 Homebrew 자체 기록을 기준으로 동작하므로, 폴더를 수동으로 지우는 것보다 안전하고 설명하기 쉽습니다. 구형 툴체인이나 오프라인 bottle에 의존하는 기기에서는 미리 보기가 여전히 유용합니다.

다른 도구가 멈춰야 하는 지점

Mole은 Homebrew 다운로드와 brew cleanup --dry-run이 제거 대상으로 제시한 이전 formula 버전을 표시합니다. 이전 버전 검색은 표준 경로 /opt/homebrew와 /usr/local을 지원하며 링크되거나 고정된 버전은 남깁니다. Cellar 전체를 비우거나 Homebrew의 의존성 판단을 대신하지 않습니다. 실제 항목을 검토한 뒤 정리를 확인하세요. 이전 버전 항목은 기본적으로 선택되지 않으며 검토 후 선택합니다.

안전한 작업 순서

Homebrew 경로 명령으로 저장소를 측정하고, brew cleanup -n으로 미리 본 뒤, -s를 고려하기 전에 일반 cleanup을 실행하세요. brew autoremove는 캐시가 아니라 의존성 질문에 답하므로 따로 미리 보세요. 자동 정리가 동작 중이고 디스크 압박이 크지 않다면 고정된 정리 일정은 필요 없습니다.