開發環境同基礎檔案準備
喺開始寫任何程式碼之前，搭建一個高效嘅本地開發環境至關重要。推薦使用 Local by Flywheel、XAMPP 或者 MAMP 等工具快速搭建包含 PHP、MySQL 同 Apache/Nginx 嘅本地伺服器。喺呢個環境度裝好 WordPress 之後，你就可以開始創建屬於你自己嘅主題。
一個 WordPress 主題本質上係一個喺 /wp-content/themes/ 目錄下嘅資料夾。呢個資料夾嘅名就係你嘅主題識別符。喺呢個主題資料夾入面，最基礎亦都必須存在嘅兩個檔案係 style.css 同埋 index.php。
style.css 檔案唔單止用嚟存放 CSS 樣式，佢檔案頭部嘅註解更加承擔住向 WordPress 聲明主題資訊嘅重任。以下係一個標準示例：
推薦閱讀 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 就會用佢嚟渲染頁面。你可以先喺入面擺啲簡單嘅 HTML 結構嚟測試主題係咪已經俾 WordPress 識別到。
核心模板文件嘅結構同層次
WordPress 採用一套精確嘅模板層級系統，用嚟決定唔同類型嘅頁面要用邊個模板文件。理解呢個層次結構係高效開發嘅關鍵。
首頁模板嘅優先次序
對於網站首頁，WordPress 會跟順序搵以下文件：front-page.php > home.php > index.php。通常，front-page.php 用嚟展示一個自訂嘅靜態首頁，而 home.php 就用嚟顯示網誌文章列表。
文章同頁面範本
當訪問一篇單獨嘅文章時，WordPress 會優先揾 single-post.php，如果唔存在就會回退到 single.php… 最後 index.php。對於獨立頁面，就會搵 page-{slug}.php 或 page-{id}.php，跟住係 page.php。
歸檔與分類模板
文章分類目錄頁會用 category-{slug}.php、category-{id}.php、archive.php… 最後 index.php。標籤頁、作者頁、日期歸檔頁等等都有類似嘅層級規則。
推薦閱讀 從零開始掌握 WordPress 主題開發：構建自訂網站嘅最佳實踐同指南。
掌握呢套規則之後，你可以透過建立特定嘅模板檔案，精確控制網站每一部分嘅展示效果。例如，建立一個名為 category-news.php 嘅文件，可以俾你為名為「news」嘅分類單獨設計樣式同佈局。
主題功能同動態內容調用
一個靜態嘅 HTML 頁面唔係 WordPress 主題。主題必須能夠動態噉從 WordPress 數據庫度調用內容。呢個主要透過 WordPress 嘅模板標籤同循環（The Loop）嚟實現。
理解 WordPress 主循環
循環係 WordPress 主題嘅核心機制，佢用嚟從數據庫度檢索文章並喺頁面上顯示。一個最基本嘅循環結構如下，通常擺喺 index.php、single.php 或 page.php 入面：
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<article>
<h2><?php the_title(); ?></h2>
<div><?php the_content(); ?></div>
</article>
<?php endwhile; else : ?>
<p>對唔住，搵唔到任何文章。</p>
<?php endif; ?>喺呢個循環入面，the_title() 同埋 the_content() 就係模板標籤，佢哋會輸出當前文章嘅標題同內容。
引入主題功能檔案
為咗分開功能同表現，最佳做法係將 PHP 函數代碼放喺獨立 functions.php 文件入面。呢個檔案喺主題根目錄，用嚟加主題支援嘅功能、註冊菜單、側邊欄等等。
例如,在 functions.php 入面加以下呢段代碼，就可以啟用文章特色圖片同自訂菜單功能：
推薦閱讀 WordPress主題開發從入門到精通：手把手教你構建自訂網站。
<?php
function my_theme_setup() {
// 添加文章和页面的文章特色图片支持
add_theme_support( 'post-thumbnails' );
// 注册一个导航菜单位置
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-first-theme' ),
) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );調用菜單與側邊欄
喺模板文件度，你可以用 wp_nav_menu() 函數嚟顯示註冊好嘅菜單。例如，喺 header.php 度調用主導航：
<nav>
<?php wp_nav_menu( array( 'theme_location' => 'primary' ) ); ?>
</nav>同樣，你可以透過 register_sidebar() 函數喺 functions.php 中註冊小工具區域，然後喺 sidebar.php 入面用 dynamic_sidebar() 嚟調用佢。
主題樣式、腳本同性能優化
現代主題開發唔單止注重外觀，更加注重效能、無障礙同埋響應式設計。
正確引入樣式同腳本
千祈唔好直接喺模板檔案度硬連結 CSS 同 JavaScript 檔案。正確嘅做法係透過 functions.php 檔案，使用 wp_enqueue_style() 同埋 wp_enqueue_script() 函數將佢哋加入隊列。咁樣可以確保依賴關係正確，同埋避免重複載入。
function my_theme_scripts() {
// 引入主题主样式表
wp_enqueue_style( 'main-style', get_stylesheet_uri() );
// 引入自定义 JavaScript 文件
wp_enqueue_script( 'my-script', get_template_directory_uri() . '/js/main.js', array(), null, true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );構建響應式佈局
在 style.css 中，使用媒體查詢（Media Queries）嚟創建適應唔同屏幕尺寸嘅樣式。由移動設備（細屏幕）嘅樣式開始寫起，然後逐步增強針對平板同桌面嘅樣式，呢種係一種叫做「移動優先」嘅現代開發策略。
實施性能優化基礎
優化圖片大小、減少 HTTP 請求、同埋使用 WordPress 快取插件係提升主題性能嘅通用方法。喺開發層面，確保腳本同樣式只喺佢哋需要嘅頁面上加載（例如，使用條件標籤 is_page()、is_single()），可以顯著減少唔必要嘅資源消耗。
摘要
由搭建環境、創建基礎檔案，到深入理解模板層級、掌握動態內容調用同循環，再到透過 functions.php 擴展功能並最佳化效能，你已經完成咗一次完整嘅 WordPress 自訂主題開發之旅。核心在於理解 WordPress 嘅數據流同模板系統，並遵循其編碼標準。將功能、樣式同結構清晰分離，係構建可維護、高效能主題嘅關鍵。跟住落嚟，你可以探索子主題開發、自訂文章類型、主題定制器等更高級嘅主題，嚟進一步擴展你嘅主題能力。
常見問題
### 主題開發係咪一定要識 PHP？
係呀，PHP 係 WordPress 嘅核心編程語言，係進行主題開發（尤其係動態內容處理同功能擴展）嘅必備技能。你需要理解基本嘅 PHP 語法、函數同 WordPress 特有嘅 PHP 函數（模板標籤）。
functions.php 文件嘅作用係乜嘢？
functions.php 檔案係你主題嘅「功能中心」。佢用嚟添加主題功能支援（例如選單、縮圖）、註冊小工具區域、排隊加載樣式同腳本、定義自訂函數等。呢個檔案入面嘅代碼會喺主題初始化時自動加載。
點樣令我嘅主題支援多語言？
你需要做好兩件事。首先，喺 style.css 嘅頭部註解同所有使用文本嘅 PHP 函數中（如 __() 或 _e()）使用文本域（Text Domain），好似示例中嘅 ‘my-first-theme’。其次，使用 Poedit 等工具創建 .pot 翻譯文件，並為唔同語言生成 .po 同 .mo 文件。呢個就係所謂嘅國際化（i18n）同本地化。
開發時點樣調試 WordPress 錯誤？
建議喺 wp-config.php 文件度開啟 WordPress 除錯模式。將 WP_DEBUG 常數嘅值設定為 true。咁樣會喺頁面上顯示 PHP 錯誤、警告同通知，大大方便開發過程嘅問題排查。記住喺上線前要將佢閂咗。
我嘅主題點樣可以通過官方審核同埋上架？
WordPress 官方主題目錄有嚴格嘅審核要求。你嘅主題必須跟從 WordPress 編碼規範，確保代碼安全、冇錯誤，支援無障礙訪問（a11y），正確進行文本國際化，而且唔建議使用已廢棄嘅函數。詳細嘅標準可以喺 WordPress Theme Review Team 嘅 handbook 度搵到。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。