Flutter环境搭建 #

一、环境要求 #

1.1 操作系统要求 #

操作系统	最低要求
Windows	Windows 10 64位
macOS	macOS 10.14 (Mojave)
Linux	Debian 10+ / Ubuntu 18.04+

1.2 硬件要求 #

资源	最低要求	推荐配置
内存	8GB	16GB+
硬盘	10GB可用空间	20GB+
CPU	双核	四核+

1.3 开发目标平台要求 #

平台	要求
Android	Android SDK 21+
iOS	Xcode 15+（仅macOS）
Web	Chrome浏览器
Desktop	各平台原生SDK

二、安装Flutter SDK #

2.1 macOS安装 #

方式一：使用Homebrew（推荐）

bash

brew install flutter

方式二：手动安装

bash

cd ~/development
git clone https://github.com/flutter/flutter.git -b stable

配置环境变量：

bash

echo 'export PATH="$PATH:$HOME/development/flutter/bin"' >> ~/.zshrc
source ~/.zshrc

2.2 Windows安装 #

方式一：使用Chocolatey

powershell

choco install flutter

方式二：手动安装

下载Flutter SDK压缩包
解压到目标目录（如 C:\flutter）
添加到系统环境变量PATH

powershell

$env:Path += ";C:\flutter\bin"

2.3 Linux安装 #

bash

cd ~/development
git clone https://github.com/flutter/flutter.git -b stable
echo 'export PATH="$PATH:$HOME/development/flutter/bin"' >> ~/.bashrc
source ~/.bashrc

2.4 验证安装 #

bash

flutter --version

输出示例：

text

Flutter 3.16.0 • channel stable
Tools • Dart 3.2.0 • DevTools 2.28.0

三、运行flutter doctor #

flutter doctor 是诊断工具，检查开发环境是否完整：

bash

flutter doctor

输出示例：

text

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.16.0, on macOS 14.0)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Xcode - develop for iOS and macOS (Xcode 15.0)
[✓] Chrome - develop for the web
[✓] Android Studio (version 2023.1)
[✓] VS Code (version 1.84)
[✓] Connected device (3 available)
[✓] Network resources

• No issues found!

3.1 常见问题解决 #

问题1：Android licenses未接受

bash

flutter doctor --android-licenses

问题2：Xcode命令行工具缺失

bash

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

问题3：CocoaPods未安装（iOS开发）

bash

sudo gem install cocoapods

四、IDE配置 #

4.1 VS Code配置（推荐） #

安装扩展：

Flutter扩展（官方）
Dart扩展（官方）
Awesome Flutter Snippets（可选）
Error Lens（可选）

配置settings.json：

json

{
  "dart.lineLength": 80,
  "dart.previewFlutterUiGuides": true,
  "flutter.hotReloadOnSave": true,
  "[dart]": {
    "editor.formatOnSave": true,
    "editor.selectionHighlight": false,
    "editor.suggestSelection": "first",
    "editor.tabCompletion": "onlySnippets",
    "editor.wordBasedSuggestions": "off"
  }
}

4.2 Android Studio配置 #

安装插件：

Flutter插件
Dart插件

配置步骤：

打开 Preferences → Plugins
搜索并安装 Flutter
重启Android Studio

4.3 IntelliJ IDEA配置 #

与Android Studio类似，安装Flutter和Dart插件即可。

五、Android开发环境 #

5.1 安装Android Studio #

下载Android Studio：https://developer.android.com/studio
安装并启动
完成初始设置向导

5.2 配置Android SDK #

bash

flutter config --android-sdk /path/to/android/sdk

5.3 创建Android模拟器 #

打开Android Studio
点击 More Actions → Virtual Device Manager
点击 Create Device
选择设备型号
选择系统镜像
完成创建

命令行创建：

bash

avdmanager create avd -n flutter_emulator -k "system-images;android-34;google_apis;x86_64"

5.4 启动模拟器 #

bash

flutter emulators --launch <emulator_id>

六、iOS开发环境（仅macOS） #

6.1 安装Xcode #

从App Store安装Xcode
打开Xcode完成初始配置
安装命令行工具：

bash

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

6.2 配置iOS模拟器 #

bash

open -a Simulator

6.3 配置CocoaPods #

bash

sudo gem install cocoapods
pod setup

6.4 配置开发者账号 #

打开Xcode → Preferences → Accounts
添加Apple ID
选择开发团队

七、Web开发环境 #

7.1 启用Web支持 #

bash

flutter config --enable-web

7.2 验证Web环境 #

bash

flutter devices

应看到Chrome设备：

text

Chrome (web) • chrome • web-javascript • Google Chrome

7.3 运行Web应用 #

bash

flutter run -d chrome

八、桌面开发环境 #

8.1 macOS桌面 #

bash

flutter config --enable-macos-desktop
flutter create --platforms=macos .

8.2 Windows桌面 #

bash

flutter config --enable-windows-desktop
flutter create --platforms=windows .

8.3 Linux桌面 #

bash

flutter config --enable-linux-desktop
flutter create --platforms=linux .

九、设备连接 #

9.1 Android真机 #

开启开发者选项和USB调试
连接电脑
授权调试

bash

flutter devices

9.2 iOS真机 #

连接iPhone到Mac
在Xcode中配置签名
信任开发者证书

bash

flutter devices

9.3 无线调试 #

Android：

bash

adb tcpip 5555
adb connect <device_ip>:5555

iOS：

在Xcode中配置无线调试。

十、环境验证 #

10.1 完整检查 #

bash

flutter doctor -v

10.2 创建测试项目 #

bash

flutter create test_app
cd test_app
flutter run

10.3 常用命令 #

命令	说明
`flutter --version`	查看版本
`flutter doctor`	环境诊断
`flutter upgrade`	升级Flutter
`flutter channel`	查看渠道
`flutter devices`	查看设备
`flutter emulators`	查看模拟器
`flutter clean`	清理项目
`flutter pub get`	获取依赖

十一、版本管理 #

11.1 切换Flutter渠道 #

bash

flutter channel stable    # 稳定版
flutter channel beta      # 测试版
flutter channel dev       # 开发版
flutter channel master    # 最新版

11.2 使用FVM管理版本 #

bash

dart pub global activate fvm
fvm install stable
fvm use stable

十二、总结 #

12.1 环境检查清单 #

[ ] Flutter SDK安装完成
[ ] flutter doctor无错误
[ ] IDE配置完成
[ ] Android/iOS模拟器可用
[ ] 能成功运行测试项目

12.2 下一步 #

环境搭建完成后，让我们创建第一个应用，体验Flutter开发的魅力！