範本（Template）入門：九個步驟，從編輯器一路做到會動的範本實體

charles · 發表於 2026-9-21 02:00:40

這篇的內容（18 段）

2-1 試一個不存在的實體
2-2 一個好用的參數
步驟 3：state_attr()，拿屬性
3-1 屬性名稱打錯會怎樣
步驟 4：時間相關
4-1 一個比 now().hour 好用的東西
5-2 正確的寫法
5-3 預設值要填多少
7-1 組合條件
步驟 9：在自動化裡用範本
9-1 當條件用
9-2 當觸發用
9-3 驗證你的自動化
10-1 「現在有幾盞燈還開著」
10-2 「把它們的名字列出來」
10-3 組合成一則實際的通知
五種常見錯誤與它們長什麼樣
練習：把這三題寫出來

範本看起來很可怕（一堆大括號），但日常會用到的就那幾個函式。這一篇每一步都在一個可以即時看到結果的編輯器裡做，貼上去、看右邊、改一個字再看一次。最後會把它變成一個真的實體。

⚠ 先更正一件很多舊教學都寫錯的事

範本編輯器已經不在「開發者工具」底下了，因為那個頁面本身搬過家也改過名：

2026.2 —— 開發者工具被移出側邊欄，併進設定裡
2026.8 —— 名字從「開發者工具」改成「工具」

現在的路徑是：設定 → 工具 → 範本。 官方文件現在的寫法就是「開啟 Settings > Tools > Template」。

找不到的話按 Ctrl+K（Mac 是 Cmd+K）叫出快速搜尋，打「範本」或「template」。

步驟 1：打開範本編輯器，確認它會動

設定 → 捲到最下面的工具 → 範本分頁

你會看到：畫面分成左右兩半。左邊是可以編輯的文字區（裡面預設有一段示範的範本），右邊是即時的結果。

把左邊的東西全部刪掉，貼上這一行：

{{ 1 + 1 }}

複製代碼

你會看到：右邊出現

2

複製代碼

右邊沒反應 → 重新整理頁面。右邊出現紅字 → 你貼的時候多了或少了一個大括號。

這個編輯器的價值在於它不用重啟：改一個字，右邊立刻變。所有範本都應該先在這裡試通，再貼進設定檔或自動化。

步驟 2：第一個函式 —— states()，拿某個東西的狀態

先去找一個真的實體 ID：切到旁邊的狀態分頁，隨便找一個溫度感測器，把左欄那串完整複製起來。

回到範本分頁，貼上（實體 ID 換成你自己的）：

{{ states('sensor.ke_ting_wen_du') }}

複製代碼

你會看到：右邊出現一個數字，例如

26.4

複製代碼

⚠ 那是文字，不是數字。 官方對 states() 的說明就是「回傳實體目前的狀態，以文字值表示」。這一點在步驟 5 會變成最大的坑。

2-1 試一個不存在的實體

{{ states('sensor.gen_ben_mei_you_zhe_ge') }}

複製代碼

你會看到：

unknown

複製代碼

注意它不會報錯。官方的原話是「當實體不存在時回傳文字 unknown，不是 None 也不是錯誤」。所以實體 ID 打錯的症狀是「安靜地得到 unknown」，不是紅字。

2-2 一個好用的參數

{{ states('sensor.ke_ting_wen_du', rounded=True) }}

複製代碼

你會看到：數字會照實體自己的顯示精度四捨五入 —— 也就是跟你在介面上看到的一模一樣。拿來寫通知訊息時很好用，不會跑出 26.400000000000002 這種東西。

步驟 3：state_attr()，拿屬性

狀態只有一個，屬性可以有很多個。

先看有哪些屬性可以拿：切到狀態分頁，點一個燈的實體，右邊那一欄就是它全部的屬性。

回到範本分頁：

{{ state_attr('light.ke_ting_zhu_deng', 'brightness') }}

複製代碼

你會看到：

180

複製代碼

（燈是關的話會是 None，因為關著的燈沒有亮度這個屬性。）

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

登入繼續閱讀使用 Google 登入

		自動登入	找回密碼
密碼			立即註冊

範本（Template）入門：九個步驟，從編輯器一路做到會動的範本實體

延伸閱讀

瀏覽過的版塊