Flutter 설치하기 (mac, fvm, 안드로이드 스튜디오)

Image generated using Midjourney. © 2025 GeekCode (Bang Hyeonseok).

 

 

 

Flutter 개발을 시작하는 가장 현실적인 세팅 가이드

 

Flutter를 배우기로 마음먹은 당신,

 

그 시작점은 다름 아닌 개발 환경 세팅이죠.

 

하지만 설치 방법도 여러 가지고, 버전도 다양해서 처음에는 길을 잃기 십상입니다.

 

그래서 이 글에서는 Flutter를 설치하는 3가지 방법을 명확히 비교하고,

 

개인 프로젝트에 적합한 환경 구성까지 자연스럽게 이어지는 방법을 정리해봤습니다.

 

 

 

왜 설치 방법이 여러 개일까?

 

Flutter 설치에는 대표적으로 아래 3가지 방법이 있습니다.

 

1. Homebrew로 설치
2. 수동 다운로드 후 환경변수 설정
3. FVM(Flutter Version Management)으로 버전 관리하며 설치

 

 

결론부터 말하자면,

 

• 가볍게 시작하거나 실습 위주라면 Homebrew
• 다양한 버전 관리가 필요하다면 FVM
• Flutter의 공식적인 방식은 수동 설치

각 방식마다 장단점이 있고, 본인의 개발 스타일에 따라 선택지가 달라집니다.

 

 

 

1. Homebrew로 설치하는 가장 쉬운 방법

 

macOS 환경이라면 Homebrew는 친숙하죠.

 

한 줄이면 설치가 끝납니다.

 

Step1. brew 설치

 

Step2. brew에서 flutter 설치 진행

 

brew install --cask flutter

 

 

Step3. 설치 후 세팅은 2. Flutter 세팅에서 진행

 

그 후 환경변수만 세팅하면 바로 사용 가능하지만,

버전 관리에는 다소 제약이 있습니다.

 

다른 Flutter 버전과 병행이 필요하다면 FVM을 고려하세요.

 

 

 

2. 수동 설치 – Flutter의 공식 권장 방식

 

Flutter 공식 문서에서 가장 먼저 소개하는 방식입니다.

 

다만 환경변수 설정이 필요하고, 설치 위치에 따라 인식 문제가 생길 수 있어 정확한 경로 입력이 중요합니다.

 

 

설치 절차 요약

 

Step1. Flutter 공식 다운로드

 

Step2. 원하는 폴더에 압축 해제 (예: ~/Dev/flutter)

 

Step3. .zshrc 혹은 .bash_profile에 아래 내용 추가

export PATH="$PATH:~/Dev/flutter/bin"
source ~/.zshrc

 

 

Step4. 설치 확인

 

flutter --version


// 설치 결과 예시
Flutter 3.32.2 • channel stable • https://github.com/flutter/flutter.git
Framework • revision 8defaa71a7 (7 days ago) • 2025-06-04 11:02:51 -0700
Engine • revision 1091508939 (12 days ago) • 2025-05-30 12:17:36 -0700
Tools • Dart 3.8.1 • DevTools 2.45.1

 

 

 

 

 

3. FVM으로 설치 – 프로젝트별 버전 관리가 필요한 당신에게

 

FVM은 여러 Flutter 버전을 동시에 관리하고,

 

각 프로젝트마다 별도 버전을 지정할 수 있게 해줍니다.

 

예를 들어 회사에서는 A프로젝트에서는 3.7.12, B프로젝트에서는 3.7.0, 그리고 사이드 프로젝트에서는 3.10.5를 쓸 수 있죠.

 

심볼릭 링크와 .fvmrc 파일로 버전 충돌 없이 작업 가능합니다.

 

 

 

설치 방법

 

설치 방법: 2가지 방식

 

FVM은 설치 방식이 2가지이며, FVM 공식 문서에서는 독립적 설치(standard 방식)를 권장합니다.

 

 

 

1. 독립적 설치(권장)

 

brew 를 통한 간단한 설치로 진행합니다.

 

brew tap leoafarias/fvm
brew install fvm

 

 

제거또한 간단하게 아래 명령어로 진행할 수 있습니다.

 

 

brew remove fvm

 

 

 

2. Dart pub package로 설치

공식 사이트에서도 소개하지만, 권장되진 않는 방식입니다.

 

단순히 테스트하거나, 가볍게 써보고 싶은 경우라면 고려할 수 있습니다.

 

 

dart pub global activate fvm

 

 

이렇게 설치한 경우에는 매번 아래처럼 실행해야 하므로 다소 번거롭습니다.

 

dart pub global run fvm install stable

 

 

 

기본적인 사용 흐름

 

설치 후 프로젝트 폴더로 이동해 아래 명령어를 실행합니다.

 

fvm install stable        # 안정 버전 설치
fvm install 3.32.3        # 특정 버전 설치
fvm use 3.32.3            # 현재 프로젝트에 버전 적용
fvm flutter doctor        # flutter doctor 실행

 

 

프로젝트 내부에는 다음과 같은 구조가 생깁니다:

 

/my_project
 ├── .fvm/           # 심볼릭 링크가 설정된 디렉토리
 ├── .fvmrc          # 사용할 Flutter 버전 명시
 └── lib/

 

 

마지막으로 사용할 IDE에서 Flutter SDK 경로를 지정할 땐 아래처럼 설정하면 됩니다:

 

{프로젝트 경로}/.fvm/flutter_sdk

 

 

 

 

 

flutter doctor로 환경 점검

 

설치는 끝났는데요.  이제 진짜 중요한 건 개발 환경 점검입니다.

flutter doctor는 지금 내 환경이 실제로 작동 가능한 상태인지 검증해주는 도구 입니다.

 

 

// 일반 설치  
flutter doctor

// fvm 사용한 경우  
fvm flutter doctor

 

 

flutter doctor는 무엇을 확인해줄까?

 

이 명령어를 실행하면, 아래 항목들을 순서대로 점검해줍니다:

 

 

 

🍎 macOS & iOS 개발 환경

• Xcode 설치 여부
• Xcode 선택
  • 여러 버전이 설치된 경우 아래 명령어로 사용할 버전을 명시

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

 

• Xcode 초기화
  • 최초 실행 시 필요한 설정

sudo xcodebuild -runFirstLaunch

 

 

• Xcode 라이센스 동의

sudo xcodebuild -license

 

 

• CocoaPods 설치 (iOS 필수 도구)
  • 설치 방법은 2가지 중 하나를 선택하세요 

# Ruby 기반
sudo gem install cocoapods

# Homebrew 기반
brew install cocoapods

 

 

 

🤖 Android 개발 환경

• Android Studio 설치 확인
• Command-line Tools 설치 여부
• flutter doctor 실행 시 Android 관련 항목이 미완료로 표시되면, 다음 명령어로 라이선스 동의 절차를 완료할 수 있습니다:

--android-licenses

• ❗ 에러가 발생할 경우 확인해볼 수 있는 사항:
  • NDK 누락 에러 → Android Studio에서 설치
  • JDK 버전 불일치 → 에러 메시지 확인 후 JDK 변경 필요

 

 

 

🧭 기타 환경 확인

• 웹 환경 실행 가능 여부
  • Chrome  설치되어야 해요
• IDE 설정 여부
  • Visual Studio Code :  필수는 아니에요

 

 

 

 

IDE 설정 – 플러그인설치하기

 

Flutter는 IntelliJ, Android Studio, VSCode 등 다양한 IDE에서 개발할 수 있지만,

가장 많이 쓰는 건 VSCode와 Android Studio입니다.

 

 

VSCode 사용자라면?

 

1. Extension에서 Flutter만 설치하면, Dart까지 자동 설치됩니다.
2. 추천 확장 프로그램도 함께 설치해보세요:

 

 

VSCode 사용시 추천 확장프로그램

• Awesome Flutter Snippets:   다양한 Flutter 위젯 코드 스니펫 제공
• Flutter Widget Snippets:   위젯 코드 생성 자동화 지원
• Pubspec Assist:    pubspec.yaml 의존성 관리 도우미
• Error Lens:     인라인 오류 하이라이팅
• Git Lens:    Git 히스토리 및 blame 정보 시각화 등의 Git 통합 향상

 

 

 

 

Android Studio 사용자라면?

1. 플러그인 메뉴에서 Flutter 설치
2. 설치 시 Dart 플러그인도 함께 설치됨

 

 

설치만큼 중요한 마무리 – Flutter 삭제 방법

 

프로젝트 정리나 환경 재구성이 필요할 땐 Flutter를 완전히 삭제해야 할 수도 있죠.

설치 방식에 따라 삭제 방법도 다릅니다.

 

 

• Step1. 플러터 삭제

 

🗑 FVM을 사용하는 경우

1. 특정 버전 삭제

// 특정 버전 삭제하기  
fvm remove 3.32.3

 

2. FVM 자체 삭제

brew tap leoafarias/fvm  
brew remove fvm

• Step3. 캐시 삭제
  • Users/사용자 폴더
    • FVM 폴더 삭제

 

3. 사용자 홈 폴더의 캐시 제거

 

Finder 또는 터미널에서 아래 경로 삭제

 

Users/사용자 폴더

• FVM 폴더 삭제

 

 

🧹 IDE에서의 플러그인 삭제

• VSCode
• → 확장 프로그램 목록에서 Flutter/Dart 삭제
• Android Studio
• → Preferences > Plugins > Flutter > Uninstall

 

 

Flutter 설치는 끝났지만,  

진짜 앱을 만들기 위한 여정은 이제부터 시작입니다.

 

다음 글에서는 드디어 Flutter 프로젝트를 직접 생성하고,  

에뮬레이터나 실제 디바이스에서 실행해보는 과정을 함께 따라가 볼 거예요.

 

 

설치만 했는데도 이렇게 벅찼다면,  

버튼 하나 눌러 화면이 뜨는 순간은 더 짜릿할 겁니다.

 

 

 

 

---

 

 

 

혹시 설치 과정, 좀 헷갈리셨나요?

 

저도 예전에 환경 변수나 CocoaPods 세팅 때문에 며칠을 헤매고,  

한 줄 명령어를 몰라서 처음 앱 실행까지 엄청 오래 걸렸던 기억이 납니다.

 

그래서 이번 글을 정독해주신 분들께  

제가 직접 만든 Notion 체크리스트 템플릿을 드리려고 해요.

 

🧠 설치 방법부터 IDE 설정, flutter doctor 확인까지  

한 장으로 정리된 실전용 환경 점검 시트입니다.

 

 

 

 

댓글에 여러분의 첫 플러터 설치 경험을 간단히 공유해 주세요 :)

이메일도 잊지말고 함께주세요!

 

예를 들면 이런 것들!

- 처음에 환경변수 설정하다가 반나절 날렸어요 

- `flutter doctor`에 빨간 줄이 너무 많아서 좌절했었죠…

- Android Studio랑 Xcode 충돌나서 진짜 헤맸던 기억이 있어요

 

 

가벼운 한 줄도 좋아요.  

공감 가는 설치 고생담, 기다릴게요!