Flutter 开发环境搭建全流程

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

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


第一步:安装 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

💡 若无法下载:尝试用手机热点或更换网络,不推荐第三方源(按你要求)

2.2 解压 SDK

  • 解压到 无中文、无空格 的路径,例如:

    复制代码
    C:\src\flutter

第三步:配置环境变量

3.1 添加 Flutter 到 PATH

  1. 按 Win + Pause → 高级系统设置 → 环境变量

  2. 在 "用户变量" 的 Path 中添加:

    复制代码
    C:\src\flutter\bin
  3. 点"上移"到顶部 → 连点三次"确定"

3.2 设置国内加速(避免卡死)

以普通权限打开 PowerShell,运行:

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(关键!)

  1. 再次打开 环境变量
  2. 在"用户变量"中点击 "新建..."
  3. 输入:
    • 变量名 :ANDROID_HOME
    • 变量值 :C:\Users\<你的用户名>\AppData\Local\Android\Sdk
      (替换 <你的用户名> 为实际名字,如 zhangsan)

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

解决 [X] cmdline-tools component is missing

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

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


第五步:验证环境

  1. 关闭所有终端窗口
  2. 按 Win + R → 输入 cmd → 回车(新开命令提示符)
  3. 依次运行:
cmd 复制代码
flutter --version

✅ 应显示版本号(如 Flutter 3.29.3)

cmd 复制代码
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

6.2 真机调试(推荐)

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

6.3 创建并运行项目

cmd 复制代码
flutter create harvester_app
cd harvester_app
flutter run
  • 选择你的设备 → 等待编译 → App 自动安装运行!

✅ 总结:你已完成

步骤 状态
Android Studio + SDK ✅
Flutter SDK(官方来源) ✅
环境变量(PATH + ANDROID_HOME) ✅
cmdline-tools 补装 ✅
国内加速设置 ✅
真机运行第一个 App ✅
相关推荐
岁月宁静3 小时前
五、《从零手撸 Agent》 — 什么是 Agent:从“会聊天”到“会做事”,差的就是一个循环
python·agent
梯度下降者3 小时前
Python - 函数
python·高阶函数·可调用对象·functools·嵌套作用域
好的佩奇4 小时前
蓝牙之设备角色与连接
android·flutter·蓝牙
starzy19905 小时前
深入理解Scala隐式参数:上下文流转
开发语言·python·scala
wuyk5556 小时前
Spider-第16讲-线程池与竞态问题
大数据·爬虫·python·elasticsearch·搜索引擎
雨白12 小时前
Android 消息机制剖析:从 Handler 投递到 Looper 循环的全链路
android
kyle~12 小时前
FastAPI --- 将业务能力以 API 的形式提供给外部系统
python·fastapi·前后端
aiotto资源分享13 小时前
Python 写 JSON 文件,程序中途退出会留下什么?
java·python·json·jsondecodeerror
GY-9313 小时前
【Android】数据分层和依赖注入
android
梯度下降者14 小时前
Python信号量,条件变量,事件学习
python·条件变量·事件·信号量·线程通信