ESPHome 從零開始：買什麼、怎麼接、完整設定檔，做出第一顆溫濕度感測器

charles

這篇的內容（15 段）

1. 要買什麼（總共五百塊上下）
2. 步驟 1：安裝 ESPHome Device Builder
3. 步驟 3：建立 secrets.yaml
4. 步驟 5：看日誌確認它活著
5. 步驟 7：接 BME280
6. 7-1 先認腳位
7. 7-2 逐腳接線（四條線）
8. 7-3 ⚠ 哪些 GPIO 不要碰
9. 步驟 9：驗證感測器真的在動
10. 9-1 I2C 掃描結果
11. 9-2 BME280 有沒有被認出來
12. 9-3 數值有沒有進來
13. 9-4 回到 Home Assistant 確認
14. 接下來還能做什麼
15. 值得做嗎

「自己做感測器」聽起來要會寫 C++，其實不用 —— ESPHome 的設計就是用設定檔取代寫程式。但網路上大部分入門教學是 2023、2024 年寫的，照著做會在幾個地方卡死，而且錯誤訊息看不出原因。



這一篇從「什麼都還沒買」開始，做到一顆會把溫度、濕度、氣壓回報進 Home Assistant 的感測器。中間會標出四個舊教學一定會害你卡住的地方。

先講會卡住的那四個，因為它們決定你該不該相信手上那篇舊教學：

• `platform: bme280` 這個寫法已經不存在了，拆成了 `bme280_i2c` 和 `bme280_spi`。照舊教學寫，編譯前就被擋
  
• `api:` 底下的 `password:` 在 ESPHome 2026.1.0 被移除，`encryption:` 變成必填。舊教學的設定檔直接驗證失敗
  
• ESP32 的預設編譯框架在 2026.1.0 從 arduino 改成 esp-idf。大部分元件沒差，但有幾個只能在 arduino 下編譯
  
• ESPHome 的儀表板在 2026.6.0 整個換成了 Device Builder，畫面跟舊教學的截圖完全不一樣
  

要買什麼（總共五百塊上下）

1. ESP32 開發板 —— 約 150 到 300 元

賣場搜尋關鍵字：「ESP32 開發板 ESP32-DevKitC」 或 「NodeMCU-32S」。

挑選重點：

• 一定要買「已焊好排針」的版本。有些賣家出的是排針另外附一包要自己焊 —— 那你就得先學會焊接才能開始。價差通常不到三十塊
  
• 買 ESP32 經典款（38 腳位那種），不要一開始就買 C3 或 S3。經典款的教學和範例最多，腳位配置也最單純
  
• USB 孔看清楚是 Micro-USB 還是 USB-C，線材要對得上
  

為什麼是 ESP32 而不是 ESP8266：ESP8266 更便宜（約 80 元），但它只有一組硬體 I2C、腳位少很多、而且未來要擴充（藍牙、多個感測器）就換不動。第一塊板子多花一百塊買 ESP32，省掉之後重買的麻煩。

2. BME280 感測器模組 —— 約 80 到 200 元

賣場搜尋關鍵字：「BME280 模組 溫濕度 氣壓 I2C」。

這裡有一個非常常見的陷阱：BMP280 被當成 BME280 賣。

• BME280 = 溫度 + 濕度 + 氣壓（三個）
  
• BMP280 = 溫度 + 氣壓（沒有濕度）
  

兩個外觀幾乎一樣、價格差一倍，而賣場的圖片和標題經常混用。這一篇的步驟 8 會教你怎麼用日誌一秒分辨自己買到哪一顆，所以買錯不用慌，退換就好。

另外要看的：

• 腳位數。有 4 腳（VCC / GND / SCL / SDA）和 6 腳（多 CSB / SDO）兩種，都可以用，這一篇走 I2C 只需要前四隻
  
• 電壓。標示 3.3V-5V 的板子上面有穩壓 IC，接 3.3V 或 5V 都行；只標 3.3V 的一定要接 3.3V，接 5V 會燒掉
  

為什麼是 BME280 而不是 DHT22：DHT22 更便宜也更常見，但它的濕度誤差是 ±2~5%、每兩秒才能讀一次、而且用的是單線的自訂協定（接線少一條，但容易受干擾）。BME280 走標準 I2C、精度好很多，還多送一個氣壓值。差價大概五十塊。

3. 母對母杜邦線 —— 約 30 到 60 元

賣場搜尋關鍵字：「杜邦線 母對母 20cm」。

母對母（兩端都是插孔）是關鍵 —— ESP32 和 BME280 兩邊都是公頭排針，母對母可以直接插上去，完全不用焊接。買一排 40 條的，用不完留著。

4. USB 資料線 —— 你可能已經有了

必須是「能傳資料」的線，不是只能充電的線。 手機附的充電線有一半是只有電源兩條線、沒有資料線的。這是第一次燒錄失敗最常見的原因之一，而症狀是「電腦完全看不到這個裝置」。

怎麼分辨：接上 ESP32 和電腦之後看步驟 3 的結果。沒有別的方法從外觀看出來。

5.（選配）5V 1A 以上的 USB 變壓器 —— 約 100 元

做好之後要長期供電用的。ESP32 在 Wi-Fi 發射的瞬間電流會衝到 300mA 左右，用電腦主機板上的 USB 埠或劣質變壓器供電，症狀是「跑一跑自己重開機」，而且日誌上看起來像是隨機當機。買個正常牌子的 5V/1A 以上變壓器就好。

步驟 1：安裝 ESPHome Device Builder

• 在 Home Assistant 裡打開 設定 → 應用程式 → 應用程式商店（2026.2 之前這裡叫「附加元件」）
  
• 搜尋 ESPHome
  
• 選 ESPHome Device Builder（穩定版，不要選 beta 或 dev）
  
• 按 安裝，等它跑完（第一次要幾分鐘）
  
• 裝好之後把 在側邊欄顯示 打開，然後按 啟動
  

你會看到 Home Assistant 左側選單多一個 ESPHome。點進去。

你會看到一個空白的裝置列表，中間有一個 Create device（建立裝置）的按鈕。

如果你看到的畫面跟網路上的舊截圖完全不一樣，那是正常的 —— ESPHome 2026.6.0 把用了很多年的舊儀表板整個退役了，換成 Device Builder。舊儀表板本質上只是「一個 YAML 檔的純文字編輯器」，新的多了設定編輯器、腳位圖、批次燒錄佇列、跨檔案搜尋。

以下還有約 80% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入