Windows 11에서 Flutter 개발 환경 완벽 설정 가이드

Flutter를 Windows 11에서 처음 설정하는 분들을 위해 VS Code 설치부터 Android Studio, 에뮬레이터 실행까지 전 과정을 친절하게 설명합니다. 흔히 겪는 오류 해결법까지 포함한 실전형 가이드입니다.

 

VS Code + Android Studio + 에뮬레이터 + 오류 해결까지

Flutter는 단일 코드로 iOS와 Android 앱을 동시에 개발할 수 있는 Google의 강력한 UI 프레임워크입니다.
이 글에서는 Windows 11 환경에서 Flutter를 처음 설정하는 개발자나 입문자를 위해 VS Code, Flutter SDK, Android Studio, AVD 설정까지 한 번에 정리된 실전 가이드를 제공합니다.
추가로, 설정 중 흔히 마주치는 오류들과 그 해결법도 상세히 담았어요.

 

1. Visual Studio Code 설치

1. VS Code 공식 페이지에서 Windows용 설치 파일 다운로드
2. 설치 파일 실행 → 일반 설치 방식대로 진행

---

2. Flutter SDK 설치 및 환경 변수 설정

1. Flutter 공식 가이드 (Windows)에서 최신 안정 버전 다운로드
2. 압축 해제 위치는 C:\flutter 등 권한 문제 없는 경로로 설정
3. 환경 변수 편집 → Path에 C:\flutter\bin 추가
4. 명령어로 설치 확인:
    

flutter doctor

---

3. Android Studio 설치

1. Android Studio 공식 페이지에서 다운로드 후 설치
2. 설치 중 Android Virtual Device 항목 포함되었는지 확인
3. Android SDK Manager에서 다음 구성요소 설치 확인:
   • Android SDK Build-Tools
   • Android SDK Command-line Tools
   • Android Emulator
   • Android SDK Platform-Tools

---

4. Android SDK 설정

1. Android Studio에서 SDK 위치 확인 (예: C:\Users\사용자명\AppData\Local\Android\Sdk)
2. Flutter에 SDK 경로 등록:
   

   flutter config --android-sdk C:\Users\user\AppData\Local\Android\Sdk

3. 라이선스 동의:
   

   flutter doctor --android-licenses

---

5. Android 에뮬레이터 설정 (AVD Manager)

1. Android Studio → Tools > AVD Manager
2. 새 가상 기기 생성 (Pixel 6 등 추천)
3. 시스템 이미지: x86_64 아키텍처 기반 이미지 사용 권장
4. Graphics 옵션: Hardware - GLES 2.0 또는 Automatic 설정
5. 에뮬레이터 실행 후 다음 명령으로 인식 확인:
   

   flutter devices

 

---

6. Windows 개발자 모드 활성화

Flutter 플러그인이 symlink를 사용하므로 개발자 모드를 켜야 합니다.
Windows 설정 → 개발자용 → 개발자 모드 활성화

 

또는 Win + R 키를 눌러 실행 창을 실행 시키고, 열기 항목에 ms-settings:developers 를 붙여넣으면 바로 해당 설정으로 이동합니다. 

---

✅ 마무리: flutter doctor로 최종 점검

마지막으로 다시 한 번 flutter doctor를 실행해 전체 설정 상태를 확인하세요.
모든 항목이 초록색 체크(✓)로 나올 때까지 하나씩 해결하면 됩니다.

 

🔧 흔한 오류 & 해결법 요약

오류 메시지해결 방법

X Android toolchain - Unable to locate Android SDK	flutter config --android-sdk로 경로 지정
Android license status unknown	flutter doctor --android-licenses 실행 후 y 입력
VS Code에서 디바이스 인식 안 됨	에뮬레이터 재실행, flutter devices 확인

 

---

📦 결론

이제 Flutter 개발 환경 설정은 끝났습니다!
VS Code에서 새 Flutter 프로젝트를 시작하고, 방금 만든 에뮬레이터에서 실행해보세요.
Flutter는 처음만 조금 까다롭고, 이후엔 정말 빠르고 즐거운 개발 환경이 될 거예요. 🚀