“The command 'arduino-verify-sketch' cannot be executed.错误解决方案

您好！您遇到的错误信息 “The command 'arduino-verify-sketch' cannot be executed. There are no active handlers available for the command.” 是一个常见的环境配置问题。这通常意味着您的操作系统无法找到或运行 arduino-verify-sketch 这个命令。

下面我将为您详细解释原因并提供完整的解决方案。

错误原因分析

这个错误的核心是 “命令未找到” 或 “命令不可执行”。具体来说，可能有以下几种情况：

Arduino CLI 未安装：arduino-verify-sketch 是 Arduino CLI（命令行界面）工具的一部分。如果您从未安装过 Arduino CLI，那么这个命令自然不存在。
环境变量 PATH 未正确配置：即使您安装了 Arduino CLI，如果它的安装目录没有被添加到系统的 PATH 环境变量中，系统就无法在任何地方识别并执行 arduino-verify-sketch 这个命令。
安装不完整或损坏：Arduino CLI 的安装过程可能出现了问题，导致核心文件缺失。
权限不足：当前用户对 Arduino CLI 的可执行文件没有执行权限。
使用了错误的工具：在某些集成开发环境（IDE）或插件中，可能会调用此命令。如果是这种情况，则需要确保 IDE 本身或其插件配置正确。

详细解决方案

请按照以下步骤逐一排查和解决问题。

步骤一：确认是否已安装 Arduino CLI

打开您的终端（Terminal）或命令提示符（Command Prompt），输入以下命令：
arduino-cli version
如果返回版本号（例如 0.36.0），说明 Arduino CLI 已安装，请直接跳到【步骤三】。
如果出现 “command not found” 或类似错误，说明未安装，请继续【步骤二】。

步骤二：安装 Arduino CLI

前往 Arduino CLI 的官方发布页面下载最新版本的文件。

下载安装包：
   对于 Windows/macOS/Linux 用户，下载对应平台的压缩包（如 .zip, .tar.gz）。
   通用方法：也可以使用 curl 直接下载（以最新稳定版为例）：
       curl -fsSL https://github.com/arduino/arduino-cli/releases/latest/download/arduino-cli_linux.tar.xz -o arduino-cli.tar.xz
       (将上述命令中的 linux 根据您的系统改为 windows 或 macos)

解压缩：
   将下载的压缩包解压到一个您喜欢的目录，例如 ~/bin 或 C:Tools。

将可执行文件移动到系统路径：
   为了方便在任何目录下使用，最好将 arduino-cli 二进制文件移动到已经在 PATH 中的目录，如 /usr/local/bin (Linux/macOS) 或 C:Windows (Windows)。
   Linux/macOS:
       sudo mv ~/Downloads/arduino-cli /usr/local/bin/arduino-cli
   Windows: 将 arduino-cli.exe 复制到 C:Windows 目录下。

步骤三：配置环境变量 PATH（如果必要）

如果在上一步中，您没有将 arduino-cli 移动到已有的系统路径下，就需要手动将其所在目录添加到 PATH 中。

找到安装目录：假设您解压到了 ~/tools/arduino-cli。
临时添加（仅当前终端会话有效）：
   export PATH="$PATH:$HOME/tools/arduino-cli" # Linux/macOS
   set PATH=%PATH%;C:toolsarduino-cli     # Windows CMD
永久添加：
   Linux: 编辑 /.bashrc 或 /.zshrc 文件，添加一行：
       export PATH="$PATH:$HOME/tools/arduino-cli"
       然后运行 source ~/.bashrc 使其生效。
   macOS: 编辑 /.zshrc 或 /.bash_profile 文件，添加方式同上。
   Windows: 通过“系统属性” -> “高级” -> “环境变量”来编辑 Path 变量。

步骤四：赋予执行权限（主要针对 Linux/macOS）

确保 arduino-cli 文件有执行权限。打开终端，运行：
chmod +x /path/to/your/arduino-cli
将 /path/to/your/arduino-cli 替换为实际的文件路径。

步骤五：验证安装

再次打开一个新的终端窗口（以确保新的环境变量生效），输入：
arduino-cli version
这次应该能成功显示版本号。

现在，您可以正常执行 arduino-cli verify sketch.ino 这样的命令了。原来的 arduino-verify-sketch 很可能是某个脚本或软件内部调用的命令，它最终也会指向 arduino-cli。修复了底层的 CLI 工具后，上层应用的问题也就解决了。

总结

| 现象 | 可能原因 | 解决方法 |
| :--- | :--- | :--- |
| command not found | 1. Arduino CLI 未安装2. 环境变量 PATH 未包含 CLI 路径 | 1. 【安装 Arduino CLI】2. 【配置环境变量 PATH】 |
| Permission denied | 可执行文件缺少执行权限 | 【赋予执行权限】(chmod +x) |
| 其他错误 | 安装损坏 | 【重新下载安装】 |

按照以上步骤操作后，您的问题应该能够得到解决。如果仍有困难，请提供更多上下文信息，例如您是在什么情况下看到这个错误的（是在 VS Code 里？还是自己写的脚本里？），以及您的操作系统是什么。

审核编辑 黄宇