1. 装不上不是手笨Flutter 环境到底在拼什么我见过太多人卡在 Flutter 环境搭建这一步然后得出一个结论我不适合写代码。实际上大概率不是这样。前阵子帮一位同事看他那台开发机他折腾了整整两个晚上flutter doctor出来一屏红叉最后发现根本原因只是他把 SDK 解压到了一个路径里带空格的文件夹。改完路径十分钟跑通。这件事让我意识到绝大多数 Flutter 环境搭建失败问题不在操作者而在于没有人提前告诉他这套东西到底由几块拼起来、它们之间是什么依赖关系。所以这篇内容我打算换个讲法。不直接甩一堆下载链接让你照着点下一步而是先讲清楚 Flutter 环境搭建到底在拼一条什么样的工具链每一块负责什么谁依赖谁然后再进入具体操作。这套思路对完全没接触过移动开发的小白同样适用对之前搭过但总是出问题的同学会更有用因为你终于知道自己是在修哪一颗螺丝。Flutter 环境搭建的本质是把能写 Dart 代码和能把 Dart 代码编译成能在手机或模拟器上运行的安装包这两件事之间的所有中间环节接通。中间环节一个没通你写出来的代码就只是一堆文本文件。理解这一点后面所有的报错你都能大概猜出它在抱怨哪一段。1.1 一条三层工具链SDK、Android 工具链、编辑器把 Flutter 环境拆开看其实是三层东西叠在一起从下往上分别是Flutter SDK 本身、平台工具链主要是 Android 那一套、编辑器与插件。最底下那层是 Flutter SDK。它是一个压缩包解压出来是一堆 Dart 代码和预编译的命令行工具核心就是一个叫flutter的可执行文件。这一层负责的事情是把你的 Dart 代码编译成目标平台能认识的产物同时提供flutter create、flutter run、flutter doctor这些命令。它自己是自包含的解压出来就能用但有一个隐性依赖它需要系统里有 Git因为 Flutter 的版本判断、升级、渠道切换都走 Git 那一套逻辑。这一点很少有人提前说导致有些精简系统上flutter --version报出奇怪的版本号。中间那层是平台工具链。你要跑 Android 应用就得有 Android SDK、构建工具、平台工具、许可证以及一个能运行 APK 的设备或模拟器。这一层是整条链里最庞大也最容易出问题的部分因为它由一堆互相依赖的组件组成缺一个就编译不过版本对不上也编译不过。你要跑 iOS还得再加 Xcode 和 CocoaPods并且只能在 macOS 上做。最上面那层是编辑器。它不参与编译只负责给你补全、调试、热重载按钮这些东西。VS Code 和 Android Studio 都能干这活选哪个都不影响最终能不能跑起来。1.2 三层里最容易出问题的是哪一层我在帮别人排查的时候会先做一个粗筛让他把报错截图发过来看一眼是文档类错误还是编译类错误基本就能定位到哪一层。层级组成出问题的典型表现排查入口Flutter SDK 层Dart SDK、flutter 命令、引擎产物命令找不到、版本号异常、创建项目失败flutter --version、where flutter平台工具链层Android SDK、构建工具、平台工具、许可证、模拟器编译中断、找不到设备、Gradle 卡住flutter doctor、flutter devices编辑器层VS Code / Android Studio 及插件没补全、不能断点、热重载按钮灰掉插件是否启用、是否识别到 SDK 路径这张表的价值在于当你看到报错时先别急着搜错误原文先判断它属于哪一层。属于 SDK 层的错误去查环境变量属于平台层的错误去查 Android SDK 和许可证属于编辑器层的去查插件配置。我见过有人把编辑器插件没装的问题当成 SDK 装坏了重装了三次 SDK纯属白费时间。还有一点要提前说清楚这三层是有严格顺序的。你必须先把 SDK 层搞定才能验证平台层平台层通了编辑器的插件才有意义。很多教程把这几件事混在一起讲导致你照着做完也不知道哪一步错了。下面的内容我会严格按这个顺序推进。2. 动手前三项硬检查磁盘、路径、终端权限正式下载之前有三件事必须先确认。跳过这三项后面大概率要在某一步莫名其妙地失败而且失败得很隐蔽报错信息完全不指向真正的原因。2.1 磁盘与目录规划为什么不建议装在默认位置先说空间。一个完整的 Flutter 开发环境SDK 本身解压后占用几个 GBAndroid SDK 加上构建工具和至少一个平台版本又是好几个 GB模拟器镜像单独算一个 x86_64 的镜像也要一两个 GB再加上每个项目第一次构建时会往用户目录下的缓存里塞 Gradle 依赖和引擎产物。我的经验值是留出 20GB 以上的空闲空间低于 10GB 你会在某个构建步骤上撞到磁盘不足而且那个报错往往不是磁盘不足而是某个文件写入失败很难一眼看出来。再说位置。Windows 上很多人习惯把东西丢在下载文件夹或者桌面macOS 上习惯丢在用户目录下的下载里。这些位置能用但有风险。我更推荐的目录结构是专门建一个开发目录比如 Windows 下D:\dev\macOS 下~/development/然后在里面分门别类D:\dev\flutter\ - Flutter SDK 解压到这里 D:\dev\android-sdk\ - Android SDK 独立存放 D:\dev\projects\ - 所有项目代码这么规划的理由有三条。第一SDK 和项目代码分开将来换 SDK 版本或者删某个项目的时候不会互相牵连。第二Android SDK 不要放在 Android Studio 的默认安装目录里那个目录升级的时候可能被覆盖或者权限受限。第三所有路径都在一个根下配环境变量的时候不容易写错。macOS 和 Linux 上还有一个额外注意点不要用sudo去解压 SDK 或者创建目录。用sudo解压出来的文件属主是 root后续你自己这个用户去读写就会遇到权限问题而且这个问题的报错非常不直观。用普通用户身份在家目录下操作就行。2.2 中文与空格路径一个能让编译失败的低级错误开头提到的那个案例就是这个。路径里出现中文或者空格会在这几个环节炸掉Gradle 构建时某些插件对路径的解析、部分命令行工具的参数传递、以及一些构建脚本里的路径拼接。具体来说C:\Users\张三\Desktop\flutter这种路径有三重风险用户名是中文、桌面是中文、路径里有空格风险如果放在我的文档之类。C:\Program Files\flutter这种则是纯空格问题同样会挂。判断标准很简单路径中只允许英文字母、数字、下划线、短横线目录之间用反斜杠或正斜杠分隔不出现空格、中文、括号、之类的符号。检查方法也很直接在终端里把这个路径复制出来看一眼就知道。如果用户名本身是中文怎么办那就不要把 SDK 放在用户目录下。Windows 上直接放D:\dev\macOS 上虽然用户目录名一般是英文但保险起见也建议在~/development/这种自建目录下操作。项目代码同理不要放在桌面或者文档里。这一条看起来很基础但它是真实排查中命中率最高的原因之一。我在帮人看问题时第一句问的往往是你把 SDK 放哪了路径发我看看一半的问题在这一步就定位了。2.3 Windows 执行策略与 macOS 权限的两套处理Windows 上的坑主要在 PowerShell 的执行策略。Flutter 的部分脚本和 Android 的构建脚本会调用 PowerShell如果执行策略是默认的Restricted某些脚本会被拒绝执行报错信息通常是一大段红色文字说无法加载文件因为在此系统上禁止运行脚本。处理方式是以管理员身份打开 PowerShell执行Set-ExecutionPolicy -Scope CurrentUser RemoteSignedRemoteSigned的意思是本地脚本可以直接跑从网络下载的脚本需要有签名。这个级别对日常开发足够也不会把策略完全放开。执行完可以用Get-ExecutionPolicy -Scope CurrentUser确认一下。macOS 和 Linux 上主要是权限问题。两个地方要注意一是前面说的不要用sudo解压二是如果你从网络下载了 SDK 压缩包解压后可能需要给bin目录下的文件加执行权限。正常情况下官方的压缩包会保留权限但如果你用的是某些解压工具可能会丢掉。遇到flutter: command not found或者Permission denied的时候可以这样修chmod -R ux ~/development/flutter/bin另外 macOS 上第一次运行从网络下载的可执行文件系统可能会拦一下需要在系统设置 - 隐私与安全性里允许。这个提示是一次性的允许之后不会再出现。3. SDK 落地下载、解压、环境变量、验证的固定顺序这一层是整条链的地基只要这一层稳了后面的事情都是可以慢慢修的。我建议严格按下载 - 解压 - 配环境变量 - 验证这个顺序走中间不要跳步因为每一步的输出都是下一步的前提。3.1 stable 通道不是保守是省事Flutter 有几个版本通道stable、beta、dev、master。给新手的建议只有一个字用 stable。理由不是 stable 功能少而是 stable 的产物是完整的、文档是对得上的、社区里搜到的报错大概率也是 stable 上的。beta 和 master 通道会带来两种麻烦一是某些 API 可能刚好在你用的那个提交上被改了一半编译报错的原文搜不到任何人讨论过二是引擎产物的下载源和缓存结构可能和 stable 不一致本地缓存容易出现奇怪的冲突。有人会问我需要的某个特性只在 beta 上有怎么办我的建议是先用 stable 把环境跑通确认整条链没问题再考虑切通道。切通道的命令是flutter channel beta后接flutter upgrade但它会触发一次较大的更新如果此时环境还没跑通你根本分不清是新版本的锅还是原来的锅。下载渠道方面官方提供的是压缩包Windows 是 zipmacOS 是 zipLinux 是 tar.xz。国内下载速度可能不理想可以留意官方文档里提到的公开镜像站通常通过两个环境变量来指定这部分在下一节一起讲。3.2 环境变量到底该配几个环境变量这一块是最容易配多也最容易配少的地方。配多了可能引入冲突配少了命令找不到。我把必需和可选分开列你对照着装。变量名是否必需值作用PATH必需追加SDK路径/bin让系统能找到flutter命令PUB_HOSTED_URL可选公开镜像地址加速 Dart 包下载FLUTTER_STORAGE_BASE_URL可选公开镜像地址加速引擎产物下载ANDROID_HOME建议Android SDK 路径部分工具依赖它定位 SDKANDROID_SDK_ROOT建议同上新版构建工具用这个PATH是最核心的一条必须把 Flutter SDK 的bin目录加进去。Windows 上在系统属性 - 环境变量 - 用户变量 - Path里新建一条填完整路径比如D:\dev\flutter\bin。注意不要写成D:\dev\flutter\bin\末尾的反斜杠有时候会带来奇怪的问题。macOS 和 Linux 上编辑~/.zshrc或~/.bashrc加一行export PATH$HOME/development/flutter/bin:$PATH这里有个细节$PATH要放在后面表示把新路径插到最前面这样如果你系统里原来有别的同名命令会优先用你刚配的这个。改完要source ~/.zshrc让它生效或者直接开一个新终端窗口。另外两个镜像变量是可选的作用是把包和引擎产物的下载地址指向国内可访问的公开镜像能明显缩短第一次下载的等待时间。这两个变量是可选的如果你网络状况本来就良好不配也能正常跑。配的时候注意是在配置环境变量之前就设好因为flutter --version第一次执行时就会去拉 Dart SDK 和引擎产物如果那时候还没配镜像它已经按默认地址拉过了后面再配也得先清缓存。ANDROID_HOME严格来说在 Flutter 命令里不是必需的因为它会自己去默认位置或者通过flutter config指定的位置找 Android SDK。但很多第三方工具和脚本依赖这个变量所以建议一起配上省得以后踩坑。3.3 第一次执行 flutter --version 卡住是正常的配完环境变量开一个全新的终端窗口这一步很重要旧窗口读不到新变量执行flutter --version如果你看到命令卡在那里几十秒甚至几分钟没有任何输出不要以为坏了。第一次执行时Flutter 会做几件事检查 Git 状态、下载当前版本对应的 Dart SDK、下载引擎产物、初始化缓存目录。这些动作全部走网络而且体积不小。在没有配镜像的情况下这一步慢是常态。判断它是在下载还是真挂了有个简单办法看缓存目录的文件是否在增长。缓存目录一般在 SDK 目录下的.pub-cache或者用户目录下的.flutter里Windows 上也可以直接看任务管理器有没有网络流量。如果几分钟后还是完全没动静可以按 CtrlC 中断检查一下网络和镜像变量然后重试。成功的话你会看到类似这样的输出Flutter 3.x.x • channel stable • https://github.com/flutter/flutter.git Framework • revision xxxxxxx (x weeks ago) • 202x-xx-xx Engine • revision xxxxxxx Tools • Dart 3.x.x • DevTools 2.x.x这里要重点看两个东西。一是channel stable确认你用的是稳定通道。二是后面的 Dart 版本号记住了将来遇到某个包要求 Dart 版本不低于 X的时候要用。如果这里显示的版本号很奇怪比如0.0.0-unknown那通常是 Git 相关的判断失败了检查系统里 Git 是否安装、SDK 目录下的.git文件夹是否完整。4. Android 工具链SDK、许可证、模拟器的连锁反应Flutter SDK 通了之后第二个大关是 Android 工具链。这一层的组件比 SDK 层多得多而且它们之间的版本约束更严格。我按装什么 - 接受什么 - 跑在哪的顺序讲。4.1 Android Studio 只是外壳真正的活是 SDK 和命令行工具新手常见的误解是装好 Android Studio 就等于装好 Android 环境了。不完全是。Android Studio 是一个 IDE它自带一个 SDK 管理界面但你真正需要的是 SDK 里的几组组件。安装 Android Studio 的过程中会有一个步骤询问是否安装 SDK勾上就行。装完之后打开 IDE进入 SDK 管理器不同版本入口位置略有差异一般在设置里搜 SDK 能找到确认这几项是勾选状态Android SDK Platform至少一个版本建议选一个较新的稳定版本。这是编译目标平台。Android SDK Build-Tools至少一个版本建议选较新的。这是实际执行打包的工具。Android SDK Platform-Tools必须。里面包含adb连真机和模拟器都靠它。Android SDK Command-line Tools必须。sdkmanager、avdmanager这些命令行工具在这里flutter doctor会检查它。Android Emulator如果你要用模拟器必须。这里有个经验不要贪多。有些人一上来把从 Android 5 到最新的所有平台版本全部勾上下载几十个 GB然后磁盘满了。实际上 Flutter 项目默认编译目标是一个较新的版本再按需加上你想兼容的低版本就行。我第一次装的时候就是全勾光下载花了大半天后来发现 90% 的组件从来没被用到过。装完之后让 Flutter 知道 Android SDK 在哪。如果是默认位置通常能自动识别如果是自定义位置推荐自定义执行flutter config --android-sdk D:\dev\android-sdkmacOS 上路径换成对应的即可。这条命令会把配置写进 Flutter 的全局配置文件之后flutter doctor就能找到了。4.2 许可证没接受后面所有命令都会莫名失败这是新手环境搭建里最经典的一个坑Android SDK 装好了组件也齐了但许可证没接受于是flutter doctor显示 Android 工具链有问题或者更糟flutter run跑到一半失败报错信息和许可证完全没关系。处理方式是执行flutter doctor --android-licenses然后一路按y回车。这里有个细节必须把所有列出来的许可证都接受完中途按了n或者直接 CtrlC 退出下次还得重来而且状态可能是不完整的。有时候你会看到某个许可证反复出现让你确认那是正常的全部接受就行。如果这条命令报错说找不到sdkmanager说明 Command-line Tools 没装或者路径不对回到上一节检查。如果报错说 Java 版本不对那是另一个问题通常是 Android Studio 自带的 JDK 和你系统里的 JDK 冲突可以让 Flutter 用 Android Studio 自带的那一个flutter config --jdk-dir Android Studio安装目录/jbr许可证这件事我特别想强调因为它的表现形式太有迷惑性了。有次一个朋友说他的项目编译报错贴出来的错误里有一行提到某个 task 失败看着像依赖问题。我让他先跑一下flutter doctor果然 Android 工具链那一项是红的根因就是许可证。养成习惯任何构建失败先跑flutter doctor别急着看具体报错。4.3 模拟器起不来虚拟化、内存、镜像 ABI模拟器是这一层里最吃资源也最容易出问题的部分。常见现象是创建了虚拟设备点启动转圈半天然后什么都没发生或者直接报错退出。原因基本集中在三块。第一是硬件虚拟化没开。模拟器需要 CPU 的虚拟化支持Intel 平台需要 VT-xAMD 平台需要 AMD-V这些都要在 BIOS 里开启。开启之后Windows 上还需要系统层面的支持组件Intel 平台传统上是 HAXM新版更推荐 Windows Hypervisor PlatformAMD 平台基本只能走 Windows Hypervisor Platform。macOS 上 Apple Silicon 机型不需要额外组件但必须用 arm64 架构的系统镜像用 x86 镜像会非常慢甚至起不来。第二是内存分配。虚拟设备创建时可以设置内存默认值有时候偏小导致系统启动到一半卡死。建议给到 2GB 以上宿主机器内存充裕的话 4GB 更舒服。同时磁盘空间也要留意虚拟设备会占用独立的磁盘文件。第三是系统镜像选择。在创建虚拟设备的界面上会列出一堆镜像带 Google APIs 的和带 Play 商店的以及不同 API 版本的。我的建议是先选一个较新 API 版本的、不带 Play 商店的镜像体积小、启动快、权限宽松适合开发调试。带 Play 商店的镜像有额外限制比如不能用 root某些调试功能会受限。创建完之后用flutter emulators列出已有设备用flutter emulators --launch 设备名启动。启动之后等系统完全进入桌面再执行flutter devices能看到设备就说明打通了。5. flutter doctor 红叉逐条清按依赖顺序而不是按心情flutter doctor是这套环境里最重要的一个命令它把前面三层的情况汇总成一张清单。但很多人用错了它的方式看到几个红叉随手挑一个开始修修完发现别的又红了反复折腾。5.1 为什么不能看到红叉就乱修flutter doctor的输出是有依赖顺序的。上面几项是基础下面几项依赖上面。如果 Flutter SDK 那一项本身有问题后面 Android 工具链的检查结果就不可信因为检查逻辑本身就跑不通。正确的方式是从上往下一项一项清。清完一项重新跑一次flutter doctor再看下一项。这个顺序看起来慢实际上比乱修快得多因为你能明确知道每一次改动带来了什么变化。还有一类输出要区分红叉和感叹号。红叉表示这项检查失败相关功能不可用感叹号表示检查通过但有问题通常不影响基本使用。比如某个可选组件没装、某个设备离线、某个版本偏旧都会是感叹号。搞清楚这一点能省下大量纠结。5.2 常见红叉成因与处理对照我把实际遇到过的红叉整理成一张表按出现频率排序。报错关键词真实原因处理方式Unable to locate Android SDKSDK 路径没配或配错flutter config --android-sdk 路径Android license status unknown许可证未接受flutter doctor --android-licensescmdline-tools component is missing命令行工具没装SDK 管理器补装 Command-line ToolsNo devices found没有可用设备或驱动问题flutter devices排查真机开调试模式Xcode not installedmacOS 上想跑 iOS 但没装 Xcode只做 Android 可忽略或装 XcodeCocoaPods not installediOS 依赖管理缺失装 CocoaPods仅在跑 iOS 时需要HTTP host ... is not reachable网络访问不到某些源检查镜像变量重试表格里的最后一项要注意它有时候是误报特别是在网络不稳定的时候。遇到这类提示先重试一次如果反复出现再处理。除了这张表还有一类问题不在flutter doctor的检查范围内但同样会让环境不可用Gradle 相关的配置。这个留到下一节讲因为它是构建阶段的问题不是环境检查阶段的问题。5.3 一次完整的排查链路还原我把自己最近一次在一台全新机器上搭环境的实际过程写出来你可以对照自己的情况看卡在哪一步。第一步解压 SDK 到D:\dev\flutter配好PATH和两个镜像变量开新终端跑flutter --version。输出正常通道是 stable这一步花了几分钟下载 Dart SDK属于正常。第二步装 Android StudioSDK 位置设成D:\dev\android-sdk在 SDK 管理器里勾了 Platform、Build-Tools、Platform-Tools、Command-line Tools、Emulator 五项。下载花了一段时间体积不小。第三步flutter config --android-sdk D:\dev\android-sdk然后flutter doctor。此时 Flutter 一项是绿的Android 工具链一项是红的提示许可证未知。第四步flutter doctor --android-licenses全部按 y。再跑flutter doctorAndroid 工具链变绿。到这里 Android 侧基本通了。第五步创建一个虚拟设备启动flutter devices能看到。此时flutter doctor里除了 iOS 相关的几项因为不是 macOS其余全绿。整个流程走下来大概 40 分钟其中下载占了八成时间。如果中途某一步卡住超过十五分钟没有进展基本可以判定是网络或者配置问题不要干等。6. 第一个项目跑起来从 flutter create 到热重载环境检查全绿之后就可以创建第一个项目了。这一步看似简单但有几个细节会让人卡住。6.1 项目名不是随便起的flutter create后面跟的是项目名这个名字有硬性规则只能用小写字母、数字、下划线不能以数字开头不能是 Dart 的保留字。你写MyApp会直接报错写flutter-demo也会报错因为短横线不合法。正确的方式cd D:\dev\projects flutter create my_first_app创建过程会生成一整套目录结构同时自动执行一次pub get拉取依赖。这一步如果卡住通常是包下载的问题检查PUB_HOSTED_URL那个变量是否生效。创建完之后看一眼目录几个关键位置心里有个数my_first_app/ lib/ - 你写代码的地方main.dart 是入口 android/ - Android 平台相关配置Gradle 脚本在这 ios/ - iOS 平台相关配置 test/ - 测试代码 pubspec.yaml - 依赖声明文件相当于配置文件新手最容易犯的错误是去改android/或者ios/下面的原生代码除非你确实要做平台相关的定制否则日常开发碰不到那里。业务逻辑全在lib/下。6.2 第一次构建卡在 Running Gradle task 的真实原因项目创建好了执行flutter run然后大概率会看到这么一行Running Gradle task assembleDebug...然后就一直停在那里五分钟、十分钟没有任何新输出。这是新手环境搭建里最常见的假死现象。真实原因有三件事同时在发生。第一Gradle 本身是个构建工具它需要下载自己的发行包体积不小。第二项目依赖的 Android 插件需要从远程仓库下载这些仓库默认在海外访问可能很慢。第三所有下载完成之后才轮到你项目的实际编译。处理方向有两个。一个是减少下载量另一个是换更快的源。前者靠耐心第一次构建完之后依赖会被缓存到本地第二次构建就快了。后者需要在项目里配置仓库镜像具体是在android目录下的构建脚本里把仓库地址指向国内公开的 Maven 镜像同时可以在 Gradle 属性文件里调大网络超时时间。这里要提醒一句不要在构建过程中反复 CtrlC。中断之后 Gradle 的缓存可能处于不完整状态下次构建会更乱。如果确实要中断中断之后先清一下缓存再重来。判断它是否真的在下载可以看用户目录下 Gradle 缓存目录的文件是否在变大。第一次构建成功之后后面就顺畅了。我实测过第一次完整构建在配置好镜像的情况下大概三到五分钟没配镜像可能要十几分钟甚至更久。6.3 真机比模拟器省事的三个理由构建通了之后flutter run会问你要在哪个设备上跑。这里我强烈建议新手的第一个项目用真机而不是模拟器。理由一是启动速度和资源占用。模拟器本质上是一台跑在你电脑里的虚拟机启动要一分多钟运行吃内存吃 CPU笔记本风扇会明显吵起来。真机插上就能用几乎零等待。理由二是真实度。模拟器上的性能表现、触摸手感、字体渲染都和你最终用户拿到的设备有差异。有些布局问题只在真实设备的小屏幕上暴露模拟器的分辨率往往偏大看不出来。理由三是调试便利。真机开启开发者模式和 USB 调试之后执行flutter devices就能看到flutter run直接装到手机上。热重载一样可以用摇一摇手机或者按终端里的r键触发。真机连接不上是另一个常见问题通常出在驱动或者授权上。Windows 上可能需要装对应厂商的 USB 驱动Android 手机上第一次连接会弹一个允许 USB 调试的授权对话框一定要点允许并且勾上始终允许。如果设备列表里是空的先用adb devices看看能看到设备号但状态是unauthorized就是授权没点。跑起来之后试试改动lib/main.dart里的文字保存然后按r。屏幕上的内容会在一秒内更新页面状态还保留着。这就是热重载也是 Flutter 开发体验里最舒服的部分。7. 编辑器与插件VS Code 和 Android Studio 的取舍环境跑通之后最后一块是编辑器。这块不影响能不能跑只影响你写得舒不舒服。7.1 两套工具的真实差异VS Code 的优点是启动快、占用小、插件生态广如果你本来就写前端或者其他语言用同一个编辑器切过来毫无成本。它的调试体验对 Flutter 也足够好断点、变量查看、热重载按钮都有。Android Studio 的优点是 Android 相关的东西开箱即用。你在里面可以直接打开 SDK 管理器、创建虚拟设备、查看 Logcat、分析构建产物不用切窗口。缺点是启动慢、内存占用高机器配置一般的话会有点吃力。我的实际选择是日常写 Flutter 代码用 VS Code需要处理 Android 构建配置或者排查原生层问题时开 Android Studio。两个编辑器可以同时打开同一个项目互不干扰改动能实时同步。如果你只想装一个那就按你更熟悉的那个来。两者对 Flutter 的支持都到位了没有必须用哪个的说法。7.2 必装插件与必调设置不管选哪个有两个插件是必装的Flutter和Dart。这两个通常是绑定的装了 Flutter 插件会自动带上 Dart 插件。装完之后重启编辑器打开一个 Flutter 项目右下角应该能看到设备选择器和热重载按钮。VS Code 里我建议再调几项设置。一是把保存时自动格式化的开关打开Dart 的格式化器很稳能省掉大量排版纠结。二是把dart.previewFlutterUiGuides打开代码里会显示一层层的 widget 边框对理解嵌套结构帮助很大。三是把editor.formatOnSave打开配合格式化器使用。Android Studio 里重点检查两件事。一是 SDK 路径有没有被正确识别在设置里搜 Flutter能看到 Flutter SDK path 一栏确认指向你解压的目录。二是 Dart SDK 会自动跟随 Flutter SDK不用单独配。插件装好之后如果发现补全不工作、热重载按钮灰掉八成是编辑器没识别到 SDK 路径或者项目目录没被识别为 Flutter 项目缺少pubspec.yaml的时候会这样。这种时候不要重装插件先去设置里看 SDK 路径。8. 多版本共存与几条踩出来的经验最后聊两件在实际工作中很快会遇到的事版本管理和那些文档里不写的经验。8.1 用 FVM 隔离项目版本你可能遇到这样的情况手上两个项目一个基于较老的 Flutter 版本升级上去会有一堆 API 不兼容另一个是新项目需要新版特性。全局只能有一个 Flutter 版本切来切去很麻烦。解法是版本管理工具比较常用的是 FVM。它把多个 Flutter 版本分别装在独立目录里通过项目内的配置指定用哪个版本进项目目录时自动切换。基本用法是先全局装一个 FVM然后用它装几个需要的版本在项目目录里执行指定版本的命令之后所有的flutter命令前面加fvm前缀就会用项目指定的那个版本。这套东西的好处是项目之间完全隔离团队协作时写进配置文件别人拉下来一跑就是同一个版本不用口头同步你装 3.x.x 那个版本。坏处是每个版本都要独立下载磁盘占用翻倍而且 IDE 需要配置一下让它识别 FVM 管理的版本。我的建议是单人单项目不要用它等你确实遇到多版本需求了再上避免给自己增加不必要的复杂度。8.2 我踩过的坑和对应做法最后把几条从实际踩坑里总结出来的东西列一下都是文档里不太会写但很实用的。第一条环境变量改完一定要开新终端。这条我吃过亏改了变量在旧窗口里死活不生效查了半小时才发现。现在我的习惯是改完直接关掉所有终端窗口重开。第二条任何构建失败先跑flutter doctor。这个前面提过但它值得重复。flutter doctor能覆盖八成的环境类问题比翻报错原文快得多。第三条项目目录和 SDK 目录不要放在一起。有些人图省事把项目建在 SDK 目录下结果 SDK 升级的时候被牵连或者flutter clean的时候误删了东西。分开是基本纪律。第四条第一次构建慢是常态第二次会快很多。理解了这一点你就不会在第一次构建的时候反复中断、反复重来那只会让缓存更乱。第五条别急着装一堆依赖。环境刚通的时候pubspec.yaml保持干净先确认一个空项目能跑通、能热重载再去加包。加了包之后构建失败你就多了一个变量排查难度直接翻倍。第六条保留一份能跑通的配置记录。我会把环境变量、SDK 路径、Android SDK 版本、许可证状态这些东西记在一个文本文件里。换机器或者环境出问题时对着记录一项项核对比凭记忆可靠得多。这个习惯帮我省过好几次重装的时间。这套环境搭好之后日常开发其实很少再碰它。真正需要重新折腾的场景只有三种换机器、系统大版本升级、Flutter 大版本升级。把这三点记住遇到问题的时候你的排查方向就是明确的而不是在一片红叉里乱撞墙。