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. 配置环境变量
添加Flutter到系统PATH：
C:\src\flutter\bin设置国内镜像变量(用户变量)：
PUB_HOSTED_URL=https://pub.flutter-io.cn FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
或使用清华大学镜像：
FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter
PUB_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设置
安装Flutter插件：
打开Android Studio → File → Settings → Plugins
搜索安装
Flutter插件(会自动安装Dart插件)配置Android SDK：
通过SDK Manager安装最新Android SDK
确保勾选"Android SDK Command-line Tools"
2. VS Code配置(可选)
安装扩展：
Flutter
Dart
配置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.1
systemProp.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表示已启用
性能优化建议
启用分帧渲染：
void main() {
WidgetsFlutterBinding.ensureInitialized()
..scheduleFrameCallback((_) {})
..rendererBinding.enableRenderPipelineReuse = true;
runApp(MyApp());
} 预编译着色器：
flutter build bundle --precompile
```:ml-citation{ref="24" data="citationList"}六、创建第一个项目
命令行创建
flutter create my_app cd my_app flutter run
Android Studio创建
选择"Start a new Flutter project"
选择"Application"类型
输入项目名称和保存路径(确保无中文和空格)
点击"Finish"完成创建
