Stino插件因依赖已废弃的Arduino IDE 1.x架构,无法兼容Arduino CLI 2.x及Sublime Text 4.x,导致命令报错、板卡识别失败;推荐改用持续更新的PlatformIO插件,或手动配置Arduino CLI构建系统。

Sublime Text 本身不原生支持 Arduino 开发,必须通过插件补全编译、上传、串口监控等能力;Stino 曾是主流选择,但它已停止维护多年,与新版 Arduino CLI(≥2.0)和现代 Sublime(4.x)完全不兼容,强行安装会导致命令报错、板卡识别失败、上传无响应等问题。
Stino 插件为什么现在不能用
Stino 依赖 Arduino IDE 1.x 的内部结构(如 arduino-core.jar、hardware/arduino/avr/boards.txt 路径约定),而 Arduino CLI 2.x 彻底重构了配置格式(改用 boards.local.json、platforms 目录扁平化)、移除了 Java 组件,并要求显式调用 arduino-cli 命令行工具。Stino 的代码里仍硬编码调用 arduino 可执行文件,且无法解析新平台索引,所以:
Stino: Error: Cannot find arduino executable Stino: Error: Failed to parse boards list Stino: Upload failed: no serial port found
替代方案:用 PlatformIO 插件(推荐)
PlatformIO 是当前 Sublime Text 下唯一稳定、持续更新、完整覆盖 Arduino 生态的开发方案,它直接集成 arduino-cli,支持 ESP32、nRF52、RP2040 等全部主流平台,且无需手动配置路径。
- 安装方式:Sublime Text →
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索并安装PlatformIO IDE - 首次使用会自动下载
platformio-core和默认平台(如atmelavr),耗时较长但只需一次 - 新建项目时选择
Arduino框架 + 对应板型(如Arduino Uno),自动生成platformio.ini配置文件 - 编译用
Ctrl+B,上传用Ctrl+Alt+U,串口监视器用Ctrl+Alt+I
如果坚持用 Arduino CLI 命令行 + Sublime(轻量级)
跳过所有插件,把 Sublime 当纯编辑器,用终端驱动开发流程,适合熟悉 CLI、追求可控性的用户:
- 确保系统已安装最新
arduino-cli(非 Arduino IDE),并加入PATH(验证:终端运行arduino-cli version) - 在 Sublime 中打开 Arduino 项目根目录(含
.ino文件),按Ctrl+Shift+P→Build With...→ 新建自定义构建系统 - 保存为
ArduinoCLI.sublime-build,内容如下:{ "cmd": ["arduino-cli", "compile", "--fqbn", "arduino:avr:uno", "$file_path"], "working_dir": "$file_path", "selector": "source.arduino", "variants": [ { "name": "Upload", "cmd": ["arduino-cli", "upload", "-p", "/dev/ttyUSB0", "--fqbn", "arduino:avr:uno", "$file_path"] } ] } - 注意替换
/dev/ttyUSB0为你的实际串口(Windows 是COM3,macOS 是/dev/cu.usbmodem*) - 每次上传前需手动确认板子型号
fqbn是否匹配(查法:arduino-cli board listall | grep -i uno)
真正卡住人的不是插件装不上,而是没意识到 Stino 和 Arduino CLI 2.x 是两个互不认领的技术代际——要么换到 PlatformIO 这条正向演进的路,要么退回到纯 CLI 手动控制。后者看着简单,但串口权限、板载调试、库路径冲突这些细节,比想象中更费时间排查。










