1. 环境准备：别急着下载，先看看你的“地基”牢不牢
很多朋友一上来就直奔下载链接，结果安装过程磕磕绊绊，各种报错。我刚开始学Flutter那会儿也这样，后来才明白，磨刀不误砍柴工，安装前的准备工作其实比安装本身更重要。这就像盖房子，你得先确保地基是平整稳固的，而不是直接把建材往上堆。所以，在点击那个“Download”按钮之前，我们先花几分钟，把准备工作做扎实。
首先，你得明确你的操作系统。Flutter支持Windows、macOS和Linux，但不同系统下的细节差异不小。如果你是Windows用户，我强烈建议你使用Windows 10或更高版本，并且确保系统已经更新到最新。一个过时的系统版本，可能会在后续安装Android工具链时带来意想不到的兼容性问题。macOS用户相对省心一些，但也要注意，如果你打算开发iOS应用，你的macOS版本必须满足Xcode的要求。至于Linux，我推荐使用Ubuntu或Debian这类主流发行版，社区支持好，遇到问题也容易找到解决方案。
其次，检查你的磁盘空间。Flutter SDK本身不大，但完整的开发环境，尤其是Android SDK和模拟器镜像，会占用不少空间。我建议至少预留10GB的可用空间，这样后续安装Android Studio、Xcode和各种依赖包时才不会捉襟见肘。另外，安装路径最好选择在没有中文和特殊字符的目录下，比如 C:\flutter 或 /Users/你的名字/flutter。这是一个非常容易踩坑的地方，路径里的一个空格或中文字符，都可能导致后续命令执行失败。
最后，也是最重要的一点：网络环境。因为Flutter在安装和后续的包管理过程中，需要从Google的服务器和Dart的官方仓库下载资源。如果你的网络访问这些地址不稳定或速度很慢，整个安装过程会变得异常痛苦，甚至失败。我实测下来，一个稳定、通畅的网络连接是顺利安装的基石。你可以提前在浏览器里试着访问一下 https://pub.dev 和 https://storage.googleapis.com，看看是否能正常打开。如果遇到困难，可以尝试调整本地网络的DNS设置，或者寻找更稳定的网络环境。准备工作做到位，后面的安装步骤就会像搭积木一样顺畅。
2. 下载与解压：获取Flutter的“核心引擎”
好了，地基打牢了，现在我们可以去获取Flutter SDK这个“核心引擎”了。这个过程本身很简单，但有几个关键选择会影响到你未来的开发体验，我得跟你仔细说道说道。
第一步，选择下载渠道。 最直接的方式就是访问Flutter官网（flutter.dev），点击大大的“Get started”按钮，然后找到对应你操作系统的安装包。官网提供的是稳定版（Stable Channel），对于初学者来说，这是最安全、最推荐的选择。但如果你是个喜欢尝鲜、或者需要用到最新功能的开发者，你也可以选择其他渠道。Flutter的发布渠道主要有三个：稳定版（Stable）、测试版（Beta）、开发版（Dev）和主线版（Master）。稳定版顾名思义，最可靠；测试版和开发版会包含一些即将推出的新特性；主线版则是每天同步最新代码的版本，变动最大。对于入门，我们百分之百选择稳定版，避免不必要的麻烦。
第二步，下载与解压。 点击下载后，你会得到一个压缩包（Windows是.zip，macOS/Linux是.tar.xz）。我建议你专门在某个磁盘的根目录下创建一个名为 Development 或 SDK 的文件夹，用来统一管理各种开发工具。然后把下载的压缩包解压到这个文件夹里。比如，在Windows上，你可以解压到 D:\Development\flutter；在macOS上，可以解压到 /Users/你的名字/Development/flutter。记住这个完整的路径，下一步我们要把它告诉你的操作系统。
这里有个小技巧：解压完成后，你可以打开终端（或命令提示符/PowerShell），先尝试进入这个Flutter目录。例如，在macOS或Linux的终端里输入 cd ~/Development/flutter，在Windows PowerShell里输入 cd D:\Development\flutter。如果能成功进入，并且用 dir 或 ls 命令能看到一堆文件和 bin 文件夹，那就说明解压成功了。这个 bin 文件夹就是Flutter所有命令行工具的所在地，我们接下来要做的，就是让系统在任何地方都能找到它。
3. 配置系统路径：让电脑“认识”Flutter命令
解压完，Flutter SDK已经在你电脑里了，但你现在还不能用它。为什么？因为你的操作系统不知道去哪里找 flutter 这个命令。这就好比你知道家里工具箱里有把锤子，但你没告诉大脑锤子具体放在哪个抽屉，当你想用时，大脑就“找不到”它。配置系统路径（PATH），就是把这个“抽屉位置”告诉系统的大脑（命令行解释器）。
这个步骤因操作系统而异，我分别给你讲清楚，并且把容易出错的地方标出来。
对于Windows用户：
最稳妥的方法是通过系统属性设置。你可以在开始菜单搜索“编辑系统环境变量”并打开。在弹出的“系统属性”窗口里，点击右下角的“环境变量”按钮。接下来，在下面的“系统变量”区域（注意，是系统变量，不是用户变量，这样对所有用户都生效），找到名为 Path 的变量，双击它进行编辑。
- 点击“新建”。
- 将你的Flutter
bin目录的完整路径粘贴进去。比如D:\Development\flutter\bin。 - 一路点击“确定”关闭所有窗口。
这里有个巨坑：如果你用的是Windows PowerShell（特别是新版Windows 11默认的终端），有时候修改了系统Path后需要重启终端甚至重启电脑才能生效。更保险的做法是，在PowerShell里手动为当前会话添加路径，并立即测试。你可以打开一个新的PowerShell窗口，输入以下命令（请替换成你的实际路径）：
$env:PATH += ";D:\Development\flutter\bin"
然后紧接着输入 flutter --version。如果能看到Flutter的版本信息输出，就说明路径暂时生效了。当然，这个命令只对当前打开的PowerShell窗口有效，关掉就没了。所以，通过系统属性做的永久配置依然是必须的。
对于macOS和Linux用户：
我们通常通过修改shell的配置文件来永久添加路径。首先，你需要知道你的终端使用的是哪种shell。在终端里输入 echo $SHELL，如果输出是 /bin/zsh，那么你的配置文件就是 ~/.zshrc；如果输出是 /bin/bash，那么配置文件是 ~/.bash_profile 或 ~/.bashrc（对于macOS，通常用 .bash_profile）。
- 用文本编辑器打开对应的配置文件。例如，对于zsh：
open -e ~/.zshrc或用nano ~/.zshrc。 - 在文件的末尾，添加下面这行代码（同样，请替换成你的实际路径）：
export PATH="$PATH:/Users/你的名字/Development/flutter/bin" - 保存并关闭文件。
- 回到终端，让配置文件立即生效。对于zsh：输入
source ~/.zshrc；对于bash：输入source ~/.bash_profile。
配置完成后，无论你在终端的哪个目录下，直接输入 flutter 命令，系统都应该能找到了。你可以马上输入 flutter --version 或简单的 flutter 来测试。如果出现一堆帮助信息或版本号，恭喜你，路径配置成功！如果提示“command not found”，那就回头检查一下路径是否拼写正确，以及是否执行了 source 命令。
4. 运行Flutter Doctor：你的“全科体检报告”
路径配好了，现在可以请出我们安装过程中最重要的“医生”——flutter doctor 了。这个命令可不是摆设，它会给你的开发环境做一次全面的体检，检查所有必需的组件是否都已就位，并给出非常详细的诊断报告。我第一次运行它的时候，报告上一片红叉和感叹号，简直惨不忍睹，但正是它一步步引导我修复了所有问题。
在终端或命令提示符里，直接输入 flutter doctor 并回车。程序会开始检查以下几项关键内容：
- Flutter SDK本身：检查版本和渠道。
- Android开发环境：检查Android SDK、Android Studio（或IntelliJ IDEA）以及是否安装了Android模拟器或连接了真机。
- iOS开发环境（仅macOS）：检查Xcode、Xcode命令行工具以及CocoaPods（iOS的依赖管理工具）。
- 开发工具插件：检查是否在Android Studio/IntelliJ或VS Code中安装了Flutter和Dart插件。
运行完成后，你会看到一份类似这样的报告（这是理想情况）：
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.19.0, on macOS 14.4 23E214 darwin-arm64, locale zh-Hans-CN)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Xcode - develop for iOS and macOS (Xcode 15.3)
[✓] Chrome - develop for the web
[✓] Android Studio (version 2023.2)
[✓] VS Code (version 1.87.0)
[✓] Connected device (2 available)
• No issues found!
看到满屏的绿色对勾和“No issues found!”，那感觉真是太棒了！但这通常是老手或者运气极好的新手才能遇到的。更常见的情况是，你会看到一些 [!]（警告）或 [✗]（错误）标记。别慌，这太正常了。flutter doctor 不仅告诉你哪里有问题，还会给出修复建议。
例如，它可能会说“Android SDK not found”。这时，你就需要去安装Android Studio，并在安装过程中勾选安装Android SDK。如果它说“Xcode not installed; this is necessary for iOS development.”，macOS用户就需要去App Store下载安装Xcode。对于每一个问题，flutter doctor 给出的建议通常都是最直接的解决方案。你可以根据它的提示，一个个去安装、配置。每解决一个问题，就重新运行一次 flutter doctor，直到所有项目都打上绿勾。
这里有个高级技巧：使用 flutter doctor -v 命令。这个 -v 参数代表“详细模式”，它会输出极其详细的检查日志，包括各个工具的具体路径、版本号等。当某个问题比较棘手，标准建议解决不了时，详细日志就是你排查问题的宝贵依据。你可以把这些日志复制出来，去搜索引擎或者Flutter社区提问，能大大提高解决问题的效率。
5. 安装IDE与插件：打造趁手的“编程工作站”
环境检查通过了，但我们总不能一直在黑乎乎的终端里写代码吧？你需要一个集成开发环境（IDE），它就像你的编程工作站，把代码编辑、调试、运行、项目管理等功能都集成在一起，能极大提升开发效率。对于Flutter开发，主流的选择有两个：Android Studio 和 Visual Studio Code (VS Code)。我两个都用过很久，可以给你分析一下。
Android Studio 是谷歌官方的Android开发IDE，对Flutter和Dart的支持是“亲儿子”级别的，功能最全。它内置了强大的模拟器管理、性能分析工具（Profiler）和布局检查器（Layout Inspector）。如果你主要进行Android开发，或者希望有一个功能大而全、开箱即用的环境，Android Studio是首选。安装完Android Studio后，你需要安装两个插件：Flutter插件和Dart插件。安装方法很简单：打开Android Studio，进入 Preferences (macOS) 或 Settings (Windows/Linux) -> Plugins，在 Marketplace 里搜索 “Flutter”，安装它，它会自动提示你安装配套的Dart插件，一并安装并重启IDE即可。
Visual Studio Code 则是一个轻量级但功能强大的编辑器，速度非常快，插件生态丰富。它对Flutter的支持同样来自官方，体验非常流畅。如果你喜欢轻快、可高度自定义的编辑体验，或者你的电脑配置不高，VS Code会是更好的选择。在VS Code中，你只需要安装一个“Flutter”插件，这个插件会自动包含Dart的支持。打开VS Code，点击侧边栏的扩展图标，搜索“Flutter”，找到由Dart Code团队发布的那一个，点击安装。
我个人的习惯是：在性能强大的台式机上用Android Studio，享受其完整的功能；在笔记本上则用VS Code，追求快速启动和流畅编码。对于纯新手，我反而更推荐从VS Code开始。因为它更轻便，配置简单，不会有一大堆暂时用不上的功能干扰你，能让你更专注于Flutter和Dart语言本身的学习。等项目复杂了，再切换到Android Studio也不迟。
安装好IDE和插件后，记得再次运行 flutter doctor，它应该能检测到你已经安装了IDE和插件，并给出绿勾。这时候，你的Flutter开发环境就已经从“能用”升级到“好用”了。
6. 解决常见问题与优化配置
即使按照步骤一步步来，也难免会遇到一些“拦路虎”。这里我总结几个我当年踩过的坑，以及对应的解决办法，希望能帮你顺利过关。
问题一：运行 flutter doctor 时，卡在“Checking Android licenses...”或者提示Android许可证未接受。
这是因为Android SDK的一些组件需要接受许可协议。解决方法很简单，在终端运行这个命令：
flutter doctor --android-licenses
然后一路按 y 键确认即可。如果这个命令不管用，可以尝试先设置一个环境变量：export JAVA_OPTS='-XX:+IgnoreUnrecognizedVMOptions'，然后再运行上述命令。
问题二：网络问题导致下载慢或失败（例如卡在“Running pub get...”）。
这是国内开发者最常见的问题。Flutter和Dart的包管理工具Pub默认使用Google的服务器。我们可以为它设置国内镜像源来加速。这是一个一次性的全局配置，设置好后一劳永逸。
对于macOS或Linux，将以下环境变量添加到你的shell配置文件（.zshrc或.bash_profile）中：
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
对于Windows，在“系统环境变量”里新建两个变量，变量名和值同上。
添加后，别忘了 source 你的配置文件或重启终端。之后再执行 flutter pub get 等命令，速度就会有质的飞跃。
问题三：iOS模拟器无法启动或Flutter项目跑不起来。
在macOS上开发iOS应用，Xcode是绕不开的。首先，确保Xcode是从App Store下载安装的正式版，并且已经完全启动过一次（第一次启动会安装额外的组件）。其次，在终端运行 sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer 来确保命令行工具指向正确的Xcode。最后，有时需要手动打开iOS模拟器（可以在Spotlight搜索“Simulator”），然后在模拟器的 Hardware -> Device 菜单里，选择一个设备（比如iPhone 15 Pro），让模拟器先独立运行起来，再回到IDE里运行Flutter项目。
问题四：想同时开发多个不同版本的Flutter项目怎么办？
随着Flutter版本迭代，你可能会遇到老项目需要旧版本SDK，而新项目想用最新版的情况。我推荐使用 fvm (Flutter Version Management) 这个第三方工具。它类似于Node.js的nvm，可以让你在电脑上轻松安装、切换多个Flutter SDK版本。安装和使用方法在其GitHub主页上有详细说明，用起来非常直观。当你需要为某个特定项目指定版本时，只需要在项目目录下执行 fvm use 版本号 即可，这能有效避免版本冲突带来的头疼问题。
把这些问题和优化项处理好，你的Flutter环境就不仅仅是“安装成功”，而是达到了“配置优化、稳定可靠”的状态。这时候，你已经拥有了一个强大的跨平台开发武器，可以真正开始创造有趣的应用了。我至今还记得第一次在Android模拟器和iOS模拟器上同时跑通同一个Flutter应用时的那种兴奋感，那种“write once, run anywhere”的魔力，正是从这一步扎实的环境配置开始的。
4683
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
