開發環境同基礎準備
喺開始寫程式碼之前，一個穩定、高效嘅開發環境係成功嘅第一步。呢個唔單止係安裝一個文字編輯器，更加係為成個開發流程打好基礎。
首先，你需要一個本地伺服器環境。推薦使用整合咗 Apache、MySQL 同 PHP 嘅軟件包，例如 XAMPP、MAMP 或者 Laragon。佢哋可以令你喺個人電腦上模擬出同線上伺服器幾乎一樣嘅環境，方便進行除錯同測試。確保你嘅 PHP 版本唔低過 7.4，MySQL 版本唔低過 5.6，咁樣先至兼容到最新嘅 WordPress 功能。
其次，程式碼編輯器或者集成開發環境（IDE）嘅選擇好重要。Visual Studio Code 因為佢豐富嘅外掛生態（例如 PHP Intelephense、WordPress Snippet）而好受開發者歡迎。PHPStorm 就係功能更加強大嘅專業選擇，提供咗對 WordPress 鉤子同函數嘅深度程式碼提示。
推薦閱讀 從零開始：打造一個搜尋引擎友好嘅專業WordPress主題。
一個 WordPress 主題最基礎嘅檔案結構由兩個檔案開始：style.css 同埋 index.php。喺主題根目錄下開個新資料夾，例如「my-first-theme」。喺呢個資料夾入面，整返 style.css 檔案，同埋喺檔案開頭加返主題資訊註解。呢啲註解係 WordPress 辨認一個主題嘅關鍵。
/*
Theme Name: My First Theme
Theme URI: https://example.com/my-first-theme/
Author: Your Name
Author URI: https://example.com/
Description: 这是一个用于学习 WordPress 主题开发的入门主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-first-theme
*/同時，建立一個最基本嘅 index.php 檔案，暫時淨係需要包含一個 HTML 骨架同一句簡單嘅輸出。
<!DOCTYPE html>
<html no numeric noise key 1004>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<title><?php bloginfo( 'name' ); ?></title>
<?php wp_head(); ?>
</head>
<body>
<h1>你好呀，WordPress主題開發！有咩可以幫到你？想問主題製作、功能修改，定係有代碼上嘅疑問呢？</h1>
<?php wp_footer(); ?>
</body>
</html>將成個主題資料夾複製到 WordPress 安裝目錄下嘅 wp-content/themes/ 中，然後進入 WordPress 後台嘅「外觀」->「主題」頁面，你就可以睇到同啟動你第一個主題啦。
核心模板檔案同模板層級
WordPress 用一套叫「模板層級」嘅規則，嚟決定網站唔同頁面應該用邊個模板檔案嚟渲染。理解呢個機制係主題開發嘅核心。
理解模板層級機制
模板層級係一個由最具體到最通用嘅檔案查找系統。當用戶訪問一個頁面時，WordPress 會根據頁面嘅類型（例如文章單頁、文章歸檔頁、靜態頁面）同條件（例如分類、標籤、作者），按照預設嘅優先級去搵對應嘅模板檔案。如果搵到最具體嘅檔案，就用佢；如果搵唔到，就繼續搵下一級更通用嘅檔案，直到最基礎嘅 index.php。例如，訪問一篇特定分類下嘅文章時，WordPress 會依次搵：single-post-{slug}.php -> single-{post-type}.php -> single.php -> singular.php -> index.php。
推薦閱讀 WordPress主題開發完整指南：從入門到精通嘅全流程實戰。
創建主要頁面範本
根據範本層級，我哋需要創建幾個最常用嘅核心範本檔案。首先係 header.php 同埋 footer.php，佢哋用嚟存放網站嘅公共頭部同底部。喺 index.php 喺度，我哋可以用 get_header() 同埋 get_footer() 函數嚟引入佢哋。
index.php 係最終嘅備用範本，所有其他範本搵唔到時都會返到呢度。佢通常包含一個主循環，用嚟輸出文章列表。
single.php 用嚟顯示單篇文章。佢嘅核心係用 WordPress 主循環嚟輸出文章嘅完整內容。
page.php 用嚟顯示靜態頁面。佢同 single.php 結構相似，但通常唔包含分類、標籤等元信息。
archive.php 用嚟顯示各類歸檔頁面，例如分類目錄、標籤頁、作者文章列表等等。喺呢個模板入面，你需要用循環嚟輸出多篇文章嘅摘要或者標題列表。
front-page.php 同埋 home.php 容易搞亂。當後台「設定」->「閱讀」入面指定咗一個靜態首頁時，front-page.php 用嚟顯示你指定嗰個靜態頁面，而 home.php 就用嚟顯示文章列表頁（網誌頁面）。如果冇設定靜態首頁，home.php 就會做網站首頁。
推薦閱讀 快速掌握 WordPress 主題開發：從入門到實戰嘅完整指南。
主題功能與動態內容
一個優秀嘅主題唔單止係靜態模板嘅堆砌，更加需要透過 WordPress 提供嘅豐富函數同掛鈎來引入動態內容同功能。
註冊選單同側邊欄
為咗等用戶可以喺後台控制導航菜單，你需要喺主題嘅 functions.php 檔案入面用 register_nav_menus() 函數來註冊菜單位置。例如，註冊一個「主導航」位置。
function my_first_theme_setup() {
register_nav_menus( array(
'primary' => __( 'Primary Menu', 'my-first-theme' ),
) );
}
add_action( 'after_setup_theme', 'my_first_theme_setup' );註冊之後，用戶就可以喺「外觀」->「選單」度分配選單到「主導航」位置。喺模板檔案（例如 header.php）入面，使用 wp_nav_menu() 函數嚟調用呢個菜單。
側邊欄（或者叫「小工具區域」）同樣需要喺 functions.php 度註冊。用 register_sidebar() 函數可以定義一個側邊欄區域。
function my_first_theme_widgets_init() {
register_sidebar( array(
'name' => __( 'Main Sidebar', 'my-first-theme' ),
'id' => 'sidebar-1',
'description' => __( 'Add widgets here.', 'my-first-theme' ),
'before_widget' => '<section id="%1$s" class="widget %2$s">',
'after_widget' => '</section>',
'before_title' => '<h2 class="widget-title">',
'after_title' => '</h2>',
) );
}
add_action( 'widgets_init', 'my_first_theme_widgets_init' );喺模板入面（例如 sidebar.php），用 dynamic_sidebar( ‘sidebar-1’ ) 嚟輸出呢個區域。
引入樣式同腳本
正確噉將 CSS 同 JavaScript 檔案加入隊列係 WordPress 主題開發嘅最佳實踐，咁樣可以避免資源衝突同依賴問題。喺 functions.php 入面，用 wp_enqueue_style() 同埋 wp_enqueue_script() 函數，並且掛載到 wp_enqueue_scripts 呢個鉤子上。
function my_first_theme_scripts() {
// 引入主题主样式表
wp_enqueue_style( 'my-first-theme-style', get_stylesheet_uri() );
// 引入自定义 JavaScript 文件
wp_enqueue_script( 'my-first-theme-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '1.0.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_first_theme_scripts' );文章特色圖像同縮圖
為咗令主題支援文章縮圖（特色圖像），你需要喺 functions.php 嘅主題支援函數入面加入 add_theme_support( ‘post-thumbnails’ )。你仲可以用 set_post_thumbnail_size() 嚟設定預設嘅縮略圖尺寸。喺模板文件入面，使用 the_post_thumbnail() 函數嚟輸出特色圖像。
進階功能同主題定製
當基礎功能完備之後，你可以透過更高級嘅技術嚟提升主題嘅可定製性同穩健性。
實現主題定制器支援
WordPress 定製器允許用戶即時預覽同修改主題設定。你可以透過 wp_customize API 為主題添加各種設定選項，例如修改 Logo、顏色、頁尾文字等。呢個涉及喺 functions.php 入面加一個自訂函數，並掛載到 customize_register 鉤子上，喺入面用 $wp_customize->add_setting() 同埋 $wp_customize->add_control() 方法。
創建子主題進行修改
直接修改父主題（尤其係第三方主題）係唔建議嘅，因為更新會覆蓋你嘅修改。正確嘅方法係創建一個子主題。子主題只需要一個 style.css 檔案，並喺檔案頭部嘅註釋中透過 Template: 欄位聲明其父主題嘅目錄名。子主題會繼承父主題嘅所有功能，你只需喺子主題中創建同名檔案即可覆蓋父主題嘅模板檔案，或者喺子主題嘅 functions.php 中加入新嘅函數嚟擴展功能。呢個係 WordPress 主題開發中維護同升級嘅黃金法則。
確保主題國際化
為咗你嘅主題可以俾全世界嘅用戶使用，需要進行國際化（i18n）準備。呢個意思係話所有喺主題中輸出俾用戶睇嘅字串，都應該用 WordPress 嘅翻譯函數包裝，最常用嘅係 __() 同埋 _e()。同時，喺 style.css 同埋 functions.php 入面正確設定 Text Domain。跟住，你可以用 Poedit 呢類工具生成 .pot 模板文件，翻譯人員可以根據呢個創建唔同語言嘅 .po 同埋 .mo 檔案。
摘要
WordPress 主題開發係一個系統性嘅工程，由搭建本地環境、理解模板層級，到註冊核心功能、引入動態內容，再到實現定制化同國際化，每一步都環環相扣。跟住「由最具體到最通用」嘅模板層級規則，可以令你高效噉組織模板檔案。堅持用 WordPress 標準函數同掛鉤（例如 wp_enqueue_scripts、register_nav_menus)嚟添加功能，係保證主題兼容性同可維護性嘅關鍵。最後，透過支持定制器同創建子主題，你嘅作品將唔只係一個功能性嘅主題，更加係一個易用同長期維護嘅專業產品。掌握晒呢啲全流程，你就具備咗由零開始構建一個完整、穩健嘅 WordPress 主題嘅能力。
常見問題
主題開發係咪一定要識 PHP 先得？
係呀，PHP 係 WordPress 嘅核心編程語言，主題嘅模板檔案、功能函數都係基於 PHP。你需要掌握 PHP 嘅基礎語法，包括變數、陣列、條件判斷、循環同函數。對於更複雜嘅主題，面向對象編程（OOP）知識都會好有幫助。
點樣調試開發過程中出現嘅錯誤？
首先，確保喺本地開發環境嘅 wp-config.php 喺文件度開啟 WordPress 調試模式，將 WP_DEBUG 常數設定為 true。咁樣會將所有 PHP 錯誤、警告同通知顯示喺頁面上。其次，使用瀏覽器嘅開發者工具（按 F12）嚟檢查 CSS 同 JavaScript 錯誤。對於複雜嘅邏輯問題，可以使用 error_log() 函數將變量信息打印到伺服器嘅錯誤日誌中進行分析。
我嘅主題點樣提交到 WordPress 官方目錄？
提交主題到官方目錄需要滿足一系列嚴格嘅規範。你需要仔細閱讀官方嘅《主題審查手冊》，確保代碼質量、安全性、可訪問性同兼容性都達到標準。主題必須使用 GPL 兼容許可證，並且唔可以捆綁任何非 GPL 兼容嘅代碼或資源。提交過程通過 WordPress 官方嘅提交系統進行，之後會有志願者審查員對你嘅主題進行審核。
開發商業主題需要注意啲咩？
開發商業主題除咗要滿足所有技術規範外，仲需要特別注意版權同許可問題。你使用嘅所有資源（例如圖片、字體、第三方庫）都必須擁有合法嘅商業使用授權。代碼質量要求更高，需要提供良好嘅文檔同技術支援。同時，考慮使用加密或混淆工具來保護你嘅知識產權，並揀一個可靠嘅平台（例如 ThemeForest）進行銷售同分發。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。