适用场景OpenHarmony 轻量系统开发、物联网 Wi-Fi 设备原型、鸿蒙南向设备入门更新时间2026年6月官网下载https://device.harmonyos.com/cn/develop/ide一、前言为什么选择 Hi3861Hi3861 是华为海思推出的2.4GHz Wi-Fi SoC 芯片内置 Cortex-M0 内核支持 OpenHarmony 轻量系统LiteOS-M。它广泛应用于智能家居、传感器节点、远程控制等物联网场景是学习鸿蒙南向开发的理想起点。二、方案选择方案适用人群优点缺点Windows DevEco Device Tool 个人贡献工具链⭐初学者、快速验证一键安装、工具链解压即用、示例代码完整社区维护非官方Windows DevEco Device Tool官网流程追求官方支持官方文档完善工具链需手动下载配置示例代码不全Linux DevEco Device ToolUbuntu 用户原生 Linux 环境内存要求较高16GBUbuntu 命令行编译深度开发者贴近生产环境配置复杂⭐ 强烈推荐新手使用个人贡献的 DevTools_Hi3861V100_v1.0 工具链完整示例代码仓库5 分钟完成环境搭建。三、Windows 环境搭建推荐方案3.1 系统要求操作系统Windows 10 64位内存8GB 及以上建议 16GB硬盘100GB 及以上分辨率1280×800 像素及以上3.2 下载安装 DevEco Device Tool必须从官网⚠️ 重要DevEco Device Tool必须从官网下载安装包不要从 VSCode 插件市场直接安装。访问官网https://device.harmonyos.com/cn/develop/ide下载devicetool-windows-tool-4.0.0.400.zip194MB解压并运行安装程序安装过程中自动集成 VSCode DevEco Device Tool 插件一定要先下载好python3.83.3 下载个人贡献工具链⭐ 关键步骤由于 Windows 下 DevEco Device Tool 无法直接下载工程且官网工具链配置繁琐社区贡献者打包了一站式工具链资源地址说明编译烧录工具链https://atomgit.com/zjx_jason/DevTools_Hi3861V100_v1.0含riscv32-unknown-elf-gcc、gn、ninja、HiBurn、CH341SER驱动完整示例代码https://atomgit.com/zjx_jason/Hi3861含 DHT11、OLED、MQTT、华为云等完整示例该工具链和示例代码由HiSpark 社区 / zjx_jason个人贡献包含riscv32-unknown-elf-gcc编译工具链gn、ninja构建工具HiBurn烧录工具CH341SER.EXEUSB 转串口驱动DHT11 温湿度传感器、0.96寸 OLED、MQTT 上传华为云等完整示例代码解压路径建议使用纯英文路径如D:\DevTools_Hi3861V100_v1.0不要放在中文目录或桌面。四、获取源码并导入工程4.1 问题说明在 Windows 环境下DevEco Device Tool 无法直接从 IDE 内下载/拉取 OpenHarmony 工程源码。必须通过Git 命令行先手动克隆源码到本地然后再导入到 IDE 中。4.2 安装 Git如果尚未安装 Git先下载安装官网https://git-scm.com/download/win安装时勾选 “Git Bash Here” 和 “Use Git from the Windows Command Prompt”4.3 克隆源码两种方式方式一使用个人贡献的完整示例代码⭐ 推荐该仓库包含更完整的示例代码DHT11、OLED、MQTT、华为云等# 创建工作目录放在磁盘根目录避免 Windows 260 字符路径限制mkdirD:\OpenHarmonycdD:\OpenHarmony# 克隆完整示例代码gitclone https://atomgit.com/zjx_jason/Hi3861.git方式二使用 HiSpark 官方 SDKmkdirD:\OpenHarmonycdD:\OpenHarmony# 克隆 HiSpark SDK体积小约 413MBgitclone https://gitee.com/HiSpark/hi3861_hdu_iot_application.git⚠️Windows 路径限制由于 Windows 自身限制路径不能超过 260 个字符。Git 下载和解压时尽量放在磁盘根目录下否则会导致编译报错account_related_group_manager_mock.c: No such file or directory。4.4 导入工程到 DevEco Device Tool打开 VSCode按CtrlShiftP→ 输入DevEco: Import Project选择刚才 Git 克隆的源码目录SOC 选择HI3861开发板选择hi3861点击导入4.5 配置工具链路径点击左侧工程配置Project Settings找到compiler_bin_path选项选择之前下载的DevTools_Hi3861V100_v1.0文件夹路径确保指向env_set.py文件所在的目录层级五、编译验证5.1 编译VSCode 底部工具栏点击Build按钮或使用快捷键CtrlShiftB初次编译约需2分30秒使用裁剪后的 SDK编译成功后会在out/目录下生成Hi3861_wifiiot_app_allinone.bin文件。5.2 烧录可选验证硬件安装驱动如电脑未安装 CH340G 驱动运行DevTools_Hi3861V100_v1.0/usb_serial_driver/CH341SER.EXE连接开发板USB 线连接电脑配置烧录端口点击左侧工程配置找到upload_port选择开发板对应的 COM 口点击烧录IDE 内点击 Upload或使用BurnTool.exe烧录参数Baud: 921600Flash 起始地址: 0x0烧录过程约 30 秒。六、命令行编译方式可选如果你习惯命令行可以使用工具链自带的脚本# 进入工具链目录双击运行 env_start.bat进入专用命令行环境D:\DevTools_Hi3861V100_v1.0env_start.bat# 切换到 SDK 的 src 目录[DevTools]D:\DevTools_Hi3861V100_v1.0cdD:\OpenHarmony\Hi3861\src# 编译[DevTools]D:\OpenHarmony\Hi3861\srchbset[DevTools]D:\OpenHarmony\Hi3861\srchb build编译后使用BurnTool.exe烧录镜像。七、常见问题排查问题现象可能原因解决方案IDE 内无法下载工程Windows 版限制必须先用 Git 克隆再导入编译报错路径过长Windows 260 字符限制将 SDK 放在磁盘根目录如D:\OpenHarmony\找不到 DevEco 命令未从官网安装必须从官网下载安装包烧录时端口消失串口被占用关闭其他串口调试工具设备管理器显示未知 USB驱动未安装运行CH341SER.EXE安装驱动编译提示找不到工具链路径配置错误检查compiler_bin_path是否指向env_set.py所在目录烧录后无输出波特率不匹配串口工具设置为 115200 波特率八、总结Hi3861 的 Windows 开发环境核心要点DevEco Device Tool必须从官网下载安装包源码必须通过 Git 克隆IDE 内无法直接下载使用个人贡献的 DevTools_Hi3861V100_v1.0 工具链省去手动配置使用个人贡献的 Hi3861 完整示例代码包含 DHT11、OLED、MQTT、华为云等实战代码路径必须用英文且尽量短避免 Windows 260 字符限制掌握这套流程后30 分钟内即可完成环境搭建并编译通过。参考资源资源地址说明DevEco Device Tool 官网https://device.harmonyos.com/cn/develop/ide官方 IDE 下载个人贡献工具链https://atomgit.com/zjx_jason/DevTools_Hi3861V100_v1.0含编译工具、烧录工具、驱动个人贡献完整示例代码https://atomgit.com/zjx_jason/Hi3861含 DHT11、OLED、MQTT、华为云示例HiSpark SDK 源码https://gitee.com/HiSpark/hi3861_hdu_iot_application官方裁剪版 SDKOpenHarmony 完整源码https://gitee.com/openharmony完整系统源码官方文档Windows 编译指南https://device.harmonyos.com/cn/docs/documentation/guide/hi3861-windows-0000001445255984华为官方指南