【輕鬆工作家】在 Windows 11 編譯並燒錄 ESPHome 韌體（ESP32-S3 實作）
前言 把 ESPHome 的編譯搬到 Windows 11 電腦，第一次完整編譯約 10–20 分鐘，之後每次只要幾分鐘。若用 Raspberry Pi 4 上的 Home Assistant 編譯 ESP-IDF 框架的韌體，往往要等上半小時以上。 本文以 Waveshare ESP32-S3 2.06 吋 AMOLED 開發板為例，軟體設定為「藍牙代理（Bluetooth Proxy）」，用來接收小米溫濕度計等 BLE 裝置的資料轉給 Home Assistant，螢幕同時顯示 Wi-Fi 狀態、IP 位址與電池電量。其他 ESP32 板子的流程完全相同，只是 yaml 內容不同。 準備工作 項目 說明 電腦 Windows 11，硬碟預留 3 GB 以上空間 開發板 ESP32-S3（本例為 Waveshare 2.06 吋 AMOLED） 傳輸線 可傳輸資料的 USB-C 線（不是只能充電的線） 軟體 Python 3.12 或 3.13、ESPHome 網路 第一次編譯需下載約 1–2 GB 工具鏈 ESP32-S3 使用晶片內建的原生 USB，Windows 11 會自動辨識，不需要另外安裝 CP210x 或 CH340 驅動程式。 安裝 Python 與 ESPHome 到 python.org 下載 Python 3.12 或 3.13 安裝檔。 執行安裝檔時，務必勾選「Add python.exe to PATH」，再按 Install Now。 開啟 PowerShell，安裝 ESPHome： pip install esphome 確認安裝成功，會顯示版本號： esphome version 之後要升級 ESPHome，執行 pip install -U esphome 即可。 建立專案與 secrets.yaml 專案資料夾要放在短、純英文的路徑，例如 C:\esphome\ 。ESP-IDF 遇到中文路徑或過長路徑（例如雲端硬碟同步資料夾）容易編譯失敗。 資料夾裡放兩個檔案： esp32-s3-bluetooth-proxy.yaml ：裝置設定 secrets.yaml ：密碼與金鑰，讓主設定檔可以安心分享 主設定檔用 !secret 引用機密資料： ...
