您好！您遇到的錯誤信息 “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 里？還是自己寫的腳本里？），以及您的操作系統是什么。

審核編輯 黃宇