Sublime Text配置Arduino开发环境详细教程-sublime-PHP中文网

sublime text 需通过 arduino-cli 实现 arduino 开发，stino 插件因依赖过时的 arduino ide 1.x 结构已失效；必须手动配置 arduino-cli 路径、fqbn、串口及 include_dirs 才能编译上传并支持跳转。

sublime text配置arduino开发环境详细教程

Sublime Text 不能直接编译或上传 Arduino 代码，它连 Arduino.h 都不认识——所有“Build succeeded”提示，都是靠调用外部 arduino-cli 实现的。想让它真正干活，你得亲手配好命令路径、FQBN、串口设备，漏一个环节，Build failed 就立刻报给你看。

为什么 Stino 插件现在基本不能用

Stino 依赖 Arduino IDE 1.x 的内部结构（比如硬编码读取 boards.txt、调用 Java 组件），而官方早已转向 arduino-cli 2.x，配置全变成 JSON 和扁平化目录。你现在装 Stino，大概率遇到：

Stino: Error: Failed to parse boards list
AttributeError: 'NoneType' object has no attribute 'get'
菜单项全灰、串口识别为空、上传无响应

它不读 arduino-cli config，还会覆盖你本地的平台配置。截至 2026 年 5 月，Stino 已无实质维护，GitHub 最后一次提交是 2017 年。

必须用 arduino-cli，且要手动加进系统 PATH

别下 Arduino IDE 图形版再试图“集成”——你要的是命令行工具链本身。正确做法是：

从 arduino-cli 官方 releases 下对应系统的二进制（如 arduino-cli_0.40.2_macOS_64bit.tar.gz）
解压后把 arduino-cli 文件移到 /usr/local/bin（macOS/Linux）或加到 Windows 的系统环境变量 PATH
终端运行 arduino-cli version 确认可执行；再跑 arduino-cli config init 生成默认配置
执行 arduino-cli core update-index && arduino-cli core install arduino:avr 安装 Uno/Nano 所需核心

验证是否真通：在空目录放个 Blink.ino，终端执行 arduino-cli compile -b arduino:avr:uno .，能生成 .hex 文件才算过关。

妙刷AI

妙刷AI是一款面向图片改造、风格转换和视频创作的 AI 视觉生成工具。

下载

Sublime 自定义 Build System 必须写对这四点

Tools → Build System → New Build System，填入以下内容（注意替换实际值）：

{
  "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/cu.usbmodem*", "--fqbn", "arduino:avr:uno", "$file_path"]
    }
  ]
}

关键细节：

$file_path 必须指向整个 sketch 目录（含同名文件夹 + .ino 文件），不是单个 .ino 文件
/dev/cu.usbmodem* 要按实际串口改：macOS 用 ls /dev/cu.* 查，Windows 是 COM3 这类，Linux 是 /dev/ttyUSB0
FQBN 必须精确匹配：运行 arduino-cli board listall | grep -i uno 看真实标识（可能是 arduino:avr:uno 或 arduino:avr:nano）
"selector": "source.arduino" 比 source.cpp 更准——它让 Ctrl+B 只在 .ino 文件里生效，避免误触发

头文件跳转失效？只有两个有效解法

Ctrl+Click Wire.h 提示 “No definition found”，是因为 Sublime 默认不索引 Arduino 核心库路径。可行方案只有：

轻量级：在 Build System JSON 里加 "include_dirs"，例如：
"include_dirs": ["/Users/xxx/Library/Arduino15/packages/arduino/hardware/avr/1.8.6/cores/arduino", "/Users/xxx/Library/Arduino15/packages/arduino/hardware/avr/1.8.6/variants/standard"]
更稳但稍重：装 EasyClangComplete 插件，然后执行 arduino-cli compile --export-binaries --verbose，从日志里复制所有 -I 开头的路径，填进 ecc_config.json

别信“重启 Sublime 就自动识别”的说法——Arduino 库路径是动态生成的，不显式声明，Sublime 就真看不见。