Windows系统下Flutter开发环境配置完整指南

Windows系统下Flutter开发环境配置完整指南

引用

CSDN

1.

https://blog.csdn.net/nyxdsb/article/details/146133518

本文将详细介绍在Windows系统上配置Flutter开发环境的完整流程，包括环境变量配置、Git和Visual Studio的安装、Flutter SDK的安装、Android SDK的安装、网络资源问题的解决以及Android模拟器的配置等多个方面。

截止到2025年3月，Flutter的最新版本已经更新到了3.29.1，Android Studio的最新版本也已经更新到了2024.1.1。为了确保开发环境的稳定性和兼容性，建议使用最新版本的工具和SDK。

1. 环境变量（Windows）

在Windows系统中，需要配置以下环境变量：

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

2. 下载 Git 和 Visual Studio

• Git官网：https://git-scm.com/
• VS官网：https://visualstudio.microsoft.com/zh-hans/

下载社区版即可，选择C++桌面开发。在安装过程中，可以根据需求修改安装位置，但需要确保路径为全英文。

3. 下载并安装 Flutter SDK

Flutter SDK的官方下载地址为：https://flutter-ko.dev/development/tools/sdk/releases

下载完成后，将其解压缩到非系统盘的全英文路径下。然后配置环境变量，指定到bin目录：

flutter --version
flutter -h

使用flutter doctor命令检查环境配置是否合格。如果出现Android SDK或VS未安装的提示，需要按照后续步骤进行安装。

4. 安装 Android SDK

Android SDK的官方下载地址为：https://developer.android.google.cn/studio?hl=zh-cn

下载并安装Android Studio，打开后会自动提示安装SDK。安装完成后，再次运行flutter doctor检查是否安装成功。

5. 解决Android许可证问题

运行以下命令接受SDK许可证：

flutter doctor --android-licenses

如果出现错误，可以在Android Studio中打开SDK Manager，取消勾选"Hide Obsolete Packages"，勾选所有需要的组件，点击apply进行下载。下载完成后，再次运行上述命令并持续输入'y'确认。

6. 解决网络资源问题

GitHub代理问题

通过设置代理解决GitHub访问问题：

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

Maven源问题

建议使用阿里云的Maven镜像源：

const String kMaven = 'https://maven.aliyun.com/repository/google/';

7. Android 模拟器问题

问题原因

Android Studio默认将虚拟机安装在用户目录下，如果路径中包含中文字符，可能会导致配置文件中的路径乱码，从而导致虚拟机运行失败。

问题解决

1. 在纯英文路径下新建一个存放模拟器的文件夹（例如AVD）。
2. 在系统变量中创建ANDROID_SDK_HOME，路径为上述文件夹的路径。
3. 在系统变量的path中添加相关路径。
4. 重启电脑。

测试是否成功

1. 打开Virtual Device Manager，新建一个模拟器。
2. 检查AVD路径下是否生成了.android文件夹，以及是否包含创建的模拟器。

打开模拟器后的小弹窗

在打开模拟器后，可能会弹出提示要求手动设置ADB路径。解决方法如下：

1. 打开设置(Settings)。
2. 在General标签页中，将ADB路径设置为SDK路径/platform-tools/adb.exe。
3. 重启模拟器。