Dart SDK와 VS Code 설치

Dart로 실전 프로젝트를 시작하려면 개발 환경부터 탄탄하게 갖춰야 합니다. 이번 챕터에서는 Dart SDK 설치부터 VS Code 설정, 터미널 환경 확인까지 한 번에 정리합니다.

Dart SDK 설치

Dart SDK는 공식 채널과 패키지 매니저 두 가지 방법으로 설치할 수 있습니다. 실무에서는 버전 관리가 쉬운 패키지 매니저 방식을 권장합니다.

macOS — Homebrew

# Homebrew가 없다면 먼저 설치합니다/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# Dart SDK 설치brew tap dart-lang/dartbrew install dart# 설치 확인dart --version

Windows — Chocolatey

# PowerShell (관리자 권한)choco install dart-sdk# 설치 확인dart --version

Windows — winget

winget install Google.DartSDK

Linux — apt (Ubuntu/Debian)

# GPG 키 및 저장소 추가sudo apt-get updatesudo apt-get install apt-transport-httpswget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub \  | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpgecho 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' \  | sudo tee /etc/apt/sources.list.d/dart_stable.list# 설치sudo apt-get updatesudo apt-get install dart# 설치 확인dart --version

공식 인스톨러 (플랫폼 무관)

직접 설치 파일을 받고 싶다면 dart.dev/get-dart 에서 운영체제별 ZIP/exe를 내려받을 수 있습니다.

PATH 설정 확인

패키지 매니저로 설치한 경우 PATH가 자동으로 잡히지만, 직접 설치했다면 수동으로 추가해야 합니다.

# macOS/Linux — ~/.zshrc 또는 ~/.bashrc에 추가export PATH="$PATH:/usr/lib/dart/bin"# 반영source ~/.zshrc# 확인which dartdart --version# Dart SDK version: 3.x.x (stable) ...

Windows는 "시스템 환경 변수 편집 → Path"에 C:\tools\dart-sdk\bin을 추가합니다.

VS Code 설치

VS Code는 code.visualstudio.com에서 내려받습니다. 설치 후 두 가지 확장을 반드시 설치해야 합니다.

Dart 확장

Dart 언어 지원의 핵심입니다. 코드 완성, 타입 검사, 디버깅, dart analyze 통합을 제공합니다.

1. VS Code 왼쪽 사이드바에서 Extensions (Ctrl+Shift+X / Cmd+Shift+X) 클릭합니다.
2. Dart 검색 후 Dart (dart-code.dart-code) 설치합니다.

Flutter 확장 (선택)

Flutter 개발을 함께 한다면 Flutter 확장도 설치합니다. Flutter 확장은 Dart 확장을 포함합니다.

1. Extensions에서 Flutter 검색 후 Flutter (dart-code.flutter) 설치합니다.

Dart 확장만 설치해도 Dart 서버, CLI 도구, 패키지 개발은 모두 할 수 있습니다.

VS Code Dart 확장 주요 기능

터미널 설정

Dart 개발은 터미널과 함께합니다. VS Code 내장 터미널을 기본으로 사용하고, 기본 셸을 지정해둡니다.

VS Code 기본 셸 지정 (macOS)

// settings.json (Cmd+Shift+P → "Open User Settings JSON"){  "terminal.integrated.defaultProfile.osx": "zsh",  "terminal.integrated.fontSize": 14,  "dart.lineLength": 120}

VS Code 기본 셸 지정 (Windows)

{  "terminal.integrated.defaultProfile.windows": "PowerShell",  "dart.lineLength": 120}

터미널에서 dart 명령어 확인

# SDK 버전dart --version# 내장 도구 목록dart help# 자주 쓰는 명령어dart run        # 프로젝트 실행dart test       # 테스트 실행dart analyze    # 정적 분석dart format     # 코드 포맷dart pub get    # 패키지 설치dart fix        # 자동 수정

Dart SDK 구성 요소

SDK를 설치하면 다음 도구들이 함께 들어옵니다.

설치 검증

모든 설정이 올바른지 한 번에 확인합니다.

# 1. SDK 버전 확인dart --version# Dart SDK version: 3.5.0 (stable) ...# 2. 간단한 코드 즉시 실행dart eval "print('Dart 개발 환경 준비 완료');"# Dart 개발 환경 준비 완료# 3. pub 저장소 접근 확인dart pub global list

VS Code에서도 확인합니다.

1. VS Code를 열고 .dart 파일을 새로 만듭니다 (Cmd+N 후 저장).
2. 하단 상태바에 Dart 아이콘이 표시되면 확장이 정상 동작 중입니다.
3. main() 을 입력하면 코드 완성 팝업이 나타나야 합니다.

자주 발생하는 설치 문제

dart 명령어를 찾을 수 없다 (command not found)

PATH가 올바르지 않은 경우입니다. which dart가 빈 결과를 반환한다면 PATH를 다시 확인합니다.

# Homebrew로 설치한 경우 경로 확인brew --prefix dart-lang/dart/dart# /opt/homebrew/opt/dart

VS Code에서 Dart 확장이 SDK를 못 찾는다

명령 팔레트(Cmd+Shift+P)에서 Dart: Change SDK를 실행하고 SDK 경로를 직접 지정합니다.

// settings.json{  "dart.sdkPath": "/usr/lib/dart"}

macOS Gatekeeper 차단

직접 다운로드한 경우 보안 경고가 뜰 수 있습니다.

xattr -d com.apple.quarantine /path/to/dart-sdk

정리

이번 챕터에서 다음 내용을 설정했습니다.

• 운영체제별 Dart SDK 설치와 PATH 설정
• VS Code와 Dart/Flutter 확장 설치
• 터미널 기본 셸과 VS Code 기본 설정
• 설치 검증 방법과 자주 발생하는 문제 해결

다음 챕터에서는 실제로 Dart 프로젝트를 생성하고 실행해봅니다.