【花雕动手做】Aily Blockly 安装 + 环境配置清单 + 避坑指南

项目情况Aily Blockly 是 Aily Project 推出的开源、AI 驱动的硬件图形化开发 IDE核心是用 “拖拽积木 自然语言对话 端云协同编译” 大幅降低嵌入式ESP32/Arduino/STM32开发门槛兼顾新手易用与工业级工程化能力。1、核心定位与背景全称Aily Blockly隶属 Aily Project技术底座Electron Angular Google Blockly AI 大模型核心目标打破专业嵌入式与业余创客的壁垒长期愿景是自然语言编程一句话生成完整项目状态开源GitHub 1.8k Star、跨平台Windows/macOS/Linux、免费公测主创背景点灯科技Blinker 物联网平台团队创始人奈何 col 为 Arduino 中文社区创建者2、核心功能四大杀手锏1工程化依赖管理解决 “库版本地狱”项目隔离每个项目独立管理开发板核心Core与库版本互不干扰类似前端 package.json一键库管理内置库管理器支持安装 / 更新 / 切换版本彻底避免传统 Arduino IDE 全局库冲突开箱即用无需手动配置工具链安装即可开发2端云协同闪电编译60 倍提速传统痛点ESP32 项目本地编译常需 20–60 分钟Aily 方案云端预编译缓存 本地增量编译效果编译时间从1 小时压缩至 1 分钟大型项目优势更明显3AI 全流程辅助从需求到代码AI 项目生成自然语言描述需求如 “ESP32 温湿度监测DHT11OLED 显示”AI 自动完成硬件选型、模组推荐、引脚分配、工程创建、代码生成AI 代码生成图形化编程中AI 可将自然语言转为积木逻辑或 MicroPython 代码AI 转库核心杀招上传任意 Arduino C 库AI 自动解析并生成 Blockly 积木无限扩展图形化生态传统图形化编程无积木则无法用第三方库4多硬件平台 专业调试支持芯片ArduinoAVR、ESP32、STM32、RP2040 等 30 芯片、80 开发板内置工具全能串口调试数据可视化、U8G2 取模、点阵编辑等项目广场海量开源案例物联网、AI、传感器一键导入运行3、优势对比vs 传统 Arduino IDE一、安装前准备1、系统要求2、环境依赖3、下载渠道aily blockly官网https://aily.pro/homehttps://yysc.tech/homehttps://yiyu.pro/homeaily blockly项目地址https://github.com/ailyProject/aily-blockly镜像仓库https://gitee.com/mirrors/aily-blockly项目文档 : https://yiyu.pro/doc项目交流https://github.com/orgs/ailyProject/discussions下载地址1https://aily.pro/download下载地址2Githubhttps://github.com/ailyProject/aily-blockly/releases下载对应系统安装包目前版本 V 0.9.51获取源码 / 最新版2026.5.15安装无脑下一步路径不含中文、空格、特殊符号二、安装步骤清单□ Step1: 下载对应系统安装包约150MB → Windows: aily-blockly-Setup-0.9.51.exe → macOS: aily-blockly-0.9.51.dmg □ Step2: 关闭杀毒软件可选避免误报 □ Step3: 双击安装包一路“下一步” → Windows建议默认路径 C:\Users\{用户名}\AppData\Local\Aily Blockly → macOS拖拽到Applications文件夹 □ Step4: 等待安装完成约2-3分钟 □ Step5: 首次启动 → 官网注册/登录 → 进入主界面[citation:2]□ Step6: 【避坑】确认左侧开发板列表正常加载 → 若空白检查网络需访问GitHub/npm源⚠️ 国内用户特别配置由于部分资源托管在境外国内用户建议设置npm镜像源npm config set registry https://registry.npmmirror.com如果GitHub Releases下载慢使用Gitee镜像三、项目创建配置清单新建项目流程□ Step1: 点击“新建项目” → 输入项目名称这里写的K10 □ Step2: 选择开发板搜索行空板 → 常用选择 • ESP32系列esp32:esp32:esp32 • ESP32-S3esp32:esp32:esp32s3AI语音等高性能项目推荐[citation:1]• Arduino Unoarduino:avr:uno □ Step3: 等待工具链自动下载首次选板需下载SDK约200-500MB □ Step4: 添加需要的库项目级隔离不影响其他项目[citation:1]□ Step5: 【可选】配置AI API Key → 设置 → AI服务 → 未配置时部分AI功能不可用[citation:8]成功创建“K10” 项目添加需要的库这里添加了RGB灯带驱动库和IIC电机驱动库四、核心坑点与避坑指南 坑点1安装后白屏/无法加载现象安装完成打开界面空白或卡在加载页。原因网络问题无法访问GitHub/npm源首次启动需要下载运行时资源杀毒软件拦截解决方案检查网络尝试开启代理国内用户配置npm镜像源临时关闭杀毒软件后重试删除配置缓存C:\Users{用户名}\AppData\Roaming\Aily Blockly\ 后重启 坑点2开发板识别失败/烧录不了现象点击烧录后提示“No serial port found”或一直等待连接。原因90%是USB线问题用了充电线无数据功能驱动未安装尤其是CH340/CP210x端口被其他程序占用如Arduino IDE、串口助手解决方案✅ 换用数据线手机原装线通常是数据线安装对应驱动CH340http://www.wch.cn/download/CH341SER_EXE.htmlCP210xhttps://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers关闭所有其他串口软件Windows检查设备管理器 → 端口(COM和LPT) 是否有新增设备 坑点3云端编译超时/失败现象点击闪电编译后长时间等待或报错。原因未登录账号云端编译需要登录网络不稳定开发板配置不完整解决方案确认已登录界面右上角头像 → 登录状态首次编译某开发板时确保本地SDK已完全下载网络不佳时可尝试本地编译模式检查项目目录路径是否包含中文/空格建议全英文路径 坑点4AI功能无法使用/报错现象点击AI按钮无响应或提示功能不可用。原因未登录账号AI功能需要邀请码内测阶段未配置API Key网络无法访问AI服务解决方案获取邀请码https://c.yiyu.pro/join/YY1F392KAEM登录后确认AI服务状态在设置中配置API Key如需自备检查网络是否能访问OpenAI/国内AI服务 坑点5库安装失败/找不到库现象添加依赖库时报错或编译时提示“xxx library not found”。原因库名输入错误网络问题无法下载该库尚未被AI转换部分小众库需手动转换解决方案使用AI转库功能提供原生Arduino库AI自动生成Blockly积木检查库名称是否拼写正确区分大小写使用内置库管理器浏览可用库若网络问题手动下载库放入 项目目录/node_modules/ 坑点6编译成功但硬件无反应现象提示烧录成功但LED不闪、传感器无数据。原因引脚配置与接线不符电源供电不足尤其是WiFi/屏幕等耗电外设代码逻辑问题解决方案对照AI生成的接线图逐根检查外接供电USB-Hub供电不足时改用电脑直连或加供电使用串口监视器查看调试输出内置串口工具先跑简单测试如Blink确认板子正常 坑点7多项目切换时依赖混乱现象项目A正常切换到项目B后编译报错。原因Aily Blockly的设计是项目级隔离不会混乱。但可能存在项目B未正确配置开发板项目B缺少必要的库解决方案确认每个项目独立配置了开发板使用“克隆项目”功能复制配置查看项目目录下的 package.json 确认依赖五、快速检查清单首次启动必查启动前检查 □ USB数据线是数据线非充电线 □ 开发板驱动已安装 □ 已注册账号并登录 □ 网络稳定能访问GitHub/npm 创建项目检查 □ 项目路径不含中文/空格 □ 选择了正确的开发板型号 □ 工具链下载完成首次选板稍等几分钟 □ 依赖库已添加 烧录检查 □ 开发板已连接电脑 □ 无其他串口程序占用端口 □ 编译成功约1分钟[citation:3]□ 烧录成功后硬件运行 遇到问题时 □ 查看内置串口监视器输出 □ 检查接线是否与AI生成的图一致 □ 查看官方文档https://yiyu.pro/docAily Blockly小结1、定位开源 AI 驱动嵌入式图形化编程软件主打拖拽积木 AI 写硬件程序2、支持ESP32、Arduino、STM32 等主流开发板3、核心亮点1云端极速编译大幅提速2AI 一句话生成项目、自动转第三方库积木3项目独立管库告别版本冲突4、适用零基础学硬件、创客做项目、少儿编程教学5、优势比传统 IDE 更简单、更快、更智能