夜雨聆风
Flutter作为跨平台开发的热门框架，能让你一套代码搞定iOS、Android、Web等多端应用。想要开启Flutter开发之旅，第一步就是顺利安装SDK！亚洲技术本文将以Windows系统为核心，附带Mac极简安装步骤，全程保姆级指导，帮你避开90%的踩坑点。
一、前置依赖（必须先装）
1. Windows必备
Git for Windows是Flutter依赖的版本管理工具，必须提前安装：
·下载地址：https://git-scm.com/download/win
·安装指引：全程默认下一步即可，安装完成后需确保git命令能在CMD/PowerShell中直接调用（可通过输入git --version验证）
·系统要求：Win10 64位及以上版本，磁盘预留至少5G存储空间
2. 国内镜像加速（重中之重，否则下载卡死）
由于网络限制，国内用户必须配置镜像环境变量，否则Flutter依赖下载会超时甚至失败：
·操作步骤：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
·新建两个系统环境变量：
变量名：PUB_HOSTED_URL
变量值：https://pub.flutter-io.cn
变量名：FLUTTER_STORAGE_BASE_URL
变量值：https://storage.flutter-io.cn
��设置完成后必须关闭所有已打开的终端窗口，重新打开才会生效！
二、Windows安装Flutter SDK步骤
步骤1：下载稳定版SDK（推荐清华镜像，速度快）
·清华镜像地址：https://mirrors.tuna.tsinghua.edu.cn/flutter/flutter_infra_release/releases/stable/windows/
·下载文件：选择最新版本的flutter_windows_xxx-stable.zip文件
步骤2：解压（硬性规则，务必遵守）
·先新建文件夹：C:\src
·将下载的zip包解压到C:\src\flutter目录下
·✅正确路径示例：C:\src\flutter\bin（此目录需包含flutter.exe等可执行文件）
·❌禁止路径：包含中文、空格、括号、Program Files、桌面、C盘用户文件夹深层目录（会导致权限报错或命令无法识别）
步骤3：配置系统PATH环境变量
·操作路径：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
·在「用户变量」或「系统变量」中找到Path变量→点击「编辑」→「新建」
·填入路径：C:\src\flutter\bin
·依次点击「确定」保存所有设置
步骤4：验证SDK是否安装成功
必须新开一个CMD/PowerShell窗口（旧窗口不会读取新配置的环境变量），执行以下命令：
flutter --version
dart --version
��输出版本号即表示SDK本体安装完成！
步骤5：执行环境全面检测（核心命令）
运行flutter doctor命令，Flutter会自动检测开发环境的完整性，包括Android工具链、许可证、IDE、模拟器、Windows桌面编译工具等：
flutter doctor
以下是常见报错的修复方案：
·同意Android SDK许可：执行flutter doctor --android-licenses，一路输入y确认全部许可
·缺少Android Studio/SDK：
o下载安装Android Studio：官网地址https://developer.android.com/studio
o打开Android Studio后：File → Settings → Android SDK
oSDK Platforms：勾选一个Android版本（推荐Android 14）
oSDK Tools：勾选Android SDK Build-Tools、Android SDK Command-line Tools、Android Emulator、Android SDK Platform-Tools
o点击Apply开始安装
·IDE安装插件：
oAndroid Studio：Plugins搜索「Flutter」，会自动顺带安装Dart插件，安装完成后重启IDE
oVS Code：扩展商店搜索「Flutter」插件并安装
·Windows桌面编译报错：按照提示安装Visual Studio Installer，勾选「使用C++的桌面开发」组件
黄色警告无需过度紧张，按照提示执行修复命令即可；红色错误必须解决才能进行开发。
步骤6：创建第一个项目测试
环境配置完成后，创建并运行第一个Flutter项目验证：
# 创建项目
flutter create my_demo
# 进入项目目录
cd my_demo
# 运行项目（需连接真机或开启模拟器）
flutter run
看到模拟器或真机上显示默认的Flutter示例页面，就说明整个安装流程圆满完成啦！
三、macOS极简安装步骤
Mac用户安装流程相对简洁，以下是核心步骤：
·1. 安装基础工具：执行命令安装Xcode、Git、Homebrew
xcode-select --install
·2. 下载解压SDK：通过Git克隆稳定版SDK
mkdir -p ~/development
cd ~/development
git clone https://github.com/flutter/flutter.git -b stable
·3. 配置环境变量：针对Mac默认的zsh终端
echo 'export PATH="$PATH:$HOME/development/flutter/bin"' >> ~/.zshrc
source ~/.zshrc
·4. 校验环境&同意许可：
flutter doctor
flutter doctor --android-licenses
四、常用Flutter命令速查
·flutter upgrade：升级Flutter SDK到最新版本
·flutter clean：清理项目缓存，解决部分编译问题
·flutter devices：查看已连接的真机/模拟器设备
·flutter doctor -v：查看详细的环境检测报错信息
·flutter channel stable：切换到稳定版渠道（另有beta/dev/master渠道可选）
五、高频踩坑避坑总结
⚠️ 以下是开发者常踩的坑，务必牢记！
·路径绝对不能包含中文、空格、特殊字符，否则会出现各种诡异报错
·环境变量修改后必须新开终端窗口，旧窗口不会加载新配置
·国内用户必须配置两个镜像环境变量，否则依赖下载超时或失败
·flutter doctor的黄色警告一般不影响基础开发，红色错误才需要优先解决
·真机调试时，手机需开启USB调试模式和USB文件传输模式
恭喜你完成Flutter SDK的安装！接下来就可以开启跨平台开发之旅啦，如果遇到其他问题，欢迎在评论区留言交流~
