如何配置Sublime Text作为Arduino开发环境，实现编写和调试Arduino代码？

本文共计825个文字，预计阅读时间需要4分钟。

Stino 是基于已停止更新的 Arduino IDE 1.x 架构的，无法解析 2.x 版本的 arduino-cli 和 boards.local.json 以及扁平化平台目录，常见错误包括：

必须独立安装 arduino-cli，别碰 Arduino IDE 自带的

Arduino IDE 安装包里的 arduino-cli 藏在深层路径（如 Contents/Java/bin/arduino-cli），PATH 不自动添加，版本难更新，Sublime 启动时根本找不到。

• 去 GitHub releases 下载对应系统二进制：Windows 选 .exe，macOS 选 arm64 或 amd64，Linux 选对应架构
• 解压后放固定路径：/usr/local/bin/arduino-cli（macOS/Linux）或 C:\arduino-cli\arduino-cli.exe（Windows）
• 终端运行 arduino-cli version 确认可用；再执行 arduino-cli core update-index && arduino-cli core install arduino:avr 装好 Uno/Nano 所需核心
• Windows 用户注意：若同时用 Git Bash 或 WSL，arduino-cli 得装两份——一份给 Sublime（调用 cmd/powershell），一份给终端（路径别混）

Build System 必须写死 arduino-cli 绝对路径

Sublime 启动时不加载你的 ~/.zshrc 或 PATH，哪怕终端里 which arduino-cli 有结果，Build 仍会报 command not found。唯一可靠方式是绕过 PATH，显式填绝对路径。

• Tools → Build System → New Build System，内容示例：
• "cmd": ["/usr/local/bin/arduino-cli", "compile", "--fqbn", "arduino:avr:uno", "$file_path"]
• "working_dir": "$file_path" —— $file_path 必须是完整 sketch 目录（含同名文件夹和 .ino 文件），不能只选中单个 .ino
• "selector": "source.arduino" —— 确保只对 .ino 文件生效，避免误触发
• "-p" "/dev/cu.usbmodem14201" 中的串口名要按实际替换：macOS 查 ls /dev/cu.*，Windows 是 COM3 类，Linux 是 /dev/ttyACM0
• FQBN 必须写全：arduino:avr:uno ≠ uno；查可用板型用 arduino-cli board listall

头文件跳转失效？不是插件问题，是 Sublime 没索引硬件包路径

Ctrl+Click Wire.h 提示 No definition found，是因为 Sublime 默认不扫描 arduino-cli 安装的核心库路径。解决方法只有两个有效路径：

• 轻量做法：在 Build System 配置里加 "include_dirs": ["/Users/xxx/Library/Arduino15/packages/arduino/hardware/avr/1.8.6/cores/arduino"]（路径可通过 arduino-cli compile --export-binaries --verbose 查日志中 -I 开头的路径）
• 或装 EasyClangComplete，并在其 ecc_config.json 中手动添加上述 -I 路径
• 别信“Arduino IDE for Sublime”这类旧插件，它们不会自动同步 arduino-cli 的硬件包结构

复杂点在于：每次换开发板或升级 arduino-cli 核心，FQBN、串口、include 路径都得手动核对一遍；这些路径不是一次配置永久有效，而是随工具链状态实时变化。