2025년 현재, 모바일 크로스 플랫폼 개발의 핵심 도구인 Flutter는 맥OS 환경, 특히 M1/M2/M3와 같은 Apple Silicon 기반의 맥북에서도 더욱 안정적으로 사용할 수 있게 되었습니다. 이 가이드는 Flutter를 맥(macOS)에 설치하고 개발 환경을 설정하는 가장 최신 방법을 단계별로 안내합니다. 구형 Intel 맥북 사용자부터 최신 Apple Silicon(M 계열 칩) 사용자까지 모두를 위한 완벽한 설치 절차를 확인해 보세요.
📚 함께 읽으면 좋은 글
특히 2024년의 설치 트렌드가 공식 문서를 통한 수동 설치에서 Homebrew를 활용한 간편 설치로 옮겨가는 추세였으며, 2025년에는 공식 문서에서도 Homebrew를 강력하게 권장하고 있습니다. 가장 효율적이고 오류 없이 Flutter 환경을 구축하는 방법을 알아보겠습니다.
✅ Flutter 설치 전 필수 준비 사항 확인하기
Flutter 설치를 시작하기 전에 시스템이 최소 요구 사항을 충족하는지 확인해야 합니다. 이 단계를 건너뛰면 나중에 불필요한 오류가 발생할 수 있습니다.
macOS 버전 및 디스크 공간 요구 사항 상세 더보기
- 운영체제: macOS 10.15 (Catalina) 이상
- 디스크 공간: 최소 2.8GB (IDE 및 Xcode 제외)
- 필수 도구:
- Git: 소스 코드를 다운로드하고 관리하는 데 사용됩니다. 대부분의 맥에 기본 설치되어 있지만, 터미널에
git --version을 입력하여 확인해 보세요. - Xcode: iOS 개발을 위한 필수 도구입니다. App Store에서 설치하거나
xcode-select --install명령어로 커맨드 라인 도구를 설치해야 합니다. - Homebrew: macOS용 패키지 관리자입니다. 공식 문서에서 권장하는 가장 쉬운 설치 방법입니다.
- Git: 소스 코드를 다운로드하고 관리하는 데 사용됩니다. 대부분의 맥에 기본 설치되어 있지만, 터미널에
특히 M1/M2/M3 사용자는 터미널 환경이 Rosetta 2를 사용하는지, 아니면 네이티브 ARM64 환경인지를 명확히 인지하고 작업을 시작해야 합니다. 일반적으로 네이티브 ARM64 터미널(zsh 또는 bash)에서 Homebrew를 설치하고 사용하는 것이 좋습니다.
Xcode는 반드시 설치하고, 최초 실행하여 라이선스 동의 과정을 완료해 주셔야 합니다. 이 과정이 생략되면 나중에 flutter doctor 실행 시 오류를 발생시킬 수 있습니다.
✅ Homebrew를 이용한 Flutter SDK 간편 설치 방법 보기
가장 권장되는 방식인 Homebrew(맥용 패키지 관리자)를 사용하여 Flutter SDK를 설치하는 방법을 소개합니다. 수동으로 경로를 설정하고 환경 변수를 관리하는 복잡한 과정을 줄여줍니다.
Homebrew 설치 및 환경 변수 설정 확인하기
- Homebrew 설치: 터미널을 열고 다음 명령어를 실행합니다. 이미 설치되어 있다면 건너뛰세요.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - Flutter 설치: Homebrew가 설치되었다면, 이제 Flutter SDK를 설치합니다. 이 명령은 Dart SDK도 함께 설치합니다.
brew install flutter - 환경 변수 확인: Homebrew를 통해 설치하면 자동으로 환경 변수가 설정되지만, 때로는 수동으로 셸 설정 파일(
.zshrc또는.bash_profile)에 경로를 추가해야 할 수도 있습니다.echo $PATH를 실행하여 Flutter SDK 경로가 포함되어 있는지 확인하세요.
Homebrew 설치 시 터미널에서 안내하는 경로 추가 명령을 반드시 실행해야 정상적으로 flutter 명령어를 사용할 수 있습니다. 이 과정은 사용자 환경(Intel 또는 Apple Silicon)에 따라 다르므로 터미널의 안내를 잘 따라야 합니다.
가장 중요한 것은 Homebrew를 통한 설치는 관리의 용이성을 제공하며, 향후 Flutter 업데이트 시 brew upgrade flutter 명령 하나로 최신 버전을 간편하게 적용할 수 있다는 점입니다.
✅ Flutter Doctor를 통한 환경 설정 및 디펜던시 검사 상세 더보기
Flutter 설치가 완료되면, 개발 환경의 누락된 도구(디펜던시)나 미완료된 설정이 없는지 확인하는 flutter doctor 명령어를 실행해야 합니다. 이 명령은 개발 환경 구축의 상태를 알려주는 핵심 도구입니다.
초기 환경 설정 및 Android Studio 설치 보기
flutter doctor실행: 터미널에 다음 명령어를 입력합니다.flutter doctor- 결과 분석: 결과는 주로 다음과 같이 표시됩니다.
- ✅: 설정 완료, 문제 없음
- ❌: 누락된 도구 또는 문제 있음
- ❗: 경고 메시지, 주의 필요
- Android Toolchain 설정: 만약
Android toolchain관련 ❌가 표시된다면, Android Studio를 설치하고 SDK Manager에서 Android SDK를 다운로드해야 합니다.- Android Studio 설치 후, 터미널에서 다음 명령어로 라이선스에 동의해야 합니다.
flutter doctor --android-licenses
- Android Studio 설치 후, 터미널에서 다음 명령어로 라이선스에 동의해야 합니다.
- Xcode 설정:
iOS toolchain관련 ❌가 표시된다면, Xcode 설치 및 커맨드 라인 도구 설치, 라이선스 동의 여부를 다시 확인해야 합니다.sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer sudo xcodebuild -runFirstLaunch그리고 iOS 시뮬레이터를 실행하기 위해
open -a Simulator명령어를 사용해볼 수 있습니다.
가장 흔한 오류는 Android 라이선스에 대한 동의가 누락되는 경우입니다. flutter doctor --android-licenses 명령을 실행하고 안내에 따라 모두 ‘y’를 입력하여 동의하는 것이 중요합니다. 이 과정을 완료하면 대부분의 툴체인 문제가 해결됩니다.
2025년 기준, Flutter는 Android Studio 외에도 VS Code와 같은 가벼운 에디터에서도 개발 환경을 완벽하게 지원하며, 두 환경 모두에서 Flutter 플러그인 설치가 필수입니다.
✅ VS Code와 Android Studio IDE 환경 설정 확인하기
Flutter 개발은 IDE(통합 개발 환경)의 도움이 필수적입니다. 가장 많이 사용되는 VS Code와 Android Studio를 위한 설정 방법을 안내합니다.
VS Code 및 Flutter 플러그인 설치 보기
- VS Code 설치: 공식 웹사이트에서 다운로드하여 설치합니다.
- 플러그인 설치: VS Code를 실행하고 Extensions(확장) 메뉴에서 Flutter와 Dart를 검색하여 설치합니다. Flutter 플러그인을 설치하면 Dart 플러그인도 함께 설치되는 경우가 많습니다.
- 디버깅 확인: VS Code에서 Flutter 프로젝트를 열고, 화면 하단 상태 표시줄의 디바이스 선택기에서 시뮬레이터나 연결된 실제 장치가 인식되는지 확인합니다.
iOS 및 Android 장치 연결 및 테스트 상세 더보기
- iOS 시뮬레이터: 터미널에서
open -a Simulator를 실행하여 시뮬레이터를 띄운 후, VS Code나 Android Studio에서 디바이스를 선택하고 앱을 실행할 수 있습니다. - Android 에뮬레이터: Android Studio의 AVD(Android Virtual Device) Manager에서 에뮬레이터를 생성하고 실행합니다.
Flutter 개발의 핵심은 IDE와의 완벽한 통합입니다. VS Code 또는 Android Studio에 Flutter 및 Dart 플러그인을 설치해야 코드 하이라이팅, 자동 완성, 디버깅, 핫 리로드(Hot Reload) 등의 핵심 기능을 사용할 수 있습니다. 핫 리로드는 개발 생산성을 극대화하는 Flutter의 가장 큰 장점 중 하나입니다.
설치 후에는 새로운 Flutter 프로젝트를 생성하여(예: flutter create my_app) iOS 시뮬레이터 또는 Android 에뮬레이터에서 flutter run 명령을 통해 성공적으로 앱이 실행되는지 테스트하는 것이 마지막 단계입니다.
✅ 맥북 M1/Apple Silicon 환경에서의 주의 사항 확인하기
Apple Silicon(M1, M2, M3 칩)을 사용하는 맥북 환경은 Intel 기반 맥북과 몇 가지 차이점이 있어 특별한 주의가 필요합니다. 2025년 현재는 대부분의 문제가 해결되었지만, 설치 시 네이티브 환경을 유지하는 것이 중요합니다.
Apple Silicon용 Homebrew 및 환경 변수 설정 상세 더보기
- 네이티브 터미널 사용: Apple Silicon 맥북의 터미널은 기본적으로 ARM64 아키텍처를 사용합니다. Rosetta 2를 통해 Intel 버전을 사용하지 않도록 주의해야 합니다.
arch명령을 실행하여arm64가 출력되는지 확인하세요. - Homebrew 설치 경로: Apple Silicon용 Homebrew는
/opt/homebrew경로에 설치됩니다. 이 경로가 환경 변수에 올바르게 추가되어야 합니다. Intel 맥북의/usr/local과는 다릅니다.
만약 기존 Intel 맥북에서 마이그레이션했거나, 잘못된 터미널 환경에서 Homebrew를 설치했다면, Flutter 명령어가 인식되지 않을 수 있습니다. 이 경우 /opt/homebrew의 경로를 .zshrc 파일에 수동으로 추가해야 문제가 해결됩니다.
flutter doctor 실행 시, 모든 항목이 ✅로 나타난다면 이제 Flutter 개발을 위한 완벽한 환경이 구축된 것입니다. 성공적인 크로스 플랫폼 개발을 시작하시기 바랍니다.
📌 추가로 참고할 만한 글
자주 묻는 질문 (FAQ)
Q1. M1 맥북에서 Flutter 설치 시 ‘zsh: command not found: flutter’ 오류가 발생합니다. 어떻게 해결해야 하나요?
이 오류는 Flutter SDK 경로가 시스템 환경 변수에 제대로 등록되지 않았을 때 발생합니다. Homebrew를 사용했다면, Homebrew가 설치 시 안내한 대로 eval "$(/opt/homebrew/bin/brew shellenv)" 명령어를 실행하고, 이 결과를 ~/.zshrc 파일에 추가했는지 확인해야 합니다. 수동으로 설치한 경우, Flutter SDK의 bin 폴더 경로를 PATH 환경 변수에 직접 추가해야 합니다.
Q2. Flutter 설치 후 ‘flutter doctor’ 실행 시 ‘Android toolchain’에서 ❌ 오류가 계속 나옵니다.
대부분은 Android SDK 라이선스에 동의하지 않아 발생하는 문제입니다. Android Studio를 설치하고 SDK가 다운로드된 상태에서 터미널에 flutter doctor --android-licenses 명령을 실행하고, 안내에 따라 모든 라이선스에 ‘y’를 입력하여 동의해야 합니다. 또한, Android Studio에서 SDK Manager를 열어 Android SDK Command-line Tools가 설치되어 있는지 확인해 보세요.
Q3. Homebrew 대신 ZIP 파일을 다운로드하여 수동으로 설치해도 되나요?
수동 설치도 가능하지만, 공식 문서에서는 Homebrew를 권장합니다. 수동 설치 시에는 ZIP 파일을 원하는 위치에 압축 해제한 후, 해당 폴더의 bin 경로를 수동으로 PATH 환경 변수에 추가해야 합니다. 이 방식은 환경 변수 관리가 복잡하며, 추후 업데이트 시 수동으로 파일을 교체해야 하는 번거로움이 있습니다. Homebrew를 사용하면 brew upgrade flutter 명령 하나로 업데이트가 가능하여 훨씬 효율적입니다.
Q4. Xcode를 반드시 설치해야 하나요? 저는 Android 개발만 할 예정입니다.
네, Flutter는 iOS 및 Android 개발 환경 모두에 대한 점검을 수행하기 때문에 Xcode 설치 및 커맨드 라인 도구 설치가 필요합니다. Android 개발만 할 예정이라도 flutter doctor에서 ✅를 받기 위해서는 Xcode 설치가 권장됩니다. Xcode를 설치하지 않더라도, xcode-select --install 명령으로 최소한의 커맨드 라인 도구는 설치해야 일부 개발 도구의 종속성 문제가 해결됩니다.