返回首页
HELP · v3.2.1

安装与使用
完整指引

本页帮助你顺利完成 HiPiiDo Studio 的安装。如果在安装过程中看到系统的安全提示, 请不要担心 —— 我们会一步步说明如何处理。

/ 01 — Download

下载软件

请根据你的电脑型号选择对应的安装包, 文件大小约 120–160 MB。

macOS

macOS 用户

不知道自己是哪种?

1. 点击屏幕左上角的 苹果菜单

2. 选择「关于本机」

3. 在弹窗里看「芯片」或「处理器」那一行 ——

  • • 写的是 Apple M1 / M2 / M3 / M4 → 下载 Apple Silicon
  • • 写的是 Intel Core i5 / i7 之类 → 下载 Intel
/ 02 — macOS Install
仅 Mac

macOS 安装

1

双击下载好的 .pkg 文件

系统会启动一个安装向导。

2

按照向导一路点「继续」、「安装」

中途需要输入一次 Mac 登录密码以授权安装。安装包会自动把 HiPiiDo Studio 放进「应用程序」文件夹。

3

在「启动台」中找到 HiPiiDo Studio, 点击打开

首次打开 macOS 可能会询问是否确认打开, 点「打开」即可。

HiPiiDo Studio 已通过 Apple Developer ID 签名, 不会出现「无法验证开发者」的警告。如遇到此类情况, 请查看下方「常见问题」
/ 03 — Windows Install
仅 Windows

Windows 安装

在开始之前请知悉

HiPiiDo Studio 是为青少年硬件编程教育打造的安全软件。Windows 系统对所有新发布的软件都会显示安全警告, 这是正常的保护机制, 并不代表软件有问题。下方会一步步告诉你如何顺利安装。

1

下载好的是一个压缩包 HiPiiDo-Studio-Windows.zip, 先解压

右键压缩包 → 选「解压到当前文件夹」或「全部解压」。Windows 10 / 11 都自带解压功能, 不需要额外软件。

2

双击解压后的安装程序 .exe

解压出来的文件夹里有一个 HiPiiDo Studio 的安装程序, 双击它启动安装。

3

看到蓝色窗口:「Windows 已保护你的电脑」

这个窗口默认只显示一个「不运行」按钮 —— 请不要点它。窗口左上角文字下方有一行小字「更多信息」, 这是一个可点击的链接, 点它。

4

点击展开后出现的 「仍要运行」 按钮

点击「更多信息」之后, 窗口会展开显示应用名称、发布者等信息。最下方会出现两个按钮:「仍要运行」和「不运行」。点击 「仍要运行」 即可进入安装。

5

按照安装向导一直点「下一步」即可

安装完成后, 桌面会出现 HiPiiDo Studio 的快捷方式。

某些杀毒软件可能误报 · 如果 360 安全卫士 / 火绒 / 腾讯电脑管家提示拦截, 请选择「允许此程序」或「加入信任区」。这同样是正常现象。
/ 04 — First Run

首次启动

第一次打开 HiPiiDo Studio 时, 主界面会显示积木编程区域。你可以:

  • 左侧是积木库, 按类别拖到中间画布
  • 顶部右侧选择你的开发板(Arduino Uno / ESP32 / Nano 等)
  • 下载按钮把代码上传到连接的硬件
  • 右下角浮动小飞 AI 随时问问题(需登录开通)
/ 05 — Drivers

连接 Arduino 硬件

通过 USB 线把开发板连到电脑后, 如果 HiPiiDo Studio 识别不到设备, 通常是缺少串口驱动。

CH340 / CH341

国产兼容 Arduino

大多数国产 Arduino Uno / Nano 用这个芯片

前往官网下载
CP2102 / CP210x

ESP32 / ESP8266 常用

部分 ESP 系列开发板需要

前往 Silicon Labs
USB 数据线坑 · 很多廉价 USB 线只能充电、不能传输数据, 导致电脑完全识别不到开发板。请使用 Arduino / 数码产品标配的数据线。
/ 06 — Update

更新软件

打开 HiPiiDo Studio 顶部菜单 「帮助 → 版本更新」 , 可检查是否有新版。如果发现新版本, 点「下载」会跳转浏览器到本页面下载最新安装包, 然后按上文流程重新安装即可(原项目数据不会丢失)。

/ 07 — FAQ

常见问题

Mac 打开时提示「已损坏, 无法打开」

这通常是因为 macOS 给从浏览器下载的文件加了「隔离属性」。打开「终端」(Launchpad → 其他 → 终端), 粘贴运行下面这条命令, 然后再打开 HiPiiDo Studio:

sudo xattr -r -d com.apple.quarantine /Applications/HiPiiDo\ Studio.app

运行时会要求输入开机密码(输入时屏幕看不到字符, 这是正常的)。

Mac 下载了 Apple Silicon 版本, 但电脑是 Intel(或反过来)

Apple Silicon 版本在 Intel Mac 上会拒绝运行。Intel 版本可以在 M 芯片 Mac 上运行(通过 Rosetta), 但性能较慢。建议根据机型下载对应版本。

Win 安装完打不开, 双击没反应

请尝试以下任一方法:

  • • 右键 HiPiiDo Studio 图标 → 选「以管理员身份运行」
  • • 暂时关闭杀毒软件, 再启动一次
  • • 检查 Windows 版本:需要 Windows 10 1809 或更新
  • • 卸载后重启电脑, 再重新安装一次
Win Mac 连接了 Arduino 但 HiPiiDo 找不到设备

按以下顺序排查:

  • 1. 确认 USB 线是数据线(不是只能充电的线)
  • 2. 安装 对应的串口驱动
  • 3. 重新插拔 USB, 或换一个 USB 接口
  • 4. 在 HiPiiDo 主界面右上角点「刷新设备」
  • 5. Mac 用户:首次连接可能要在「系统设置 → 隐私与安全」允许 HiPiiDo 访问可移动卷
升级新版本, 我之前的项目会丢吗?

不会。所有项目文件保存在云端账号下, 只要重新登录, 所有项目都在。本地的设置和缓存也会保留。

HiPiiDo Studio 安全吗?为什么 Windows 会提示警告?

HiPiiDo Studio 完全安全。我们正在为 Windows 版本申请微软代码签名认证 —— 这是一个有偿的认证流程, 周期通常需要 1–3 周。在认证完成之前, 所有新发布的 Windows 软件都会被系统标记为「未识别应用」, 这是 Windows 的统一保护机制, 与软件本身的安全性无关。

Mac 版本已经通过 Apple Developer ID 签名, 不会有此问题。

/ 08 — Contact

还是没解决?

把遇到的问题、操作系统版本和错误截图发给我们, 会有人工回复。

hipiido@163.com