請 AI 開發 Block Theme 不只是為了追求最新的技術，而是它的基礎架構對於 AI 來說相對友善，我是實際用 Claude Code 開發過兩種主題之後才體認到這個差距，開發傳統佈景主題時 AI 很容易一股腦的把所有東西往 functions.php 與 style.css 塞，然後每個頁面該長一樣的地方卻不一樣，Block Theme 則是很好的維持 UI 元件的一致性。
語言模型改程式碼時最容易漏掉三件事：隱藏的狀態、跨檔案的依賴、與沒有明確邊界的覆蓋規則，這三件事在傳統佈景主題很容易讓 AI 踩到雷。
改一個按鈕顏色，AI 得先搞懂這顏色是 style.css 定義的、還是被某個 @media 覆蓋、還是某支外掛用 !important 蓋掉的。它得讀懂整條 CSS cascade，還要讀 functions.php 裡有沒有 wp_enqueue_style 動態改了載入順序，改完之後 AI 自己也沒把握會不會波及其他頁面，因為 CSS 的影響範圍，本質上是全站通吃的。
這種「牽一髮動全身、而且看不出髮根在哪」的結構，是 AI 出錯的高風險區，它會給你一個看起來很合理、實際上有很大機率會把東西弄壞卻沒人知道。
Block Theme 把同樣的任務變成 AI 最容易理解的架構。改顏色？改 theme.json 裡 settings.color.palette 那一個值，範圍明確無副作用。做一個新區塊？那是一個架構獨立存在的資料夾，有 block.json 宣告介面、有獨立的 render.php 或 save.js，邊界清清楚楚。組一個頁面？那是一串結構化的區塊標記，AI 讀得懂每個 wp: 註解代表什麼。
關鍵差別在這裡：Block Theme 用宣告式、結構化、有明確邊界的設定，取代了傳統主題那種命令式、全域、靠覆蓋順序運作的樣式邏輯，前者正好是 JSON、是 schema、是可預測的局部修改，對於語言模型非常友善。
還有一個容易被忽略的點：Block Theme 的產出好驗證。
傳統主題改完 CSS，你得在瀏覽器裡一頁一頁點過去，確認沒有別的地方被弄壞，因為你無法從程式碼靜態判斷影響範圍。Block Theme 改完 block.json 或 theme.json，改動範圍寫在結構裡，你（或 AI）可以在不開瀏覽器的情況下，就大致推斷這次改動的邊界，這讓 AI 的「自我檢查」變得可行，也讓 code review 快很多。
對 AI 協作來說，好驗證跟好生成一樣重要，一個 AI 能自己確認對錯的任務，比一個要人類逐頁檢查的任務可靠度高太多了。
但吹了這麼多 Block Theme 的優點，它的硬傷是在學習曲線比傳統主題陡，你得先理解區塊標記、theme.json schema、FSE 那套檔案與資料庫的雙軌機制。對只想「快速改個 CSS」的小需求，傳統主題有時候反而更直接。
但如果你的工作型態是「大量、重複、要跟 AI 協作地開發主題與區塊」，那 Block Theme 的結構化優勢會隨規模放大，這也是為什麼接下來整個第三部，我選擇用 Block Theme 一步步實作，下一篇我們往 Block 的內部走，先從最小的單位開始：一個 RichText、一個區塊，到底是怎麼組成的，並說明跟傳統編輯器差在哪。
文章目錄：https://oberonlai.blog/category/2026-ithome/
Hi, 我是 Oberon Lai，十多年前我從一個不懂程式的平面設計師，一頭栽進 WordPress 的世界。從佈景主題到外掛開發，從接案到自研產品，這段旅程讓我深刻理解：好的技術不只是寫出能跑的程式碼，而是真正解決人的問題。
我積極投入參與社群，公開演講紀錄如下：
我專精 WordPress 開發，從企業形象網站的設計與開發、佈景主題客製化，到既有網站的改版升級，提供完整的 WordPress 建置服務。開發面涵蓋外掛開發與維護、區塊編輯器（Gutenberg）客製區塊、ACF 與 Custom Post Type 的資料架構設計，以及 REST API 整合與 Multisite 多站架構建置。同時也協助網站效能改善與 SEO 調校、安全性檢測與強化，並導入自動化部署與版本控制流程，搭配長期的技術顧問與維運支援，讓網站上線後也能穩定運作。
亦提供 WooCommerce 商店的建置與設定，並串接綠界、LINE Pay、藍新等台灣主流金流。可依需求進行結帳頁面客製化、訂單狀態自動化流程設計，以及商品管理與庫存系統的客製開發；也支援 WooCommerce Subscription 定期定額、REST API 應用開發、報表與數據匯出等進階需求。此外，透過購物流程 UX 改善、電商網站效能調校與 HPOS 高效能訂單儲存相容開發，全面提升營運效率，並提供電商營運技術顧問服務。
AI 浪潮席捲而來，我選擇擁抱而非恐懼，我把 AI 融入開發工作流以及客戶的產品中，也持續累積「AI 看不見的部分」：真實踩坑經驗、最新漏洞情報那些只有第一線工程師才看得見的細節，如果你有任何 WordPress 的客製化需求或是 AI 開發相關的問題非常歡迎加入 LINE 官方帳號與我聯繫：
https://page.line.me/vrf7844t?oat_content=url&openQrModal=true
如果想要獲取 AI 開發實戰經驗也能訂閱我的電子報，每週五上午準時出刊：
https://oberonlai.blog/wordpress-newsletter/
iThome鐵人賽
看影片追技術