Flutter 맥 설정, 'flutter doctor'도 알려주지 않는 4가지 함정
새로운 실리콘 맥(M1, M2, M3)에서 바이브코딩을 시작하려는 설렘은 잠시, 터미널에 나타나는 알 수 없는 오류 메시지와 flutter doctor의 무자비한 붉은 경고에 좌절한 적 있으신가요? 공식 가이드가 친절해 보이지만, 실전에서 마주치는 까다로운 지점들은 생략되어 있곤 합니다. 오늘은 여러분의 소중한 시간을 지켜드리기 위해, 환경 설정 단계의 '4가지 함정'과 명쾌한 해결책을 공유합니다.
함정 1. 네이티브 앱 개발인데 '로제타 2'가 필요하다고?
애플 실리콘의 강력한 성능을 활용하려는데, 인텔 앱을 위한 로제타 2(Rosetta 2)를 설치하라는 안내는 의아하게 느껴집니다. 하지만 플러터 개발 환경의 일부 도구들이 여전히 인텔 아키텍처 기반이라 설치는 필수입니다.
✅ 해결책: 터미널에 아래 명령어 한 줄을 입력하세요.
sudo softwareupdate --install-rosetta --agree-to-license
이 한 줄이 앞으로 발생할 수 있는 수많은 잠재적 오류를 예방하는 첫 단추입니다.
함정 2. 설치는 했지만, Mac은 Flutter를 모른다 (PATH)
SDK 압축을 풀고 옮겨두었지만, 터미널에 flutter를 치면 'command not found'라는 메시지가 돌아옵니다. Mac에게 플러터가 어디 있는지 'PATH'를 직접 알려주어야 합니다.
✅ 해결책: .zshrc 파일 수정하기
- 홈 디렉토리에서
.zshrc파일을 만듭니다. (Sublime Text 같은 편집기 활용 추천) - 아래 내용을 파일 끝에 추가하고 저장합니다.
- 터미널을 재실행한 뒤
which flutter를 입력해 경로가 정상적으로 출력되는지 확인하세요.
export PATH="$PATH:$HOME/flutter/bin"
함정 3. 'flutter doctor'의 배신, 이건 진단이 아니라 과제다!
실행 결과에 나타나는 빨간 ❌ 표시에 당황하지 마세요. 이건 실패 보고서가 아니라 '앞으로 해야 할 일(To-do list)'입니다.
- Android Toolchain: 안드로이드 스튜디오 설치 후 'SDK Command-line Tools'를 별도로 꼭 추가해야 합니다.
- Android 라이선스: 터미널에서
flutter doctor --android-licenses를 실행하고 모든 항목에y를 입력해 동의해야 해결됩니다.
함정 4. 최종 보스 'CocoaPods', 루비(Ruby)의 늪
가장 까다로운 단계입니다. 맥에 기본 설치된 루비 버전이 실리콘 칩과 충돌을 일으켜 설치 오류가 발생합니다. "의존성의 사슬"을 순서대로 해결해야 합니다.
🚀 CocoaPods 필승 설치 순서:
- Homebrew 설치: 맥용 패키지 관리자의 시작
- rbenv 설치: 시스템 루비와 충돌을 피하기 위한 버전 관리 도구
- 최신 Ruby 설치:
rbenv install 3.3.0등으로 최신 버전 세팅 - CocoaPods 설치: 비로소 깨끗한 루비 환경에서
sudo gem install cocoapods