Flutter安装教程：Windows/macOS/Linux全平台避坑指南（Flutter开发环境配置完全手册）

一、Windows 平台：最详细的 Flutter安装教程

Windows 是大多数开发者的起始平台，配置的核心在于环境变量和磁盘权限。

1. 下载 SDK： 从官网下载最新稳定版 Flutter SDK，解压到非系统盘（如 D:\flutter）。切记不要安装在 C:\Program Files 等需要权限的目录。
2. 配置环境变量： 在“系统变量”的 Path 中添加 D:\flutter\bin。
3. 国内镜像加速： 由于网络原因，必须设置环境变量 PUB_HOSTED_URL 为 https://pub.flutter-io.cn，FLUTTER_STORAGE_BASE_URL 为 https://storage.flutter-io.cn。

二、macOS 平台：适配 Apple Silicon 与 Xcode

在 Mac 上进行开发，最关键的是处理好 M1/M2 芯片的兼容性问题以及 iOS 编译环境。

• Rosetta 2： 如果是 Apple Silicon 芯片，执行 sudo softwareupdate --install-rosetta --agree-to-license。
• Xcode 配置： 安装后需运行 sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer。
• CocoaPods： iOS 开发必备，建议通过 Homebrew 安装。

三、Linux 平台：依赖库是成功的关键

Linux 系统（如 Ubuntu）配置相对硬核，主要关注编译依赖。

安装完成后，同样需要完成 Flutter环境变量设置，确保终端能全局识别 flutter 命令。

四、通用避坑指南：Android Studio配置

无论哪个平台，Android Studio配置 都是重头戏：

• 在 Settings -> Plugins 中搜索并安装 "Flutter" 插件，它会自动安装 Dart 插件。
• 在 Android SDK Manager 中，务必勾选 Android SDK Command-line Tools (latest)，否则运行 flutter doctor 会报错。
• 运行检查： 打开终端输入 flutter doctor，根据提示修复所有的 [✗] 标记。

总结： 只要按照上述步骤操作，并正确处理中国区镜像地址，您的 Flutter 环境就能稳健运行。如果在配置过程中遇到问题，请反复检查您的环境变量是否生效。