Windows 下快速搭建 Flutter + VS Code 的开发环境，并顺利发布 Android App，给你一份一步步的高效流程，帮你省时省力：

Windows 下快速搭建 Flutter + VS Code 开发环境并发布 Android App

一、环境准备和安装

1. 安装 Flutter SDK

• 访问官网 https://flutter.dev/docs/get-started/install/windows

• 下载最新版 Flutter SDK 压缩包（如 flutter_windows_x.x.x-stable.zip）

• 解压到 C:\src\flutter（或任意目录，不要放在带空格路径）

• 配置环境变量：

  • 系统变量 Path 添加 C:\src\flutter\bin

• 终端（CMD/PowerShell）输入：

  1	flutter doctor

  会提示缺什么，下一步继续完善

2. 安装 Git

• Flutter 需要 Git 支持，安装：https://git-scm.com/download/win
• 安装后在终端输入 git --version 检查是否可用

3. 安装 Android SDK 和工具（不用安装 Android Studio 可选）

• 推荐安装 Android Studio，自动集成 SDK 和模拟器
• 如果不想装 Android Studio，可单独安装 Android SDK command line tools：
  https://developer.android.com/studio#command-tools
• 配置 ANDROID_HOME 环境变量指向 SDK 路径
• 用命令行安装模拟器、平台工具等

4. 安装 VS Code

• https://code.visualstudio.com/ 下载并安装

• 打开 VS Code，安装插件：

  • Flutter
  • Dart

二、配置 Flutter 开发环境

• 打开命令行，运行

  1	flutter doctor

• 根据提示安装缺少的依赖项，比如：

  • Android SDK license 许可：

    1	flutter doctor --android-licenses

    然后按提示输入 y

  • 如果缺少 Android SDK 或未配置，重新检查环境变量和安装

• 连接 Android 设备（真机或模拟器）

  • 真机：开启开发者模式和 USB 调试
  • 模拟器：Android Studio 创建，或者用命令行启动

要在 VS Code 中配置 Flutter 开发环境，请按以下步骤操作：

1. 安装必要插件

• 在 VS Code 中安装官方插件：
  • Flutter（自动包含 Dart 支持）
  • Android SDK Platform-Tools（用于设备调试）

2. 配置环境变量

Windows：

1. 右键 此电脑 → 属性 → 高级系统设置 → 环境变量
2. 在 用户变量 中新建：
   • 变量名：FLUTTER_HOME
     变量值：你的Flutter SDK路径（例如 C:\flutter）
3. 编辑 Path 变量，添加：

   1 2	%FLUTTER_HOME%\bin %ANDROID_HOME%\platform-tools # 如果已安装 Android SDK

macOS/Linux：

编辑 ~/.zshrc 或 ~/.bashrc，添加：

1
2
3
4

export FLUTTER_HOME="你的Flutter SDK路径" # 例如 /Users/name/flutter
export PATH="$FLUTTER_HOME/bin:$PATH"
export ANDROID_HOME="你的Android SDK路径" # 例如 ~/Library/Android/sdk
export PATH="$ANDROID_HOME/platform-tools:$PATH"

运行 source ~/.zshrc 生效。

3. 解决依赖问题

在终端执行：

1

flutter doctor

• Android 许可问题：运行 flutter doctor --android-licenses 并全部接受（按 y）。
• Android Studio 未配置：打开 Android Studio → 安装 SDK Tools：
  • Android SDK Command-line Tools
  • Android SDK Build-Tools

4. 配置 VS Code

1. 设置 SDK 路径（如果自动检测失败）：
   • 打开 VS Code 设置（Ctrl + ,）
   • 搜索 Flutter Sdk Path → 输入 Flutter SDK 路径（例如 C:\flutter）
2. 启用 Dart/Flutter：
   • 打开任意 Dart 文件 → 右下角点击 Dart → 选择允许 Dart 插件。

5. 连接设备

• 真机：开启 USB 调试（设置 → 开发者选项）。
• 模拟器：
  • 在 Android Studio 中创建虚拟设备（AVD Manager）。
  • 在 VS Code 底部状态栏选择设备：
    

6. 创建并运行项目

1. 创建项目：
   • Ctrl + Shift + P → 输入 Flutter: New Project
2. 运行项目：
   • 打开 lib/main.dart
   • 按 F5 或点击右下角的 Debug 按钮

7. 常见问题解决

• 设备未识别：运行 adb devices 检查设备 ID，确保 USB 调试已开启。
• 依赖缺失：在项目根目录运行 flutter pub get。
• 端口占用：执行 adb kill-server && adb start-server。

✅ Android Studio 必装组件

即使你打算主力使用 VS Code，Android Studio 也必须安装，因为它提供：

• Android SDK（Flutter 构建 Android 应用必需）
• Android Emulator（可选）
• Android 编译工具链（gradle, build-tools, platform-tools）
• Java JDK（Flutter 默认使用 Android Studio 自带的 JDK）

✅ 安装 Android Studio 时建议勾选的组件：

1. ✅ Android SDK
2. ✅ Android SDK Platform-Tools
3. ✅ Android SDK Build-Tools
4. ✅ Android Emulator（如需模拟器）
5. ✅ Android Virtual Device（AVD）
6. ✅ Dart Plugin（如你也用 Studio 开发 Flutter）
7. ✅ Flutter Plugin

✅ Flutter SDK 安装（适用于 VS Code 与 Studio）

Flutter 是一个独立 SDK，不随 Android Studio 自动安装。

📦 安装步骤：

1. 前往官网下载 Flutter SDK：https://flutter.dev/docs/get-started/install
2. 解压到一个合适的目录，比如 C:\flutter
3. 将 flutter/bin 加入系统环境变量（Path）

1

C:\flutter\bin

4. 运行以下命令验证环境：

1

flutter doctor

✅ VS Code 插件推荐

在 VS Code 中，安装以下插件：

✅ VS Code 与 Flutter 的关联配置（首次）

1. 确保 VS Code 安装的是 系统 Flutter SDK（非某个特定项目内的）
2. 打开任意 .dart 文件或 Flutter 项目，VS Code 会自动检测 SDK
3. 如果没有检测到 Flutter，可手动指定 SDK 路径：

1
2
3
4

// .vscode/settings.json
{
  "dart.flutterSdkPath": "C:\\flutter"
}

✅ 推荐验证流程（全平台通用）

1

flutter doctor

确保输出如下几个都是 ✅：

• Flutter SDK
• Dart SDK
• Android toolchain
• VS Code / Android Studio
• Emulator / 连接的设备

🛠️ 可选但推荐：

• 安装 Chrome（用于 Flutter Web 调试）
• 安装 Git（Flutter 本体依赖 git 拉取 packages）
• 配置国内镜像（如在国内下载慢，可配 PUB_HOSTED_URL 与 FLUTTER_STORAGE_BASE_URL）

三、创建和运行第一个 Flutter 项目

• 在 VS Code 命令面板（Ctrl+Shift+P）输入 Flutter: New Project

• 选择 Flutter Application

• 选择存储目录和项目名

• 项目创建后，按 F5 运行或在终端执行

  1	flutter run

• 确认应用在设备上正常运行

四、打包并发布 Android App

1. 生成发布版 APK

• 在项目根目录，运行：

  1	flutter build apk --release

• 生成的 APK 位于
  build\app\outputs\flutter-apk\app-release.apk

2. 签名 APK

• 创建或使用已有签名密钥（keystore）

  1	keytool -genkey -v -keystore ~/my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key

• 在 android\app 目录下创建 key.properties 文件，内容示例：

  1 2 3 4

  storePassword=<你的密码> keyPassword=<你的密码> keyAlias=key storeFile=<路径到你的keystore文件>

• 修改 android/app/build.gradle，配置签名信息（官方文档有详细步骤）

3. 发布到 Google Play

• 登录 Google Play 开发者账号（需要付费注册）
• 上传签名过的 APK 或 AAB 包（flutter build appbundle 可以生成 .aab）
• 填写应用信息，提交审核

五、Tips 提升效率

• 使用物理设备调试速度快，避免模拟器卡顿
• 多用 VS Code 的 Flutter 插件热重载功能，开发更快
• 阅读 Flutter 官方发布文档了解细节
• 定期更新 Flutter SDK 和插件保持最新