開發環境同工具準備
喺開始寫程式之前，建立一個高效嘅本地開發環境好緊要。咁樣唔單止可以令你快速測試同除錯，仲可以避免喺線上伺服器直接操作所帶嚟嘅風險。推薦使用本地伺服器軟件套件，例如 Local by Flywheel、MAMP 或者 XAMPP，佢哋可以一鍵安裝 Apache、MySQL/MariaDB 同 PHP。
程式編輯器係開發者嘅主要工具。Visual Studio Code 而家係好流行嘅選擇，佢有豐富嘅擴展生態系統。對於主題開發，建議安裝以下擴展：WordPress 程式碼片段提示、PHP Intelephense（用嚟做 PHP 智能感知）、同埋實時預覽工具。另外，版本控制工具 Git 係管理程式碼變更、團隊協作同部署嘅必備技能，應該由一開始就學識用。
瀏覽器開發者工具係前端開發嘅利器。熟練使用 Chrome 或者 Firefox 嘅「檢查元素」功能嚟除錯 HTML、CSS 同 JavaScript，可以大大提升開發效率。最後，確保你嘅本地 PHP 版本同你嘅目標託管環境相匹配，同埋開啟 WordPress 嘅除錯模式，咁樣有助於喺開發初期發現同修復錯誤。
推薦閱讀 點樣製作一個專業嘅WordPress主題：由零開始嘅完整開發指南。
WordPress 主題基礎結構同核心檔案
一個標準嘅WordPress主題係一個包含特定檔案嘅資料夾，位於 /wp-content/themes/ 目錄下。最基本嘅主題只需要兩個檔案：style.css 同埋 index.php。
style.css 文件唔單止係主題嘅樣式表，更加係主題嘅「身份證」。佢文件頂部嘅註釋區塊用嚟宣告主題資訊，呢個係WordPress識別主題嘅關鍵。一個典型嘅宣告如下：
/*
Theme Name: 我的第一个主题
Theme URI: https://example.com/my-first-theme/
Author: 你的名字
Author URI: https://example.com/
Description: 这是一个用于学习的简单 WordPress 主题。
Version: 1.0
License: GPL v2 or later
Text Domain: my-first-theme
*/index.php 係主題嘅預設模板文件，負責渲染網站頁面。佢係所有其他模板文件嘅「後備」文件。如果WordPress搵唔到更具體嘅模板文件（例如 single.php），就會用返 index.php。
除咗呢兩個核心文件，一個功能完整嘅主題通常仲包括：
* header.php： 網站嘅頁頭部分，通常包含 <head> 區域同網站標識。
* footer.php： 網站嘅頁腳部分。
* functions.php： 主題嘅「功能增強」檔案，用嚟添加功能、註冊選單、側邊欄等等。
* page.php：用於渲染單個頁面嘅模板。
* single.php：用於渲染單篇博客文章嘅模板。
* archive.php：用於渲染文章分類、標籤等存檔頁面嘅模板。
理解模板層級嘅重要性
WordPress 用一套叫「模板層級」嘅規則，去決定特定頁面要用邊個模板檔案。呢套規則係主題開發嘅核心邏輯。例如，當用戶睇一篇網誌文章嗰陣，WordPress 會順序搵：single-post-{post-type}-{slug}.php -> single-post-{post-type}.php -> single.php -> singular.php -> 最後係 index.php。理解同善用模板層級，就可以幫你為網站唔同部分整出高度客製化嘅版面。
推薦閱讀 完美WordPress主題開發指南：由零開始打造專業網站。
核心開發技術：PHP、模板標籤與循環
WordPress 主題本質上係 PHP 應用程式，佢透過一系列內置嘅 PHP 函數（叫做「模板標籤」）同 WordPress 核心進行互動。呢啲函數負責由資料庫度提取內容，然後動態插入到你嘅 HTML 結構入面。
最核心嘅概念係「WordPress 循環」。循環係一段 PHP 代碼，用嚟檢查當前頁面有冇文章（或者頁面）需要顯示，如果有文章嘅話，就會循環遍歷每一篇並輸出佢嘅內容。一個最基本嘅循環結構如下：
<h2><?php the_title(); ?></h2>
<div class="entry-content">
<?php the_content(); ?>
</div>喺上面嘅代碼入面，have_posts() 同埋 the_post() 係控制循環流程嘅函數。the_title() 同埋 the_content() 就係輸出具體內容嘅模板標籤。其他常用嘅模板標籤包括 the_permalink()（輸出文章連結）、the_post_thumbnail()（輸出特色圖像）同埋 the_excerpt()（輸出文章摘要）。
利用條件標籤實現邏輯控制
條件標籤係另一類好勁嘅PHP函數，佢哋會根據當前頁面類型返true或者false，令你可以做到精準嘅版面控制。例如：
<?php if ( is_front_page() && is_home() ) {
// 默认首页（显示最新文章列表）
} elseif ( is_front_page() ) {
// 静态首页
} elseif ( is_home() ) {
// 博客文章索引页
} elseif ( is_single() ) {
// 单篇文章页
} elseif ( is_page() ) {
// 单个页面
} elseif ( is_category() ) {
// 分类存档页
}
?>透過組合使用模板標籤、循環同條件標籤，你就可以砌出動態、內容驅動嘅任何頁面。
主題功能增強與最佳實踐
functions.php 文件係你主題嘅「工具箱」。佢唔係直接輸出內容用嘅，而係用嚟擴展主題功能、加特性同埋同其他 WordPress 組件整合。
推薦閱讀 由零開始:逐步指南教你打造專業 WordPress 子主題。
註冊主題支援嘅功能同菜單
在 functions.php 入面，你應該用 add_theme_support() 函數嚟聲明你嘅主題支援邊啲 WordPress 核心功能。例如，支援文章特色圖同自訂 logo：
function my_theme_setup() {
add_theme_support( 'post-thumbnails' );
add_theme_support( 'custom-logo' );
add_theme_support( 'title-tag' ); // 让 WordPress 管理页面标题
}
add_action( 'after_setup_theme', 'my_theme_setup' );註冊導航菜單位置都係喺呢度完成嘅：
function my_theme_menus() {
register_nav_menus(
array(
'primary' => __( '主菜单', 'my-first-theme' ),
'footer' => __( '页脚菜单', 'my-first-theme' ),
)
);
}
add_action( 'after_setup_theme', 'my_theme_menus' );正確引入腳本同樣式表
千祈唔好直接喺模板檔案度硬連結 CSS 或者 JavaScript 檔案。正確嘅方法係用 wp_enqueue_scripts 鉤子。
function my_theme_scripts() {
// 引入主题的主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri() );
// 引入自定义 JavaScript 文件
wp_enqueue_script( 'my-theme-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '1.0', true );
// 如果需要，引入 jQuery（WordPress 默认已注册）
// wp_enqueue_script( 'jquery' );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );呢種方法確保依賴關係被正確處理，避免重複載入，而且同 WordPress 嘅插件系統兼容。
實現動態側邊欄（小工具區域）
小工具係 WordPress 一個非常靈活嘅功能。要為你嘅主題創建小工具區域（側邊欄），需要喺 functions.php 中註冊：
function my_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_theme_widgets_init' );然後，喺你希望側邊欄出現嘅位置（例如 sidebar.php），用 dynamic_sidebar( 'sidebar-1' ) 嚟調用佢。
摘要
WordPress 主題開發係一門結合咗結構理解、PHP 編程同前端技術嘅綜合性技能。由建立正確嘅開發環境開始，逐步掌握主題嘅基礎檔案結構、核心嘅模板層級概念，再到熟練運用 WordPress 循環、模板標籤同條件標籤動態輸出內容，係構建自訂主題嘅必經之路。最後，透過 functions.php 檔案遵循最佳實踐嚟增強主題功能，例如正確註冊特性、選單、小工具同引入資源，能夠確保你嘅主題代碼穩健、高效且易於維護。記住，核心思想始終係分離內容（數據庫）同表現（主題模板），從而創建出靈活、強大嘅網站。
常見問題
### 開發一個 WordPress 主題需要學 PHP 嗎
係呀，呢個係必須㗎。WordPress 本身係用 PHP 編寫嘅，主題模板檔案本質上就係 PHP 檔案，佢哋透過 PHP 程式碼從 WordPress 資料庫度提取動態內容。雖然你可以複製貼上啲程式碼片段，但係要進行真正嘅自訂、除錯同解決問題，對 PHP 有基本嘅理解係不可或缺㗎。
自己嘅主題可以直接用喺商業項目度嗎
絕對可以。你為自己或者客戶開發嘅主題，其版權歸屬於你（或者你嘅客戶）。但係要注意嘅係，因為你用咗 WordPress 平台，而 WordPress 核心程式碼遵循 GPL 許可證，所以最好都係揀返兼容 GPL 嘅許可證（例如 GPL v2 或者更高版本）嚟授權你嘅主題。呢個被視為對 WordPress 社群精神嘅一種尊重，而且完全唔影響你出售或者授權你嘅主題㗎。
點樣令開發嘅主題適應流動裝置
實現響應式設計係現代主題開發嘅基本要求。呢樣主要依賴於 CSS 媒體查詢技術。你需要喺 style.css 度編寫針對唔同屏幕尺寸（例如手機、平板、桌面）嘅 CSS 規則。最佳實踐係採用「移動優先」嘅策略，即係先編寫適用於細屏幕嘅基本樣式，然後用媒體查詢逐步為大屏幕添加或覆蓋樣式。同時，確保喺 <head> 區域（通常喺 header.php）正確設定咗 viewport meta 標籤：<meta name=“viewport” content=“width=device-width, initial-scale=1”>。
主題開發中點樣使用子主題功能
子主題係一個非常強大嘅功能，佢容許你基於一個現有主題（父主題）進行修改同擴展，而唔使直接修改父主題嘅檔案。當父主題更新時，你嘅自訂代碼（喺子主題入面）會安全保留。創建一個子主題好簡單：只需要喺 /wp-content/themes/ 目錄下新建一個資料夾，並喺其中創建一個 style.css 檔案，其頭部註釋中必須使用 Template: parent-theme-folder-name 嚟聲明父主題。然後，你就可以喺子主題入面覆蓋父主題嘅任何模板檔案或者添加新嘅功能。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。