Flutter环境搭建是跨平台开发的第一步，也是新手最易踩坑的“拦路虎”——系统依赖缺失、环境变量配置错误、镜像加速失效等问题，都可能导致搭建失败。本文针对Windows 10/11和macOS Ventura及以上系统，提供“一步一图”级别的详细教程，从前期准备到项目运行全程拆解，附带30+常见问题解决方案，确保你一次搭建成功。

核心提示：本文以DevEco Studio为核心IDE（兼顾鸿蒙/Android开发），搭配Flutter 3.24稳定版，所有操作均经过实测验证，可直接对照执行。

技术文章大纲：区块链技术在供应链管理中的应用

引言

简要介绍区块链技术的基本概念及其去中心化、透明性和不可篡改的特性。
阐述供应链管理面临的挑战，如数据孤岛、信任缺失和效率低下。
提出区块链技术如何解决这些问题并优化供应链流程。

区块链技术概述

定义区块链的核心组件：分布式账本、智能合约和共识机制。
区分公有链、私有链和联盟链的适用场景。
列举区块链在金融、医疗等领域的成功案例作为背景支撑。

供应链管理中的痛点分析

传统供应链的信息不对称问题导致协作效率低。
纸质文档和中心化系统易出现数据篡改或丢失风险。
跨境供应链中多方参与带来的合规与结算复杂性。

区块链的具体应用场景

溯源与防伪：通过链上记录商品从生产到交付的全流程数据。
智能合约自动化：自动触发付款、物流更新等操作以减少人为干预。
跨组织协作：联盟链实现供应商、物流商和监管机构的数据实时共享。

实施挑战与解决方案

技术瓶颈：吞吐量限制和隐私保护问题（如零知识证明的应用）。
行业标准缺失：呼吁建立统一的区块链供应链协议框架。
成本与教育：初期投入较高，需通过试点项目验证长期收益。

未来展望

区块链与物联网（IoT）结合实现更精细的供应链监控。
人工智能辅助分析链上数据以预测供应链风险。
政策推动下全球标准化进程的潜在影响。

结语

总结区块链为供应链带来的变革性价值。
强调技术需与实际业务场景深度整合方能发挥最大效用。

一、前期准备：必看的系统检查与工具清单

环境搭建前需先确认系统兼容性，提前安装必备工具，避免后续反复返工。

1. 系统要求明细（必须满足）

检查项

Windows 10/11 要求

macOS 要求

检查方法

系统版本

Windows 10 1909+ / Windows 11

macOS Ventura 13.0+（Apple Silicon/Intel）

Windows：设置→系统→关于；macOS：苹果菜单→关于本机

CPU架构

64位（x86_64）

Apple Silicon（M1+/M2+）或Intel 64位

Windows：任务管理器→性能→CPU；macOS：关于本机→处理器

内存

≥8GB（推荐16GB）

≥8GB（推荐16GB）

Windows：任务管理器→性能→内存；macOS：关于本机→内存

硬盘空间

≥20GB空余空间（SSD优先）

≥20GB空余空间（SSD）

Windows：此电脑→右键属性；macOS：关于本机→储存空间

网络

可访问外网（或配置国内镜像）

可访问外网（App Store需登录Apple ID）

浏览器打开https://flutter.dev测试

2. 必备工具提前安装（避免中途卡壳）

以下工具是环境搭建的基础，需提前完成安装并验证：

Windows系统必备工具

  • Git：版本控制工具，Flutter依赖其拉取资源 下载地址：https://git-scm.com/download/win

  • 安装选项：全部默认，仅在“Adjusting your PATH environment”步骤选择“Use Git from Git Bash only”

  • 验证：打开Git Bash，输入git --version，显示版本号即成功

7-Zip：解压Flutter SDK（避免用系统自带解压工具出现权限问题） 下载地址：https://www.7-zip.org/download.html

安装：默认路径即可，无需额外配置

Java 11：DevEco Studio依赖（必须是Java 11，高版本不兼容） 下载地址：https://adoptium.net/zh-CN/temurin/releases/?version=11

安装：勾选“Set JAVA_HOME variable”，自动配置环境变量

验证：CMD输入java -version，显示“openjdk version 11.x.x”即成功

macOS系统必备工具

  • Git：系统自带，若缺失可通过Homebrew安装 验证：终端输入git --version，无输出则执行xcode-select --install安装

Homebrew：包管理工具，后续安装依赖可用 安装命令：终端输入/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

验证：输入brew --version，显示版本号即成功

二、核心步骤1：配置国内镜像（解决下载慢问题）

Flutter官方资源服务器在国外，国内直接访问会出现超时，必须先配置国内镜像加速（阿里源稳定可靠）。

Windows系统镜像配置

  1. 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，打开环境变量配置窗口

  2. 在“用户变量”区域点击“新建”，依次添加以下两个变量（变量值完全复制）： 变量名：FLUTTER_STORAGE_BASE_URL，变量值：https://storage.flutter-io.cn

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

  4. 点击“确定”保存，关闭所有已打开的CMD/Git Bash窗口（环境变量需重启终端生效）

macOS系统镜像配置

  1. 打开终端，先判断使用的终端类型（默认是zsh，老版本是bash）： 输入echo $SHELL，输出“/bin/zsh”则为zsh，输出“/bin/bash”则为bash

  2. 编辑对应配置文件： zsh用户：输入open ~/.zshrc，若提示文件不存在则先执行touch ~/.zshrc

  3. bash用户：输入open ~/.bash_profile

  4. 在打开的文件中添加以下内容，保存并关闭： export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn export PUB_HOSTED_URL=https://pub.flutter-io.cn

  5. 终端执行生效命令： zsh用户：source ~/.zshrc

  6. bash用户：source ~/.bash_profile

三、核心步骤2：安装Flutter SDK（开发核心依赖）

Flutter SDK包含框架核心、Dart语言环境和开发工具链，必须安装稳定版（避免开发中遇到未知BUG）。

1. 下载Flutter SDK

  1. 访问Flutter官方下载页：https://flutter.dev/docs/get-started/install

  2. 选择对应系统的“Stable Channel”（稳定版），点击“Download”下载SDK压缩包

  3. 等待下载完成（约1GB，镜像配置后速度可达1-5MB/s）

2. 解压SDK（关键：路径无中文无空格）

  • Windows系统： 右键压缩包→“7-Zip”→“提取到当前位置”

  • 将解压后的“flutter”文件夹移动到D盘根目录（路径：D:\flutter，绝对不能放桌面或含中文的路径）

macOS系统： 终端执行解压命令（将压缩包路径替换为实际下载路径）： unzip ~/Downloads/flutter_macos_3.24.0-stable.zip -d ~/development

最终路径：~/development/flutter（development文件夹需提前创建）

3. 配置SDK环境变量（全局调用flutter命令）

环境变量的作用是让系统在任意目录都能识别“flutter”命令，配置错误会导致后续命令无法执行。

Windows系统配置

  1. 再次打开“环境变量”窗口，在“系统变量”中找到“Path”，点击“编辑”

  2. 点击“新建”，输入Flutter SDK的bin目录路径：D:\flutter\bin

  3. 点击“上移”，将该路径移到最顶端（避免与其他环境变量冲突）

  4. 依次点击“确定”保存，打开新的CMD窗口（必须新建，旧窗口环境变量未更新）

  5. 验证：输入flutter --version，若显示Flutter和Dart版本信息（如下），则配置成功 Flutter 3.24.0 • channel stable • https://github.com/flutter/flutter.git Framework • revision 8025c1f84a (3 days ago) • 2024-07-02 12:00:52 -0500 Engine • revision 40bdb82c81 Tools • Dart 3.5.0 • DevTools 2.37.0

macOS系统配置

  1. 终端编辑配置文件（同镜像配置步骤，zsh用户编辑.zshrc，bash用户编辑.bash_profile）： open ~/.zshrc

  2. 添加SDK路径（替换为实际路径）： export PATH="$PATH:$HOME/development/flutter/bin"

  3. 保存后执行生效命令： source ~/.zshrc

  4. 验证：输入flutter --version，显示版本信息即成功

四、核心步骤3：安装DevEco Studio（开发IDE）

DevEco Studio是华为官方IDE，内置鸿蒙/Android SDK管理功能，对Flutter支持完善，无需单独配置SDK路径。

1. 下载并安装DevEco Studio

  1. 访问DevEco Studio官网：https://developer.harmonyos.com/cn/develop/deveco-studio

  2. 下载“DevEco Studio 4.1”稳定版（对应系统版本）

  3. 安装过程： Windows：默认路径即可，勾选“Create desktop shortcut”，点击“Next”

  4. macOS：将“DevEco Studio”拖入“应用程序”文件夹

2. 首次启动初始化（关键：SDK安装）

  1. 启动DevEco Studio，首次打开会提示“DevEco Studio Initialization”，点击“Next”

  2. 选择“Custom”自定义安装，点击“Next”

  3. SDK Components Setup步骤： 勾选“HarmonyOS SDK”和“Android SDK”（均默认勾选）

  4. Android SDK勾选“Android 13 (API 33)”（Flutter最低支持API 31，33更稳定）

  5. 点击“Next”，接受许可协议，点击“Next”开始下载SDK（约2-3GB，镜像加速后速度较快）

  6. 等待SDK下载完成，点击“Finish”，进入DevEco Studio主界面

3. 安装Flutter与Dart插件（必装）

  1. 进入DevEco Studio主界面，点击“Configure”→“Settings”（Windows）或顶部菜单栏“DevEco Studio”→“Settings”（macOS）

  2. 在左侧导航栏找到“Plugins”→“Marketplace”

  3. 搜索“Flutter”，点击“Install”，插件会自动关联安装“Dart”插件

  4. 安装完成后点击“Restart IDE”重启DevEco Studio，插件生效

  5. 验证插件：重启后再次进入Settings→Plugins，在“Installed”中能看到Flutter和Dart均显示“Enabled”

五、核心步骤4：配置平台依赖（Android/鸿蒙/iOS）

Flutter开发需依赖对应平台的SDK，Windows仅支持Android/鸿蒙，macOS额外支持iOS，需分别配置。

1. Android平台配置（全系统通用）

步骤1：配置ANDROID_SDK_ROOT环境变量

Flutter需要通过该环境变量找到Android SDK位置，DevEco Studio已默认安装SDK，只需提取路径并配置。

  1. 打开DevEco Studio→“File”→“Project Structure”→“SDK Location”

  2. 复制“Android SDK Location”路径： Windows默认路径：C:\Users\你的用户名\AppData\Local\Android\Sdk

  3. macOS默认路径：~/Library/Android/sdk

  4. 按“步骤二”的环境变量配置方法，添加系统变量： 变量名：ANDROID_SDK_ROOT

  5. 变量值：复制的Android SDK路径

  6. 保存后重启终端（环境变量生效）

步骤2：创建并启动Android模拟器

  1. 打开DevEco Studio，点击顶部工具栏“Tools”→“Device Manager”（设备管理图标）

  2. 点击“Create Emulator”，选择“Phone”→“Pixel 7”（推荐，性能稳定），点击“Next”

  3. 选择系统镜像：“API 33”→“Android 13 (Google APIs)”，点击“Download”下载

  4. 下载完成后点击“Finish”，返回设备管理界面，点击模拟器右侧的“Launch”按钮启动

  5. 启动成功：出现Pixel 7模拟器界面，显示Android系统桌面

2. 鸿蒙平台配置（全系统通用）

  1. 在“Device Manager”界面，点击“Create Emulator”→“Phone”→“HarmonyOS Phone”，点击“Next”

  2. 选择系统镜像：“API 9”→“HarmonyOS 3.1”，点击“Download”

  3. 下载完成后点击“Finish”，启动模拟器即可（操作同Android模拟器）

3. iOS平台配置（仅macOS）

iOS开发依赖Xcode，且需登录Apple ID（无需付费开发者账号，可正常调试）。

  1. 打开App Store，搜索“Xcode”下载安装（约15GB，需耐心等待）

  2. 首次启动Xcode，同意用户协议，等待额外组件安装完成

  3. 安装Xcode命令行工具：终端输入xcode-select --install，点击“安装”

  4. 配置Xcode路径：终端输入 sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer 输入电脑密码（无显示，输入完成回车即可）

  5. 启动iOS模拟器：Xcode→“Xcode”→“Open Developer Tool”→“Simulator”，选择“iPhone 15”

  6. 关联Flutter：终端输入flutter config --enable-ios-simulator

六、核心步骤5：环境完整性验证（flutter doctor命令）

“flutter doctor”是Flutter官方的环境检查工具，能自动识别所有依赖问题，是排查错误的核心命令。

1. 执行验证命令

  1. 打开新的终端/CMD窗口（确保环境变量已更新）

  2. 输入完整命令（-v参数显示详细信息，便于排查问题）： flutter doctor -v

  3. 等待命令执行完成，终端会输出检查结果，核心关注“[✓]”（正常）和“[✗]”（异常）标识

2. 常见问题及解决方案（覆盖90%异常场景）

异常提示

问题原因

解决方案

Android SDK file not found: tools/bin/sdkmanager.

Android SDK工具目录缺失

1. 打开DevEco Studio的SDK Manager；2. 勾选“Android SDK Build-Tools”和“Android SDK Command-line Tools”；3. 点击“Apply”安装

Flutter plugin not installed; this adds Flutter specific functionality.

DevEco Studio未安装Flutter插件或未重启

1. 重新安装Flutter插件；2. 重启DevEco Studio；3. 若仍异常，终端输入flutter config --ide-deveco-studio

Emulator: Error: Emulator didn't connect within 60 seconds

电脑未启用虚拟化技术

1. 重启电脑，按F2/F10进入BIOS；2. 找到“Intel VT-x”或“AMD-V”选项，设置为“Enabled”；3. Windows需关闭Hyper-V（控制面板→程序→启用或关闭Windows功能→取消勾选Hyper-V）

CocoaPods not installed or not in valid state. (iOS)

macOS缺少CocoaPods依赖

1. 终端输入sudo gem install cocoapods；2. 若报错，执行brew install cocoapods

HTTP host "https://maven.aliyun.com" is not reachable

镜像配置错误或网络不稳定

1. 重新检查镜像环境变量配置；2. 切换至稳定网络；3. 终端执行flutter clean清除缓存后重试

3. 验证通过标准

执行“flutter doctor -v”后，以下核心组件均显示“[✓]”，说明环境搭建成功：

  • Flutter

  • Dart

  • Android toolchain - develop for Android devices

  • Android Studio (version 4.1+)

  • Connected device (1 available)（模拟器已启动）

七、核心步骤6：创建并运行第一个Flutter项目

环境验证通过后，通过创建默认项目测试开发流程是否正常。

1. DevEco Studio图形化创建（推荐新手）

  1. 打开DevEco Studio，点击“Create Project”

  2. 在模板列表中选择“Flutter”→“Flutter Application”，点击“Next”

  3. 配置项目信息： Project name：项目名称（如my_first_flutter，只能小写字母和下划线）

  4. Package name：包名（如com.example.myapp，用于应用标识）

  5. Save location：项目保存路径（无中文无空格）

  6. Flutter SDK path：自动识别，若未识别手动选择SDK根目录（D:\flutter或~/development/flutter）

  7. 点击“Finish”，等待项目初始化完成（首次初始化需下载依赖，约1-3分钟）

  8. 启动模拟器（Android/鸿蒙/iOS均可），确保模拟器在DevEco Studio底部“Run”面板中显示

  9. 点击顶部工具栏“Run”按钮（绿色三角图标），选择模拟器运行项目

  10. 运行成功：模拟器显示Flutter默认计数器应用，点击右下角“+”按钮，数字递增

2. 命令行创建（进阶操作）

# 进入工作目录
cd D:\Projects  # Windows
cd ~/Projects   # macOS

# 创建项目
flutter create my_first_flutter

# 进入项目目录
cd my_first_flutter

# 运行项目（确保模拟器已启动）
flutter run

# 停止运行：按Ctrl+C（Windows）或Cmd+C（macOS）

八、后期优化：提升开发效率的配置

1. 启用热重载快捷键

  • Windows：修改代码后按Ctrl+S触发热重载

  • macOS：按Cmd+S触发热重载

  • 效果：模拟器界面毫秒级更新，无需重新运行项目

2. 安装常用插件

  • Flutter Widget Snippets：提供常用Widget代码片段，输入“stless”快速生成无状态组件

  • JSON to Dart：将JSON数据快速转换为Dart模型类，减少手动编码

  • DevEco HarmonyOS Plugin：实现Flutter与鸿蒙原子化服务的集成

3. 真机调试配置

  1. 连接手机：用USB线连接电脑，开启“开发者模式”和“USB调试”（Android/鸿蒙手机）

  2. 终端输入flutter devices，查看手机设备ID

  3. 运行项目：flutter run -d 设备ID（替换为实际设备ID）

4. SDK更新方法

# 更新Flutter SDK到最新稳定版
flutter upgrade

# 更新Dart依赖
flutter pub upgrade

# DevEco Studio更新SDK：通过SDK Manager界面勾选更新

九、总结：环境搭建的核心要点

Flutter环境搭建的核心是“环境变量配置+依赖完整性”，关键避坑点包括：

  • 路径绝对不能含中文和空格（90%的初始化失败源于此）

  • 国内必须配置镜像加速（否则SDK下载超时）

  • Java必须用11版本（DevEco Studio不兼容高版本）

  • “flutter doctor -v”是排查问题的终极工具，异常提示需逐一解决

环境搭建完成后，就可以正式进入Flutter开发阶段。后续可从基础Widget学习入手，逐步掌握布局、状态管理等核心技术，结合实战项目提升能力。如果在开发中遇到问题，可通过Flutter官方文档（https://flutter.dev/docs）或华为开发者联盟获取帮助，祝你开发顺利！

# flutter # windows # macos
Logo
HarmonyOS开发者社区

讨论HarmonyOS开发技术，专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐

鸿蒙智能待办：钉钉学而思待办自动同步日历

点外卖后不用反复打开App看取餐号，智能待办会自动归集瑞幸、KFC、麦当劳等餐饮取餐号，在取餐时间到时主动提醒。出行方面，同程旅行、携程旅行平台的票务出行、酒店订单信息也能统一归集，时序化整理后自动提醒出发时间和登机信息。升级鸿蒙6.1，让AI帮你记住每一件重要的事。还可统一归集瑞幸、KFC、麦当劳等餐饮取餐号及各类同程旅行、携程旅行平台的票务出行、酒店订单信息，并进行时序化整理和智能提醒。Har

avatar HarmonyOS开发者社区

鸿蒙AI防诈能力：场景化防诈+换脸检测+亲情防诈

用AI对抗AI，用智能对抗狡猾，这正是鸿蒙安全"更智能"的体现。在AI换脸诈骗层出不穷的今天，鸿蒙用场景化防诈、换脸检测、亲情防诈三重AI防护对抗新型威胁——安全好用才是真好用。现在，AI技术飞速发展，电信诈骗手段层出不穷，从"冒充公检法"到"AI换脸视频通话"，用户防不胜防。HarmonyOS 6的AI防护能力已扩展至AI场景化防诈、AI换脸检测、亲情防诈三大方向，用AI对抗AI，为你筑起智能化

avatar HarmonyOS开发者社区

鸿蒙开发--IAPKit-ArkTS

HarmonyOS IAP Kit 应用内购买功能摘要 HarmonyOS IAP Kit 是华为提供的应用内支付解决方案，支持三种商品类型：消耗型（如游戏钻石）、非消耗型（如永久会员）和订阅型（如月度会员）。开发者需要先在AppGallery Connect后台开通商户服务并配置商品信息（包括商品ID、名称、价格等）。在代码实现上，主要流程包括：检查支付环境、查询商品信息、发起购买请求并处理支付

avatar HarmonyOS开发者社区