云计算百科
云计算领域专业知识百科平台
当前位置：网硕互联帮助中心 > 服务器百科 > 正文

Flutter 环境配置

2026-01-25 分类：服务器百科 阅读(8) 评论(0)

一、前置准备：明确依赖与下载工具

1. 必备依赖清单

  • 操作系统：Windows 10/11（64 位）

  • 基础工具：

    • Android Studio：提供 Android SDK、模拟器及开发工具支持

    • Flutter SDK：核心开发框架，必装

    • Git：可选，用于版本控制，部分 Flutter 功能依赖

  • 硬件要求：至少 4GB 内存，预留 10GB 以上磁盘空间（存储 SDK、依赖、模拟器镜像）

2. 工具下载地址

  • Flutter SDK：官网下载页，选择稳定版（Stable channel）

  • Android Studio：官网下载页，默认最新版即可

  • Git：官网下载页，可选，按默认选项安装

二、第一步：安装 Flutter SDK

1. 解压 Flutter SDK

  • 下载 Flutter SDK 压缩包（如 flutter_windows_3.16.9-stable.zip）；

  • 选择非中文、无空格的目录解压（关键！避免路径识别错误），推荐路径：D:\\Develop\\Flutter\\flutter（解压后文件夹含 bin、packages 等子目录）；

  • 牢记该路径，后续配置环境变量需用到。

    • 2. 配置 Flutter 环境变量

    目的：让 Windows 命令行全局识别 flutter 命令，无需每次进入 SDK 目录执行。

  • 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」；

  • 在「系统变量」栏找到「Path」，点击「编辑」；

  • 点击「新建」，粘贴 Flutter SDK 的 bin 目录路径（示例：D:\\Develop\\Flutter\\flutter\\bin）；

  • 连续点击「确定」保存所有窗口，不遗漏；

  • 验证配置：打开新的命令行窗口（旧窗口需重启），输入 flutter –version，若输出 Flutter 及 Dart 版本号（如 Flutter 3.16.9），则配置成功。

    • 三、第二步：安装 Android Studio

    1. 安装 Android Studio

  • 运行安装包（如 android-studio-2023.1.1.26-windows.exe）；

  • 点击「Next」，默认勾选「Android Studio」和「Android Virtual Device」（模拟器支持，必选）；

  • 选择非中文、无空格安装路径（推荐：D:\\Develop\\AndroidStudio）；

  • 等待安装完成（需下载基础组件，耗时看网络）；

  • 首次启动配置：

  • 提示「Import Android Studio Settings」时，选「Do not import settings」→「OK」；

  • 进入欢迎界面后，点击「Next」→ 选「Standard」（标准安装）→「Next」；

  • 选择 UI 主题，点击「Next」；

  • 确认 SDK 安装路径（默认示例：C:\\Users\\你的用户名\\AppData\\Local\\Android\\Sdk），牢记此路径；

  • 点击「Finish」，等待 SDK 基础组件下载（约 5-10 分钟）。

    • 2. 安装 Android SDK Command-line Tools（解决 cmdline-tools missing 问题）

  • 打开 Android Studio，顶部菜单栏「Tools」→「SDK Manager」（或快捷键 Ctrl+Alt+S，搜索 SDK Manager）；

  • 切换到「SDK Tools」标签，勾选「Show Package Details」（显示详细组件）；

  • 展开「Android SDK Command-line Tools (latest)」，勾选该组件（版本自动匹配最新）；

  • 确保「Android SDK Build-Tools」「Android Emulator」「Android SDK Platform-Tools」已勾选（默认已选，未选则补勾）；

  • 点击「Apply」→「OK」，等待安装完成（约 2-5 分钟），完成后关闭 SDK Manager。

    • 3. 配置 Android SDK 环境变量

    目的：让 Flutter 自动识别 Android SDK 路径，避免手动配置。

  • 打开「环境变量」（同 Flutter 环境变量入口）；

  • 「系统变量」栏点击「新建」，添加变量：

  • 变量名：ANDROID_HOME

  • 变量值：Android SDK 安装路径（即上文牢记的路径）

  • 编辑「系统变量」中的「Path」，添加两个路径：

  • %ANDROID_HOME%\\platform-tools

  • %ANDROID_HOME%\\tools

  • 点击「确定」保存，重启命令行窗口生效。

    • 注意:这里环境变量配置后,之前已经启动的应用(如git,Android Studio)需要重新启动才会识别到

    四、第三步：配置 Flutter 国内镜像

    1. 配置原因

    Flutter 默认依赖国外站点（如 pub.dev、storage.googleapis.com），国内网络易卡顿超时，导致初始化失败、依赖下载卡住。

    2. 永久配置镜像

  • 打开「环境变量」（右键此电脑→属性→高级系统设置→环境变量）；

  • 在「用户变量」栏点击「新建」，依次添加两个变量（名称和值完全一致，无空格）：

  • 变量名：PUB_HOSTED_URL，变量值：https://pub.flutter-io.cn

  • 变量名：FLUTTER_STORAGE_BASE_URL，变量值：https://storage.flutter-io.cn

  • 点击「确定」保存，重启所有命令行窗口和 Android Studio（确保生效）。

    • 3. 验证镜像配置

  • 打开新的命令行窗口；

  • 输入以下两条命令，输出与配置的镜像地址一致即成功： echo %PUB_HOSTED_URL% echo %FLUTTER_STORAGE_BASE_URL%

    • 五、第四步：初始化 Flutter 并解决依赖问题

    1. 首次运行 Flutter 初始化

  • 打开命令行窗口，输入 flutter 命令（首次运行自动执行初始化）；

  • 等待完成，显示「Got dependencies.」即依赖下载成功：

  • 配置镜像后耗时约 1-3 分钟；

  • 若卡住，按 Ctrl+C 终止，重新执行 flutter（支持断点续传，已下载文件不重复）。

    • 2. 接受 Android SDK 许可协议（解决 license unknown 问题）

  • 命令行输入命令： flutter doctor –android-licenses

  • 弹出许可协议确认时，每次输入 y 并回车（约 5-8 次）；

  • 显示「All SDK package licenses accepted」即完成。

    • 六、第五步：用 flutter doctor 检查并修复环境

    1. 执行环境检查

    命令行输入 flutter doctor，自动检测 Flutter 开发所需所有环境（Flutter、Windows、Android 工具链等）。

    2. 常见问题及解决方案

    • 问题：[×] Android toolchain – develop for Android devices → cmdline-tools component is missing 解决方案：回到第三步 2，重新安装 Android SDK Command-line Tools (latest)

    • 问题：Android license status unknown 解决方案：重新执行 flutter doctor –android-licenses，确保所有确认都输入 y

    • 问题：Unable to connect to storage.googleapis.com 解决方案：检查镜像配置是否生效，重启命令行窗口后重新执行 flutter doctor

    • 问题：HTTP error when checking GitHub 解决方案：网络临时问题，不影响基础开发；需访问 GitHub 时切换手机热点或配置加速

    • 问题：[×] Visual Studio – develop for Windows 解决方案：需开发 Windows 桌面应用则安装 Visual Studio 2022，勾选「桌面开发使用 C++」；无需可忽略

    3. 目标状态

    执行 flutter doctor 后，核心组件显示「✓」即可（GitHub 相关错误可忽略），示例如下：

    [✓] Flutter (Channel stable, 3.16.9, on Microsoft Windows [版本 10.0.19045.3930], locale zh-CN)
    [✓] Windows Version (Installed version of Windows is version 10 or higher)
    [✓] Android toolchain – develop for Android devices (Android SDK version 34.0.0)
    [✓] Chrome – develop for the web
    [✓] Visual Studio – develop for Windows (Visual Studio Community 2022 17.9.6)
    [✓] Android Studio (version 2023.1)
    [✓] Connected device (3 available)
    [✓] Network resources

    七、第六步：创建第一个 Flutter 项目

    1. 新建项目

  • 打开 Android Studio，点击「Start a new Flutter project」；

  • 选择「Flutter Application」→「Next」；

  • 填写项目信息：

  • Project name：项目名（如 first_flutter_app，仅字母、数字、下划线，首字母小写）；

  • Flutter SDK path：选择 Flutter SDK 解压路径；

  • Project location：项目保存路径（非中文、无空格）；

  • Description：项目描述（可选）。

  • 点击「Next」→ 勾选「AndroidX artifacts」→「Next」；

  • 选择项目图标（默认即可）→「Finish」；

  • 等待项目初始化（首次下载依赖约 1-2 分钟，镜像生效后更快）。

    • 2. 运行项目（Android 模拟器为例）

    （1）启动模拟器

  • 点击 Android Studio 顶部「Device Manager」（手机+齿轮图标）；

  • 点击「Create device」→ 选择设备（如 Pixel 7）→「Next」；

  • 选择 API 33 或 34 系统镜像（点击 Download 下载，约 1-3 分钟）→「Next」；

  • 点击「Finish」创建模拟器，再点击右侧「Play」按钮启动（首次启动约 1 分钟）。

    • （2）运行项目

  • 确保顶部工具栏已选中创建的模拟器（如 Pixel 7 – API 33）；

  • 点击顶部绿色三角形「Run」按钮，或按快捷键 Shift+F10。

    • （3）验证结果

    模拟器中显示 Flutter 默认计数器应用（含「0」和「+」按钮），说明环境完全就绪，可正常开发。

    赞(0)
    未经允许不得转载：网硕互联帮助中心 » Flutter 环境配置
    分享到： 更多 (0)
    标签：

    相关推荐

    评论 抢沙发

    评论前必须登录！

     

    热门标签

    服务器(4701)运维(2915)linux(1480)人工智能(1050)java(832)网络(746)开发语言(730)python(663)c++(515)数据库(477)前端(471)算法(388)美国站群服务器(308)香港云服务器(305)租用香港服务器(301)香港服务器(298)香港站群服务器租用(298)租用香港站群服务器(294)香港服务器租用(293)ubuntu(290)香港站群服务器(289)美国云服务器(286)windows(285)香港VPS(280)美国服务器租用(279)学习(277)美国服务器(276)docker(250)深度学习(250)安全(247)

    置顶推荐

    热门文章

    最新文章