開發環境同基礎檔案結構
喺開始構建一個WordPress主題之前，建立一個高效、結構清晰嘅開發環境至關重要。呢樣嘢唔單止有助於程式碼組織，亦為後續嘅維護同擴展打下基礎。一個標準嘅WordPress主題係一個位於/wp-content/themes/目錄下嘅資料夾，其內部檔案遵循特定嘅命名同結構規範。
核心檔案與目錄
每個WordPress主題都必須至少包含兩個檔案：index.php同埋style.css。其中，style.css唔單止係樣式表，更加係一個主題嘅「身份證」，佢檔案頭部嘅註釋區塊用嚟向WordPress系統聲明主題資訊。一個典型嘅style.css檔案標頭係咁樣嘅：
/*
Theme Name: My Custom Theme
Theme URI: https://example.com/my-theme
Author: Your Name
Author URI: https://example.com
Description: 这是一个从头开始构建的自定义WordPress主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/除咗呢兩個必需檔案，一個功能完整、結構良好嘅主題通常包含以下目錄同檔案：
* functions.php：主題嘅功能檔案，用嚟加功能、註冊菜單、側邊欄等等。
* header.php: 網站嘅頭部範本。
* footer.php: 網站嘅底部模板。
* sidebar.php: 側邊欄範本。
* page.php: 頁面模板。
* single.php: 文章詳情頁模板。
* archive.php: 文章歸檔頁模板。
* 404.php：404錯誤頁面模板。
* search.php：搜尋結果頁面模板。
* assets/目錄: 用於存放靜態資源，通常包含css/、js/、images/等子目錄。
推薦閱讀 從零開始：手把手教你建立自訂WordPress佈景主題。
本地開發環境配置
推薦使用本地伺服器環境軟體（例如Local by Flywheel, XAMPP, MAMP）來搭建開發環境。咁樣可以喺自己部電腦度安裝WordPress、數據庫（例如MySQL）同PHP，進行離線開發同除錯，效率遠高過直接喺線上伺服器修改。同時，使用版本控制系統（例如Git）來管理你嘅主題程式碼係一個最佳實踐。
構建主題核心模板
WordPress主題開發嘅核心係模板層級系統。系統會根據用戶訪問嘅頁面類型，自動揀對應嘅模板檔案來渲染頁面。理解同正確構建呢啲模板檔案係主題開發嘅關鍵。
頁頭同頁尾範本
頭部模板header.php負責輸出每個頁面嘅開頭部分，通常包括HTML文檔聲明、<head>區域（包含標題、字符集、視口設置、引入嘅樣式同腳本）同網站嘅標誌同主導航菜單。喺header.php嘅末尾，通常會調用<body>標籤嘅開始部分同wp_body_open鉤子。
底部模板footer.php就負責輸出每個頁面嘅結尾部分，通常包括頁腳小工具區域、版權資訊、引入嘅JavaScript文件，同埋關閉<body>同埋<html>標籤。
喺其他模板檔案入面，透過get_header()同埋get_footer()函數嚟引入佢哋，確保網站結構嘅一致性。
推薦閱讀 WordPress主題開發指南：從零開始構建自訂主題嘅完整流程同最佳實踐。
主循環同內容展示
WordPress嘅「主循環」係主題嘅引擎，佢用嚟從資料庫度檢索同顯示文章。循環通常用if ( have_posts() ) : while ( have_posts() ) : the_post();結構。喺循環入面，你可以用一系列模板標籤嚟輸出文章內容，例如the_title()、the_content()、the_excerpt()、the_permalink()、the_post_thumbnail()等等
index.php作為最基礎嘅後備模板，應該包含一個完整嘅循環結構。而更具體嘅模板，例如single.php（用於單篇文章）同page.php（用於獨立頁面），就可以根據需要自訂循環內嘅展示方式。例如，single.php通常會顯示完整嘅文章內容同評論列表，而page.php就可能只係顯示內容，唔顯示發佈日期同作者資訊。
// 在 single.php 中一个典型的主循环示例
if ( have_posts() ) :
while ( have_posts() ) : the_post();
?>
<article id="post-<?php the_ID(); ?>" no numeric noise key 1004>
<header class="entry-header">
<h1 class="entry-title"><?php the_title(); ?></h1>
<div class="entry-meta">
| 作者:
</div>
</header>
<div class="entry-content">
<?php the_content(); ?>
</div>
</article>
<?php
// 显示评论区
if ( comments_open() || get_comments_number() ) :
comments_template();
endif;
endwhile;
endif;使用 functions.php 增強主題功能
functions.php檔案係你個主題嘅「控制中心」，所有唔屬於直接顯示樣式嘅功能代碼都應該加喺呢度。佢嘅作用就等於一個長開嘅插件。
註冊主題支援與菜單
透過add_theme_support()函數，你可以為你嘅主題聲明支援邊啲WordPress核心功能。例如，啟用文章特色圖像、自訂徽標、文章格式等係現代主題嘅標準配備。
function my_theme_setup() {
// 添加文章特色图像支持
add_theme_support( 'post-thumbnails' );
// 添加自定义徽标支持
add_theme_support( 'custom-logo' );
// 添加标题标签支持（由WordPress自动管理）
add_theme_support( 'title-tag' );
// 添加HTML5标记支持
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption', 'style', 'script' ) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );註冊導航菜單位置亦都係喺呢度完成嘅。使用register_nav_menus()函數定義菜單位置，然後你就可以喺header.php入面用wp_nav_menu()嚟調用佢。
加入樣式表同腳本
正確嘅做法係將樣式表同JavaScript檔案透過wp_enqueue_style()同埋wp_enqueue_script()函數嚟註冊同排隊。咁樣可以確保依賴關係正確處理，避免重複載入，而且同插件兼容。呢個操作應該喺wp_enqueue_scripts掛鉤上面進行。
推薦閱讀 從零開始：打造一個高性能、可自訂嘅WordPress主題完整指南。
function my_theme_scripts() {
// 引入主题的主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri(), array(), '1.0.0' );
// 引入自定义CSS文件
wp_enqueue_style( 'my-custom-css', get_template_directory_uri() . '/assets/css/custom.css', array(), '1.0.0' );
// 引入jQuery（WordPress已内置）和自定义JS
wp_enqueue_script( 'my-custom-js', get_template_directory_uri() . '/assets/js/main.js', array( 'jquery' ), '1.0.0', true ); // true表示在底部加载
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );創建自訂模板同頁面模板
WordPress 容許你為特定頁面或者文章創建獨特嘅版面，主要係透過自訂模板同頁面模板嚟實現。
自訂文章類型同分類法模板
如果你透過代碼或者插件註冊咗自訂文章類型（例如「產品」）或者自訂分類法（例如「產品類別」），WordPress嘅模板層級同樣適用。例如，你可以創建single-product.php嚟單獨控制「產品」類型嘅單頁顯示，創建archive-product.php嚟控制產品列表頁，創建taxonomy-product-category.php嚟控制特定產品分類嘅歸檔頁。呢個為構建複雜嘅內容型網站（例如作品集、網店）提供咗極大嘅靈活性。
條件標籤同自訂頁面模板
條件標籤（例如is_front_page()、is_page()、is_single()）可以令你喺一個模板檔案入面，根據唔同條件輸出唔同內容。但係更加強大嘅方法係創建自訂頁面模板。
你可以喺主題目錄下創建一個PHP檔案，並喺檔案頭部加入特定嘅註解區塊，將佢宣告成一個頁面模板。然後，喺WordPress後台為某個頁面揀呢個模板就得啦。
<?php
/**
* Template Name: 全宽页面模板
* Description: 一个没有侧边栏的全宽度页面模板
*/
get_header(); ?>
<div class="full-width-content">
<?php
while ( have_posts() ) : the_post();
the_content();
endwhile;
?>
</div>
<?php get_footer(); ?>另外，由WordPress 5.0開始，古騰堡區塊編輯器成為核心功能。你可以透過創建區塊模板（block-template-canvas.php）或者利用theme.json文件嚟全局定義主題嘅樣式、配色同區塊支援，實現更現代、視覺化嘅主題構建方式。
摘要
從零開始開發一個WordPress主題係一個系統性嘅工程，佢要求開發者唔單止要掌握PHP、HTML、CSS同JavaScript，更要深入理解WordPress嘅核心概念，例如模板層級、主循環、掛鉤同動作、模板標籤等等。從搭建規範嘅目錄結構開始，逐步構建頭部、底部同核心模板文件，利用functions.php嚟增強功能同正確加載資源，最後透過自定義模板同條件邏輯實現複雜嘅頁面佈局。跟住呢個流程，你就能夠打造出完全符合設計需求、性能優異且易於維護嘅自定義主題，從而喺WordPress嘅世界入面獲得最大嘅自由度同控制力。
常見問題
主題開發係咪一定要由零開始？
唔一定。對於初學者或者想快啲上手嘅開發者，由一個現有嘅基礎主題（例如Underscores, _s）或者父主題（例如Genesis, Astra）開始係一個絕佳選擇。佢哋已經建立好標準嘅文件結構同基礎代碼，你可以喺呢個基礎上進行修改同定制，咁樣比起完全由零開始會高效得多。
style.css 檔案可唔可以完全係空嘅？
唔可以。雖然樣式可以係空嘅，但檔案頂部嘅主題資訊註釋塊必須存在而且格式正確，否則WordPress就冇辦法識別你嘅主題。呢個註釋塊係主題喺WordPress後台列表中顯示嘅名稱、作者、描述等資訊嘅來源。
點樣可以令我嘅主題支援多語言（國際化）？
你需要用WordPress嘅國際化函數（例如__()、_e()）嚟包住所有需要翻譯嘅文字字串。然後喺style.css同埋functions.php入面正確設定Text Domain，同埋用Poedit呢啲工具整.pot模板文件同對應嘅.po同埋.mo翻譯檔案。呢個係專業主題必備嘅功能。
點解我嘅自訂模板喺後台頁面屬性度唔顯示？
請首先檢查你嘅自訂頁面模板檔案係咪喺主題嘅根目錄下面，同埋檔案頂部嘅註釋塊格式必須完全正確，特別係「Template Name:」呢一行。檔案名同路徑錯誤，或者註釋格式有問題，都會令到WordPress識別唔到呢個模板。
開發完成嘅主題點樣發布或者分享俾其他人用？
最規範嘅方式係將你嘅主題資料夾打包成ZIP檔案。用戶可以喺WordPress後台嘅「外觀」->「主題」->「新增主題」->「上傳主題」度直接上傳同安裝呢個ZIP包。如果你希望發布到WordPress官方主題目錄，就需要跟從更嚴格嘅代碼標準同審查流程，包括安全性、代碼質量、國際化支援等等。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。