Flutter 环境配置完整教程（Windows/macOS）

Flutter 环境配置完整教程（Windows/macOS）

1. 安装 Flutter SDK

• 下载 SDK
  访问 Flutter 官网 下载最新版 SDK
  （Windows 选 .zip，macOS 选 .zip 或直接 git clone）

• 解压到指定目录
  示例路径（无空格和中文）：

  • Windows: F:\DevENV\flutter
  • macOS: /Users/你的用户名/DevENV/flutter

• 配置环境变量

  • Windows:
    1. 搜索「环境变量」→ 编辑系统环境变量
    2. 在 Path 中添加: F:\DevENV\flutter\bin
    3. 新增用户变量（因为在国内）：

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

  • macOS/Linux:
    编辑 ~/.bashrc 或 ~/.zshrc，添加：

    export PATH="$PATH:/Users/你的用户名/DevENV/flutter/bin"
    export PUB_HOSTED_URL=https://pub.flutter-io.cn
    export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
    

    执行 source ~/.zshrc

• 验证安装
  终端运行：

  flutter --version  # 应显示版本号
  flutter doctor     # 检查依赖状态
  

2. 安装 VS Code

• 下载地址：code.visualstudio.com
• 安装完成后添加插件：
  1. 搜索安装 Flutter 插件（自动包含 Dart 支持）
  2. 推荐插件：Awesome Flutter Snippets, Pubspec Assist

3. 安装 Android Studio

• 下载地址：developer.android.com/studio
• 关键步骤：
  1. 安装时勾选 Android SDK、Android SDK Command-line Tools
  2. 启动后安装 Flutter 插件：
     Preferences → Plugins → 搜索安装 Flutter
  3. 配置模拟器：
     Tools → Device Manager → Create Virtual Device

4. 创建第一个 Flutter 项目

1. VS Code 创建：
   Ctrl+Shift+P → 输入 Flutter: New Project → 选 Application → 输入项目名
   （或终端执行 flutter create my_app）

2. 运行项目：

   • 打开项目根目录
   • 底部状态栏选择设备（需提前启动模拟器/连接真机）
   • 按 F5 或点击运行按钮

5. 解决 Gradle 下载问题

修改 android/gradle/wrapper/gradle-wrapper.properties：

distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.4-all.zip

注意：8.4 替换为你的实际版本（查看原文件中的版本号）

6. 常见错误解决

报错：
Plugin [id: 'com.android.application', version: '8.10.1', apply: false] not found

解决方案：

1. 检查网络

   • 确保能访问 Google 服务（测试能否打开 developer.android.com）
   • 终端测试连通性：

     ping dl.google.com
     ping storage.googleapis.com
     

2. 修改 hosts 文件

   • Windows: C:\Windows\System32\drivers\etc\hosts
   • macOS: /etc/hosts
     添加以下 IP（使用最新可用 IP，以下为示例）：

     142.250.4.93 dl.google.com
     142.250.4.93 storage.googleapis.com
     

3. 使用代理工具（如 Clash）开启全局代理

4. 重置 Flutter 工具

   flutter clean
   flutter pub cache repair
   

7. 环境验证

终端执行：

flutter doctor

检查所有 ✅ 标识，常见问题：

• Android 许可：运行 flutter doctor --android-licenses 全部接受（按 y）
• 未检测到设备：启动 Android Studio 的模拟器或连接真机（开启 USB 调试）

完成！ 现在可以开始开发 Flutter 应用了。
官方学习资源：flutter.dev/docs
中文社区：flutter.cn