Windows에서 Dart 개발 환경 설정하기: Dart SDK, VS Code, Dart 확장
Flutter로 멋진 앱을 만들기 위해 첫걸음은 Dart 개발 환경을 설정하는 것입니다. 이 포스트에서는 Windows 환경에서 Dart SDK, Visual Studio Code(VS Code), 그리고 Dart 확장을 설치하고 설정하는 방법을 초보자도 따라 할 수 있도록 단계별로 안내하겠습니다.
왜 Dart와 VS Code인가?
Dart는 Flutter의 핵심 프로그래밍 언어로, 간결한 문법과 강력한 기능을 제공합니다. Visual Studio Code는 가볍고 확장 가능한 코드 편집기로, Dart와 Flutter 개발에 최적화된 도구를 제공합니다. Dart 확장은 VS Code에서 Dart 코드를 작성하고 디버깅하는 데 필수적인 기능을 추가합니다.
준비물
- Windows 10 또는 11 (64비트)
- 인터넷 연결
- 약 2GB의 디스크 공간
1단계: Dart SDK 설치
Dart SDK는 Dart 언어를 실행하고 컴파일하는 데 필요한 도구입니다. Flutter를 사용할 계획이라면 Flutter SDK에 Dart가 포함되어 있으므로 별도 설치가 필요 없을 수 있지만, 여기서는 독립적인 Dart 개발 환경을 설정하는 방법을 다룹니다.
Dart SDK 다운로드
- Dart 공식 사이트로 이동합니다.
- "Windows" 섹션에서 최신 안정 버전(2025년 5월 기준, Dart 3.x)을 선택합니다.
dart-sdk-windows-x64.zip
파일을 다운로드합니다.
압축 해제 및 환경 변수 설정
- 다운로드한 ZIP 파일을
C:\dart-sdk
와 같은 경로에 압축을 풉니다. - 환경 변수에 Dart SDK를 추가합니다:
- 시작 메뉴에서 "환경 변수"를 검색해 "시스템 환경 변수 편집"을 엽니다.
- "환경 변수" 창에서 "Path"를 찾아 편집합니다.
- 새 경로로
C:\dart-sdk\bin
을 추가합니다.
- 확인을 위해 명령 프롬프트(CMD)를 열고 다음 명령어를 실행합니다:
Dart 버전 정보(예: Dart SDK version: 3.x.x)가 출력되면 성공입니다!dart --version
- 다운로드한 ZIP 파일을
2단계: Visual Studio Code 설치
VS Code는 Dart와 Flutter 개발에 최적화된 무료 코드 편집기입니다.
VS Code 다운로드 및 설치
- VS Code 공식 사이트에서 Windows용 설치 파일을 다운로드합니다.
- 설치 마법사를 따라 기본 설정으로 설치합니다. "바로 가기 생성"과 "PATH 추가" 옵션을 체크하는 것이 좋습니다.
VS Code 실행
- 설치 후 VS Code를 실행하고, 익숙해지도록 인터페이스를 둘러봅니다.
- 한국어로 사용하려면 확장 마켓플레이스에서 "Korean Language Pack"을 설치하세요.
3단계: Dart 확장 설치
Dart 확장은 VS Code에서 Dart 코드를 작성하고 디버깅하는 데 필요한 기능을 제공합니다.
Dart 확장 설치
- VS Code에서 왼쪽 사이드바의 "확장" 아이콘(Ctrl+Shift+X)을 클릭합니다.
- 검색창에 "Dart"를 입력하고, "Dart" 확장(공식 제공자: Dart Code)을 찾아 "설치" 버튼을 클릭합니다.
Flutter 확장 설치(선택 사항)
- Flutter 개발을 계획 중이라면 "Flutter" 확장도 설치하세요. Dart 확장과 함께 작동하며, Flutter 위젯 작성과 디버깅을 지원합니다.
- 검색창에 "Flutter"를 입력하고, "Flutter" 확장(공식 제공자: Dart Code)을 설치합니다.
설정 확인
- Dart 확장이 설치되면 VS Code에서
.dart
파일을 열 때 자동으로 코드 강조, 자동 완성, 오류 감지 기능이 활성화됩니다. - Flutter 확장을 설치했다면, Flutter SDK도 설치해야 합니다(아래 참고).
- Dart 확장이 설치되면 VS Code에서
4단계: 첫 Dart 프로그램 작성
환경 설정이 완료되었으니 간단한 Dart 프로그램을 작성해 봅시다.
프로젝트 폴더 생성
- 원하는 위치(예:
C:\dart-projects
)에my_first_dart
폴더를 만듭니다.
- 원하는 위치(예:
VS Code에서 폴더 열기
- VS Code에서 "파일 > 폴더 열기"를 선택해
my_first_dart
폴더를 엽니다.
- VS Code에서 "파일 > 폴더 열기"를 선택해
Dart 파일 생성
- 폴더 내에서
main.dart
파일을 생성합니다. - 아래 코드를 입력합니다:
void main() { print('Hello, Dart on Windows!'); }
- 폴더 내에서
코드 실행
- VS Code에서 터미널을 엽니다(Ctrl+`).
- 다음 명령어를 입력해 프로그램을 실행합니다:
dart run main.dart
- 터미널에 "Hello, Dart on Windows!"가 출력되면 성공입니다!
5단계: Flutter SDK 설치(선택 사항)
Flutter 개발을 위해 Dart를 배우는 경우, Flutter SDK를 설치해야 합니다. Flutter SDK에는 Dart SDK가 포함되어 있으므로, 위에서 설치한 Dart SDK를 대체할 수 있습니다.
Flutter SDK 다운로드
- Flutter 공식 사이트에서 Windows용 Flutter SDK를 다운로드합니다.
- ZIP 파일을
C:\flutter
와 같은 경로에 압축 해제합니다.
환경 변수 설정
- 환경 변수 "Path"에
C:\flutter\bin
을 추가합니다. - 명령 프롬프트에서
flutter --version
을 실행해 설치 여부를 확인합니다.
- 환경 변수 "Path"에
Flutter Doctor 실행
- 다음 명령어를 실행해 Flutter 환경을 점검합니다:
flutter doctor
- 누락된 도구(예: Android Studio, Xcode)가 있다면 안내에 따라 설치합니다.
- 다음 명령어를 실행해 Flutter 환경을 점검합니다:
문제 해결 팁
- Dart 명령어가 작동하지 않을 때: 환경 변수 Path에
C:\dart-sdk\bin
또는C:\flutter\bin
이 올바르게 추가되었는지 확인하세요. - VS Code에서 Dart 코드 강조가 안 될 때: Dart 확장이 제대로 설치되었는지, VS Code를 재시작했는지 확인하세요.
- Flutter Doctor 오류:
flutter doctor
의 안내를 따라 필요한 도구를 설치하거나, Flutter 커뮤니티에서 도움을 구하세요.
추천 자료:
- Dart 공식 사이트
- Flutter 공식 사이트
- VS Code 공식 사이트
- DartPad - 온라인 Dart 코드 테스트