macOS Ventura, Sonoma M1/M2 완벽 호환! Homebrew를 이용한 Yarn 설치부터 사용법, 오류 해결까지 상세 보기

HTML

macOS 환경에서 Yarn은 Node.js 패키지를 효율적으로 관리해주는 필수 도구입니다. 특히 M1/M2 칩 기반의 새로운 Mac 사용자라면 설치 과정에서 겪을 수 있는 호환성 문제나 오류에 대비하는 것이 중요합니다. 이 포스팅은 **2025년 최신 macOS 버전(Ventura, Sonoma)**을 기준으로, Homebrew를 활용하여 Yarn을 빠르고 안전하게 설치하고 기본 명령어 사용법 및 흔한 설치 오류 해결 방법을 상세하게 안내합니다. 이제 Mac 환경에서 복잡한 설정 없이 개발 프로젝트를 시작해 보세요.

본격적인 설치에 앞서, Yarn 설치를 위한 선행 조건인 Node.js와 Homebrew의 설치 여부를 확인하는 것이 중요합니다. 이미 설치되어 있다면 다음 단계로 넘어가셔도 됩니다.

✅ macOS 환경 Yarn 설치의 선행 조건 확인하기

Yarn은 Node.js의 패키지 매니저로 작동하기 때문에 Node.js가 반드시 설치되어 있어야 합니다. 또한, Mac에서 패키지 관리를 편리하게 해주는 Homebrew를 사용하는 것이 가장 일반적이고 권장되는 설치 방법입니다.

Homebrew 설치 및 최신 버전 확인

Homebrew는 macOS용 패키지 관리자로, 터미널에서 간단한 명령어로 다양한 소프트웨어를 설치, 업데이트, 제거할 수 있게 해줍니다. Homebrew가 설치되어 있지 않다면 아래 명령어를 터미널에 입력하여 설치합니다.

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

설치 후에는 다음 명령어로 최신 버전을 유지하고 문제를 확인할 수 있습니다.

brew update && brew doctor

Node.js 설치 여부 확인 및 설치

Node.js 설치 여부는 다음 명령어로 확인할 수 있습니다. 버전 정보가 출력된다면 이미 설치되어 있는 것입니다.

node -v

만약 Node.js가 설치되어 있지 않다면 Homebrew를 사용하여 안정적인 최신 버전을 설치하는 것을 권장합니다. 특히 M1/M2 Mac 사용자는 **Homebrew를 통해 설치하는 것이 아키텍처 호환성 문제(ARM64 vs x86_64)를 최소화**할 수 있는 가장 좋은 방법 중 하나입니다.

brew install node

Yarn을 설치하기 위한 모든 준비가 완료되었다면, 다음 단계에서 본격적인 Yarn 설치를 진행합니다.

💻 Homebrew를 이용한 Mac Yarn 설치 명령어 보기

가장 권장되는 방법은 Homebrew를 사용하여 Yarn을 설치하는 것입니다. 이 방법은 시스템 경로 설정과 업데이트 관리가 매우 용이합니다.

Yarn 안정적인 버전 설치

터미널에 다음 명령어를 입력하여 Yarn을 설치합니다.

brew install yarn

이 명령어를 실행하면 Homebrew가 자동으로 최신 안정화된 Yarn 버전을 다운로드하고 설치 경로에 추가해 줍니다.

설치 확인 및 버전 확인

설치가 완료되면, 다음 명령어를 통해 Yarn이 시스템에 정상적으로 설치되었는지 확인하고 버전을 체크합니다. 출력되는 버전 정보는 현재 시스템에 설치된 Yarn의 버전을 의미합니다.

yarn -v

버전 정보가 정상적으로 출력되면 Yarn 설치는 성공적으로 완료된 것입니다.

npm을 이용한 Yarn 설치 (대안)

만약 Homebrew를 사용하고 싶지 않다면, Node.js와 함께 설치된 npm(Node Package Manager)을 사용하여 Yarn을 전역(global)으로 설치할 수도 있습니다.

npm install -g yarn

이 방법 역시 널리 사용되지만, Homebrew를 통한 설치가 macOS 패키지 관리의 표준처럼 여겨지므로 특별한 이유가 없다면 brew install yarn을 사용하는 것을 권장합니다.

💡 M1/M2 Mac 사용자를 위한 Yarn 설치 팁 및 주의 사항 확인하기

Apple Silicon(M1, M2 등) 칩을 사용하는 Mac 사용자라면 아키텍처 호환성 때문에 특정 상황에서 오류를 겪을 수 있습니다. 다행히 **2025년 현재 대부분의 Yarn 관련 도구와 Node.js 버전은 Apple Silicon을 네이티브로 지원**합니다. 그럼에도 불구하고 특정 레거시 라이브러리를 사용해야 할 경우 몇 가지 주의사항이 있습니다.

Rosetta 2 활용

매우 오래된 패키지나 특정 네이티브 확장을 사용하는 경우, Apple Silicon용으로 컴파일되지 않아 문제가 발생할 수 있습니다. 이 경우, 해당 프로젝트를 실행할 때만 터미널을 Rosetta 2 환경으로 실행해볼 수 있습니다. 그러나 이는 임시방편이며, 되도록 네이티브 지원 버전을 사용하는 것이 가장 좋습니다.

Node.js 버전 관리 도구 활용

개발 환경에 따라 여러 Node.js 버전을 전환해야 할 필요가 있을 수 있습니다. 이때 nvm(Node Version Manager) 또는 Volta와 같은 도구를 사용하면 버전을 유연하게 관리할 수 있으며, 이는 Yarn 사용 환경의 안정성에도 기여합니다.

• nvm 설치 후 사용: nvm install --lts (LTS 버전 설치)
• Volta 설치 후 사용: volta install node

이러한 도구는 Node.js와 Yarn의 환경 변수 관리를 자동화하여 설치 오류를 줄여줍니다.

⚙️ Yarn의 기본 사용법 및 주요 명령어 상세 더보기

Yarn 설치를 완료했다면, 이제 프로젝트를 생성하고 패키지를 관리하는 기본 명령어를 익혀야 합니다. Yarn은 npm과 유사하지만 더 빠르고 안정적인 의존성 관리를 제공합니다.

새 프로젝트 시작하기

새로운 Node.js 프로젝트를 시작하려면 다음 명령어를 사용합니다.

yarn init

이 명령어는 package.json 파일을 생성하고 프로젝트의 메타데이터를 설정하도록 안내합니다.

패키지 설치 및 추가

프로젝트에 필요한 패키지(라이브러리)를 설치할 때 사용합니다. Yarn은 node_modules 디렉토리에 패키지를 추가하고, yarn.lock 파일을 생성하여 의존성 버전을 고정합니다.

yarn add [패키지 이름]
yarn add [패키지 이름] --dev // 개발 환경 전용 패키지 설치
yarn install // package.json을 기반으로 모든 의존성 설치

특히 yarn install은 **기존 프로젝트의 모든 의존성을 일관성 있게 설치**할 때 가장 중요한 명령어입니다. 새로운 개발자가 프로젝트에 참여하거나 배포 환경을 설정할 때 필수적입니다.

패키지 업데이트 및 제거

설치된 패키지의 업데이트와 제거 명령어는 다음과 같습니다.

yarn upgrade [패키지 이름] // 특정 패키지 업데이트
yarn remove [패키지 이름] // 특정 패키지 제거

Yarn 명령어는 직관적이고 빠르다는 장점 때문에 많은 개발자들에게 선호됩니다.

❌ Mac Yarn 설치 후 발생하는 흔한 오류 해결 방법 확인하기

Yarn 설치 자체는 간단하지만, 환경 설정이나 권한 문제로 인해 예기치 않은 오류가 발생할 수 있습니다. 다음은 가장 흔한 오류와 그 해결책입니다.

“yarn: command not found” 오류

이 오류는 Yarn이 정상적으로 설치되었지만, 시스템의 **PATH 환경 변수에 Yarn 실행 파일의 경로가 포함되어 있지 않아서** 발생합니다. Mac 사용자에게는 흔한 문제이며, 다음과 같이 해결할 수 있습니다.

• **Homebrew 설치 경로 확인:** Homebrew로 설치했다면, 설치 완료 시 출력된 안내 메시지를 확인하거나 brew doctor 명령을 통해 PATH 설정을 재확인합니다.
• **쉘 설정 파일 편집:** 사용하는 쉘(Zsh 또는 Bash)의 설정 파일(~/.zshrc 또는 ~/.bash_profile)을 열어 Yarn의 설치 경로를 추가해야 합니다.

  export PATH="$PATH:$(brew --prefix yarn)/bin"

  추가 후 source ~/.zshrc (또는 해당 파일)로 설정을 적용합니다.

EACCES: permission denied 오류

이 오류는 주로 npm을 사용하여 Yarn을 전역 설치(npm install -g yarn)할 때, 패키지를 설치할 디렉토리에 **쓰기 권한이 없을 때** 발생합니다. 해결 방법은 크게 세 가지입니다.

• **npm 권한 변경:** npm의 기본 설치 디렉토리 권한을 사용자에게 부여하거나, npm이 다른 디렉토리에 패키지를 설치하도록 설정합니다. (npm 공식 문서 권장)
• **Homebrew 사용:** 가장 확실한 방법은 Homebrew를 사용하여 설치하는 것입니다. Homebrew는 권한 문제를 자체적으로 해결하도록 설계되어 있습니다.
• **sudo 사용 (비권장):** sudo npm install -g yarn을 사용하면 권한 문제가 해결되지만, 보안상의 이유로 전역 패키지 설치에 sudo를 사용하는 것은 공식적으로 권장되지 않습니다.

❓ 자주 묻는 질문 (FAQ)

Q1. Yarn과 npm 중 Mac 개발 환경에서 어떤 것을 사용하는 것이 좋은가요?

A. Yarn과 npm 모두 Node.js 패키지 관리자로 훌륭하게 작동하며, 기능적으로는 큰 차이가 없습니다. 다만, 과거에는 Yarn이 속도나 안정성(yarn.lock 파일 기반)에서 우위에 있었지만, 최신 버전의 npm(v7 이상)도 성능이 대폭 개선되었습니다. 대부분의 Mac 개발자는 프로젝트의 요구사항이나 팀의 표준에 따라 선택하며, 둘 다 설치해두고 사용하는 경우가 많습니다. 일반적으로 Yarn은 프로젝트 의존성을 고정하는 데 더 유리하고, npm은 Node.js에 기본 포함되어 별도 설치가 필요 없다는 장점이 있습니다.

Q2. M1/M2 Mac에서 Yarn 설치 시 특별히 고려해야 할 사항이 있나요?

A. 2025년 현재, 대부분의 최신 Node.js 및 Yarn 버전은 Apple Silicon(M1/M2)을 네이티브로 지원합니다. 따라서 Homebrew를 사용하여 설치하면 아키텍처 문제는 거의 발생하지 않습니다. 그러나 프로젝트가 오래된 네이티브 확장 모듈을 포함하고 있다면, 해당 모듈을 M1/M2용으로 업데이트하거나, nvm 또는 Volta를 사용하여 Node.js 버전을 호환되는 버전으로 관리해야 할 수 있습니다.

Q3. Yarn 설치 후 ‘yarn: command not found’ 오류가 계속 발생하면 어떻게 해야 하나요?

A. 이 오류는 쉘(Shell)의 PATH 환경 변수 설정 문제일 가능성이 가장 높습니다. 가장 먼저 Homebrew 설치 경로를 확인하고, ~/.zshrc(또는 ~/.bash_profile) 파일에 Yarn 실행 경로가 올바르게 추가되었는지 확인하세요. 경로 추가 후에는 반드시 source 명령어로 쉘 설정을 다시 로드해야 변경 사항이 적용됩니다.