搭建 WordPress 主题开发环境
在開始編寫程式碼之前，一個穩定、高效的本地開發環境至關重要。傳統的線上除錯方式效率低下，且容易對生產環境造成影響。因此，我們強烈建議使用本地伺服器環境進行開發。
你可以選擇安裝XAMPP、MAMP或Local by Flywheel等整合環境軟體，它們能一鍵安裝Apache/Nginx、MySQL和PHP。對於更偏向自定義的開發者，直接安裝PHP、MySQL和配置Web伺服器也是可行的。無論哪種方式，請確保你的PHP版本不低於7.4，MySQL版本不低於5.6，以相容WordPress的最新要求。
一個核心的準備工作是下載最新的WordPress核心檔案。將其解壓到本地伺服器的網站根目錄（如htdocs或www資料夾下）。隨後，在你的主題開發目錄（通常是wp-content/themes/）下建立一個新的資料夾，以你的主題英文名稱命名，例如my-awesome-theme。這個資料夾將成為你所有主題檔案的“家”。
推荐阅读 從零開始：手把手教你開發一個自定義的WordPress主題。
這個資料夾中，有兩個檔案是啟動一個主題所必需的。第一個是樣式表文件style.css，它不僅僅包含CSS樣式，其檔案頭部註釋塊更承載著向WordPress宣告主題資訊的重任。第二個是核心模板檔案index.php，它是主題的預設入口檔案。即使內容為空，這兩個檔案的存在也標誌著一個有效WordPress主題的誕生。
主題核心檔案與模板體系
WordPress採用模板層級體系來決定如何顯示不同的內容。理解這一體系是開發主題的關鍵。其工作原理是：當用戶訪問一個頁面時，WordPress會基於當前請求的型別（如首頁、文章單頁、分類歸檔頁等），按照一個特定的優先順序順序去尋找對應的模板檔案。
最基本的檔案是index.php，它是所有頁面的最終回退模板。為了更精細地控制不同頁面的展示，你需要建立更具體的模板檔案。例如，用於顯示部落格文章列表的home.php或者front-page.php，用於顯示單篇文章的single.php，用於顯示頁面的page.php，以及用於顯示分類目錄下文章列表的category.php等等。
模板檔案的呼叫與組合
為了提高程式碼複用性和可維護性，WordPress主題通常會將公共部分拆分到獨立的模板檔案中，然後透過特定的函式包含進來。最常用的函式是get_header()， get_footer() 以及 get_sidebar()。
這些函式會分別呼叫主題目錄下的header.php， footer.php 以及 sidebar.php檔案。例如，在你的index.php中，典型的結構如下：
推荐阅读 WordPress外掛開發從入門到精通：構建自定義功能的完整指南。
<?php get_header(); ?>
<main id="primary">
<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
// 显示每篇文章的内容
endwhile;
else :
// 显示“未找到文章”的信息
endif;
?>
</main>
<?php get_sidebar(); ?>
<?php get_footer(); ?>這種結構確保了網站頭部、頁尾和側邊欄的一致性。另一個至關重要的函式是get_template_part()，它用於載入其他可複用的模板片段。例如，在文章迴圈中，常用get_template_part( 'template-parts/content', get_post_format() );來載入位於template-parts資料夾下的content.php或其變體（如content-video.php）。
功能與樣式的實現
一個完整的主題不僅需要模板檔案，還需要一個功能檔案來擴充套件能力，以及樣式表來定義外觀。
主题功能的整合
functions.php檔案是你的主題的“大腦”，用於新增功能、註冊特性、並修改WordPress的預設行為。它雖然不是必須的，但幾乎所有專業主題都會用到。開發者在這裡透過WordPress提供的鉤子（Hooks）系統來介入程式碼執行流程。
一個基礎且重要的操作是使用add_theme_support()函式來宣告主題對某些功能的支援。例如，啟用文章縮圖（特色影象）功能是現代主題的標配：
function mytheme_setup() {
add_theme_support( 'post-thumbnails' );
add_theme_support( 'title-tag' ); // 让WordPress管理页面标题
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption' ) );
}
add_action( 'after_setup_theme', 'mytheme_setup' );另一個關鍵任務是註冊導航選單和側邊欄（小工具區域）。你可以使用register_nav_menus()定義選單位置，使用register_sidebar()定義小工具區域。之後，這些區域就可以在WordPress後臺的“外觀”選單中進行配置，並在模板檔案中使用wp_nav_menu()以及dynamic_sidebar()函数调用。
樣式與指令碼的引入
將所有CSS和JavaScript程式碼正確地加入佇列是WordPress的最佳實踐，這能確保依賴關係正確，並避免衝突。永遠不要直接在模板檔案中硬連結樣式或指令碼。
推荐阅读 如何從零開始開發一個功能強大的WordPress主題。
你應該在functions.php在中文中，我们可以用“使用”来表达“use”的意思。比如：“我使用了这个工具。”或者“他使用了那个方法。”wp_enqueue_style()以及wp_enqueue_script()函式來新增資源。主樣式表style.css通常這樣載入：
function mytheme_scripts() {
wp_enqueue_style( 'mytheme-style', get_stylesheet_uri() );
wp_enqueue_script( 'mytheme-navigation', get_template_directory_uri() . '/js/navigation.js', array(), null, true );
}
add_action( 'wp_enqueue_scripts', 'mytheme_scripts' );主題的測試與釋出流程
開發完成後，你不能直接將其部署到生產伺服器。嚴格的測試是確保主題質量、安全性和相容性的最後一道防線。
首先，你需要在不同環境（本地、暫存）中測試主題的所有功能。這包括：測試所有頁面模板的顯示是否正確；檢查導航選單、小工具、文章列表、評論表單等核心功能是否正常工作；確保在啟用/禁用各類外掛的情況下，主題依然穩定；測試主題的響應式設計，確保其在手機、平板和桌面裝置上都能良好顯示。
其次，你需要遵循WordPress官方的《主題審查標準》進行自查。這套標準涵蓋了程式碼質量、安全性、功能實現、樣式、國際化等諸多方面。例如，所有文字輸出都必須使用WordPress的翻譯函式進行包裹，如esc_html_e()或者__()，以實現國際化；所有需要轉義的資料（如來自使用者或資料庫的內容）都必須進行正確的轉義，以防止XSS攻擊；主題中不應包含任何硬編碼的連結或過於主觀的樣式。
最後，在釋出前，建議你在一個全新的、乾淨的WordPress安裝上，使用預設資料（如“二十一”主題自帶的示例內容）進行測試。這能模擬使用者首次安裝時的真實環境。確認無誤後，你可以將主題資料夾壓縮為ZIP檔案，透過WordPress後臺的“外觀”->“主題”->“新增”->“上傳主題”進行安裝和啟用，或者將其提交到WordPress官方主題目錄以供全球使用者下載。
总结
WordPress主題開發是一個系統性的工程，它始於環境的搭建，核心在於理解模板層級與檔案結構，成型於functions.php功能的新增與樣式的定義，最終完成於嚴謹的測試。遵循“從通用到具體”的模板層級規則，採用模組化的模板部件組織程式碼，並堅持透過WordPress標準函式和鉤子來新增功能與資源，是構建一個專業、高效、安全且易維護的主題的關鍵。記住，優秀的主題不僅是視覺的呈現，更是程式碼質量的體現和對WordPress生態規範的尊重。
常见问题解答（FAQ）
开发WordPress主题必须掌握PHP吗？
是的，PHP是開發完整WordPress主題的必備技能。雖然你可以透過子主題或頁面構建器修改外觀，但建立自定義模板檔案、新增主題功能、處理動態資料等核心開發工作都離不開PHP。HTML、CSS和JavaScript也是前端展示所必需的基礎技術。
什麼是主題的子主題，何時需要使用它？
子主題是一個繼承自另一個主題（稱為父主題）所有功能與樣式的獨立主題。它允許你修改和擴充套件父主題，而無需直接改動父主題的程式碼。當你想對現有流行主題（如Astra、GeneratePress）進行深度定製，同時又希望在未來能安全更新父主題時，就必須使用子主題開發方式。
我的主題如何支援古騰堡編輯器？
支援古騰堡編輯器主要涉及兩個方面。一是為編輯器載入樣式，使編輯介面與前端顯示風格一致，可以透過add_theme_support( 'editor-styles' )以及add_editor_style()實現。二是新增對編輯器特色功能的支援，如寬對齊、顏色調色盤、字型大小等，可以使用add_theme_support()函式來宣告這些支援，併為某些區塊（如封面塊、組塊）定義主題相關的樣式和寬度。
主題開發中如何確保安全性？
確保安全性需要貫穿整個開發過程。首要原則是“永遠不要信任使用者輸入”。對所有從使用者端（如評論、表單）或資料庫獲取並輸出到頁面的資料，都必須使用WordPress提供的轉義函式進行淨化，如esc_html(), esc_attr(), wp_kses_post()等。其次，在直接查詢資料庫時，應使用$wpdb類及其prepare方法，以防止SQL注入。最後，應避免使用eval()等危險函式，並定期更新程式碼以遵循最新的安全最佳實踐。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。