Flutter 开发环境搭建全流程

HAPPY酷

1037人浏览 · 2025-11-23 18:24:45

HAPPY酷 · 2025-11-23 18:24:45 发布

🚜 Flutter 开发环境搭建全流程（国内可用 · 2025 最新版）

✅ 基于你指定的两个官方网址：

Flutter 手动安装：https://docs.flutter.dev/install/manual

Android Studio 中文站：https://developer.android.google.cn/studio?hl=zh-cn
✅ 解决 cmdline-tools missing 问题
✅ 无需翻墙 · 无需第三方镜像（除非必要）· 真机调试

第一步：安装 Android 开发环境

1. 下载并安装 Android Studio

打开：👉 https://developer.android.google.cn/studio?hl=zh-cn
点击 “下载 Android Studio”
安装时勾选：
- ☑ Android SDK
- ☑ Android SDK Platform-Tools
- ☑ Android Virtual Device（可选）
首次启动 → 选择 “Do not import settings” → “Standard” → Finish
等待 SDK 自动下载完成 → 关闭 Android Studio

第二步：安装 Flutter SDK（严格按官方 manual）

2.1 下载 Flutter SDK

打开：👉 https://docs.flutter.dev/install/manual
根据你的系统点击下载链接（如 Windows 用户下载 .zip 文件）

💡 若无法下载：尝试用手机热点或更换网络，不推荐第三方源（按你要求）

2.2 解压 SDK

解压到 无中文、无空格 的路径，例如：
```
C:\src\flutter
```

第三步：配置环境变量

3.1 添加 Flutter 到 PATH

按 Win + Pause → 高级系统设置 → 环境变量
在 “用户变量” 的 Path 中添加：
```
C:\src\flutter\bin
```
点“上移”到顶部 → 连点三次“确定”

3.2 设置国内加速（避免卡死）

以普通权限打开 PowerShell，运行：

[Environment]::SetEnvironmentVariable("PUB_HOSTED_URL", "https://pub.flutter-io.cn", "User")
[Environment]::SetEnvironmentVariable("FLUTTER_STORAGE_BASE_URL", "https://storage.flutter-io.cn", "User")

3.3 设置 ANDROID_HOME（关键！）

再次打开 环境变量
在“用户变量”中点击 “新建…”
输入：
- 变量名：ANDROID_HOME
- 变量值：C:\Users\<你的用户名>\AppData\Local\Android\Sdk
  （替换 <你的用户名> 为实际名字，如 zhangsan）

第四步：补装缺失的 cmdline-tools

解决 [X] cmdline-tools component is missing

打开 Android Studio
点顶部菜单：Tools → SDK Manager
切换到 SDK Tools 标签页
勾选：
- ☑ Android SDK Command-line Tools (latest)
点 Apply → 等待安装完成 → 关闭

✅ 安装后路径为：
C:\Users\<用户名>\AppData\Local\Android\Sdk\cmdline-tools\latest\

第五步：验证环境

关闭所有终端窗口
按 Win + R → 输入 cmd → 回车（新开命令提示符）
依次运行：

flutter --version

✅ 应显示版本号（如 Flutter 3.29.3）

flutter doctor

✅ 正确输出应为：

[✓] Flutter (Channel stable, ...)
[✓] Android toolchain - develop for Android devices
[✓] Chrome - develop for the web
[!] Visual Studio - ...  ← 可忽略（你不开发 Windows）
[✓] Connected device

⚠️ 如果仍有 Android 错误，请确认：

ANDROID_HOME 路径正确

cmdline-tools 已安装

终端是新开的

第六步：开发与调试

6.1 安装 VS Code

官网：https://code.visualstudio.com/
安装后打开 → 安装插件：
- Flutter
- Dart

6.2 真机调试（推荐）

安卓手机：设置 → 关于手机 → 连点版本号 7 次 → 开启开发者模式
返回 → 系统 → 开发者选项 → 开启 USB 调试
USB 连接电脑 → 允许调试

6.3 创建并运行项目

flutter create harvester_app
cd harvester_app
flutter run

选择你的设备 → 等待编译 → App 自动安装运行！

✅ 总结：你已完成

步骤	状态
Android Studio + SDK	✅
Flutter SDK（官方来源）	✅
环境变量（PATH + ANDROID_HOME）	✅
cmdline-tools 补装	✅
国内加速设置	✅
真机运行第一个 App	✅