Arduino CLI编译错误：Platform 'Arduino:avr' not found问题解析

问题现象

在使用Arduino CLI进行项目编译时，用户可能会遇到如下错误提示：

Error during build: Platform 'Arduino:avr' not found: platform not installed
Try running `arduino-cli core install Arduino:avr`

即使用户已经执行了建议的安装命令并确认平台已安装，该错误仍然会出现。

根本原因

这个问题的核心在于Arduino CLI对FQBN（完全限定板名称）的严格区分大小写要求。在Arduino生态系统中：

• 正确的供应商名称应为全小写的"arduino"
• 用户错误地使用了首字母大写的"Arduino"

技术细节

FQBN由三部分组成，格式为供应商:架构:板型。在AVR架构的Uno板子场景中：

• 错误写法：Arduino:avr:uno
• 正确写法：arduino:avr:uno

这种大小写敏感性源于：

1. Arduino工具链的历史设计决策
2. 底层包管理系统对标识符的精确匹配要求
3. 跨平台兼容性考虑（Linux系统对大小写敏感）

解决方案

要解决此问题，只需在编译命令中使用正确的大小写格式：

arduino-cli compile --fqbn arduino:avr:uno Blink.ino

最佳实践建议

1. 统一使用小写：Arduino生态系统中大多数标识符都采用全小写形式
2. 验证安装：可通过arduino-cli core list命令查看已安装平台的确切名称
3. 版本检查：确保CLI工具和核心库版本兼容
4. 环境配置：在Windows系统上特别注意路径和权限设置

扩展知识

理解FQBN的组成对Arduino开发很重要：

• 供应商(vendor)：标识硬件制造商（如arduino、esp8266等）
• 架构(architecture)：芯片架构类型（如avr、samd等）
• 板型(board)：具体开发板型号（如uno、nano等）

掌握这些基础知识可以帮助开发者更高效地使用Arduino CLI工具链，并为后续的多平台开发打下基础。