Flutter Windows 安装完整指南

一、系统要求与环境准备

1. 硬件与操作系统要求

注意：避免安装在有中文或空格的路径中，如C:\Program Files这类需要管理员权限的目录

二、详细安装步骤

1. 下载Flutter SDK

• ‌官方下载‌：Flutter官网

• ‌国内镜像‌：Flutter中文网 (推荐国内用户使用

# 解压到无空格路径(如C:\src\flutter)tar xf flutter_windows_3.29.2-stable.zip -C C:\src

2. 配置环境变量

1. 添加Flutter到系统PATH：

• C:\src\flutter\bin

2. 设置国内镜像变量(用户变量)：

PUB_HOSTED_URL=https://pub.flutter-io.cnFLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

或使用清华大学镜像：

FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutterPUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub```:ml-citation{ref="7,8" data="citationList"}

验证安装

flutter --version  # 应显示类似"Flutter 3.29.2"的版本信息flutter doctor     # 检查环境完整性

三、开发工具配置

1. Android Studio设置

1. 安装Flutter插件：

• 打开Android Studio → File → Settings → Plugins

• 搜索安装Flutter插件(会自动安装Dart插件)

2. 配置Android SDK：

• 通过SDK Manager安装最新Android SDK

• 确保勾选"Android SDK Command-line Tools"

2. VS Code配置(可选)

1. 安装扩展：

• Flutter

• Dart

2. 配置SDK路径：

"dart.flutterSdkPath": "C:\\src\\flutter"

四、常见问题解决方案

1. Gradle配置问题

• ‌手动下载Gradle‌：将gradle-wrapper.properties中的distributionUrl改为本地路径：

distributionUrl=file:///D:/gradle/gradle-8.10.2-all.zip

代理设置‌：在gradle.properties中添加：

systemProp.http.proxyHost=127.0.0.1systemProp.http.proxyPort=1080```:ml-citation{ref="16,17" data="citationList"}

2. 权限问题处理

• ‌避免高权限路径‌：不要安装在Program Files等系统目录

• ‌管理员权限运行‌：右键IDE/终端选择"以管理员身份运行"

• ‌安全软件设置‌：临时关闭杀毒软件或添加Flutter目录到白名单

3. Flutter doctor错误修复

五、2025年新特性配置

Impeller 2.0渲染引擎

Flutter 3.29+默认启用Impeller 2.0，无需额外配置。验证方法：

flutter run --verbose | findstr "Impeller"

输出包含Using Impeller表示已启用

性能优化建议

1. ‌启用分帧渲染‌：

void main() {  WidgetsFlutterBinding.ensureInitialized()    ..scheduleFrameCallback((_) {})    ..rendererBinding.enableRenderPipelineReuse = true;  runApp(MyApp());}

‌       预编译着色器‌：

flutter build bundle --precompile```:ml-citation{ref="24" data="citationList"}

六、创建第一个项目

命令行创建

flutter create my_appcd my_appflutter run

Android Studio创建

1. 选择"Start a new Flutter project"

2. 选择"Application"类型

3. 输入项目名称和保存路径(确保无中文和空格)

4. 点击"Finish"完成创建