Flutter 开发环境配置

核心前置：不要单独下载 Dart SDK，Flutter SDK 自带绑定版本的 Dart。

一、系统前置依赖（Windows）

  1. Git for Windows（必须，用于拉取依赖），安装时勾选 Use Git from the Windows Command Prompt
  2. PowerShell 5.0+（Win10/11 自带）
  3. 如果要编译 Windows 桌面端：安装 Visual Studio 2022，勾选组件：Desktop development with C++

⚠️ 路径禁忌：Flutter SDK 解压目录不能有中文、空格、特殊符号，不要放在 C:\Program Files

二、安装 Flutter SDK

方式 1：手动下载（推荐稳定版）

  1. 访问 Flutter 中文官网：https://docs.flutter.cn/
  2. 下载稳定版 flutter_windows_x.x.x-stable.zip
  3. 解压到目录，例如 D:\dev\flutter
  4. 添加环境变量 PATH：把 D:\dev\flutter\bin 加入系统 PATH

方式 2：VSCode 自动安装（新手推荐）

  1. 安装 VSCode
  2. 扩展商店安装 Flutter（会自动附带 Dart 插件）
  3. Ctrl+Shift+P → 输入 Flutter: New Project → 选择 Download SDK，自动下载并配置 PATHFlutter

✅ 国内镜像（关键，解决 pub 拉包超时）

新增系统环境变量（用户变量）

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

Mac/Linux 在 ~/.zshrc / ~/.bashrc 添加：

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

配置完重启终端生效。

三、IDE 配置

方案 A：VSCode（轻量，推荐）

扩展：Flutter（自动安装 Dart 插件）

  • 功能：代码提示、热重载、断点调试、新建 Flutter 项目

方案 B：IntelliJ IDEA

第一步：安装 Flutter & Dart 插件

  1. 打开 IDEA → File → Settings（快捷键 Ctrl+Alt+S）
  2. 选择 Plugins（插件市场）
  3. 搜索：Flutter，点击安装，插件会自动推荐安装依赖的 Dart 插件
  4. 安装完成后重启 IDEA

插件作用：Flutter 语法高亮、代码补全、热重载、创建 Flutter 项目、断点调试。

第二步：IDEA 内配置 Flutter SDK 路径

  1. File → Settings → Languages & Frameworks → Flutter
  2. Flutter SDK path：选择你本地 flutter 解压目录，示例：D:\dev\flutter
  3. 配置完成，下方会自动识别出内置 Dart SDK 路径，点击 Apply → OK

四、校验环境

打开新终端执行：

flutter doctor

命令会自动检查所有依赖：

  • ✅ 绿色勾：正常
  • ⚠️ 黄色感叹号：可选（比如没有 Android 模拟器，只做 Web 开发可以忽略）
  • ❌ 红色叉号：必须修复（Git、环境变量、Android SDK 等）

常见命令：

# 查看flutter版本+内置dart版本
flutter --version
# 更新flutter到最新稳定版
flutter upgrade
# 查看已连接设备（手机/模拟器/浏览器）
flutter devices
# 创建新项目
flutter create my_app
# 运行项目
cd my_app
flutter run
posted @ 2026-10-03 20:46  寒爵  阅读(5)  评论(0)    收藏  举报