準備工作同環境搭建
喺開始寫程式碼之前，一個穩定又高效嘅本地開發環境係必不可少嘅。咁樣唔單止可以令你唔影響線上網站嘅情況下進行測試，仲可以大大提升開發效率。
本地開發環境配置
推薦用集成嘅本地開發工具，例如 Local by Flywheel、XAMPP 或者 MAMP。呢啲工具一鍵式安裝咗 WordPress 運行所需嘅 PHP、MySQL 同網頁伺服器（例如 Apache 或者 Nginx）。以 Local by Flywheel 為例，佢提供咗直觀嘅介面嚟快速創建同管理多個 WordPress 網站，同埋內置咗網站之間切換、一鍵啟用 HTTPS（SSL）同郵件捕獲等實用功能，非常適合主題開發。
代碼編輯器同工具選擇
一個功能強大嘅程式碼編輯器係開發者嘅利器。Visual Studio Code（VS Code）因為輕量、免費同豐富嘅插件生態而廣受歡迎。對於 WordPress 主題開發，建議安裝以下擴展：PHP Intelephense（提供 PHP 智能感知同程式碼提示）、WordPress Snippet（包含大量 WordPress 函數程式碼片段）、同埋用於 CSS 預處理語言（例如 Sass）嘅相關插件。另外，用 Git 進行版本控制係管理程式碼變更、協作同回溯嘅行業標準。
推薦閱讀 WordPress主題開發從入門到精通：自定義主題嘅完整構建指南。
創建主題基礎結構同核心檔案
一個 WordPress 主題本質上係一個喺 /wp-content/themes/ 目錄下嘅文件夾，入面包含一系列特定文件。呢啲文件一齊定義咗網站嘅外觀同功能。
主題信息文件
每個主題都必須包含一個名為 style.css 嘅文件，佢嘅作用唔單止係編寫樣式，更重要嘅係喺文件頭部透過特定嘅註釋區塊向 WordPress 聲明主題嘅元數據。呢個係 WordPress 識別一個主題嘅關鍵。
/*
Theme Name: 我的自定义主题
Theme URI: https://example.com/my-theme
Author: 你的名字
Author URI: https://example.com
Description: 这是一个从零开始构建的 WordPress 自定义主题，用于学习主题开发。
Version: 1.0.0
License: GNU General Public License v2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Text Domain: my-custom-theme
*/其中，Text Domain 用於國際化（i18n），係後續使用翻譯函數（例如 __() 或 _e()）時必須用到嘅識別符。
核心模板檔案
除咗 style.css，另一個必需嘅文件係 index.php。佢係主題嘅預設模板，當 WordPress 搵唔到更詳細嘅模板檔案嗰陣就會用返佢。不過，一個功能齊全嘅主題會包含一系列模板檔案，嚟精確控制唔同頁面嘅顯示。
header.php： 定義網站嘅頁頭區域，通常包含<!DOCTYPE html>聲明、<head>部分同開頭嘅<body>同主導航。footer.php： 定義網站嘅頁尾區域，通常包含版權資訊、腳本引入同埋閉合嘅</body></html>標籤。functions.php： 呢個係主題嘅「功能中心」，用嚟添加主題特性、註冊菜單、側邊欄，同埋排隊引入樣式表同腳本檔案。page.php： 用嚟顯示單一頁面。single.php: 用嚟顯示單篇博客文章。archive.php： 用嚟顯示文章歸檔列表（例如按分類、標籤、日期歸檔）。front-page.php： 用嚟自訂網站首頁。style.css： 主樣式表。
構建主題功能同模板系統
WordPress 使用模板層級系統來決定為當前請求嘅頁面使用邊個模板文件。理解同利用呢個系統係構建靈活主題嘅核心。
推薦閱讀 打造完美網站：從零開始構建自訂WordPress主題嘅完整指南。
主題函數文件詳解
functions.php 文件喺主題加載時自動執行。佢嘅首要任務之一係使用 wp_enqueue_style() 同埋 wp_enqueue_script() 函數來正確引入資源。呢個係 WordPress 官方推薦嘅方式，佢能夠管理依賴、避免重複加載同控制加載時機。
function my_theme_enqueue_scripts() {
// 引入主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri() );
// 引入自定义 JavaScript 文件
wp_enqueue_script( 'my-theme-script', get_template_directory_uri() . '/js/main.js', array(), '1.0.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_enqueue_scripts' );另外，你仲需要喺呢度註冊主題支援嘅功能，例如文章縮圖、自訂菜單位置同文章格式。
function my_theme_setup() {
// 支持文章特色图像
add_theme_support( 'post-thumbnails' );
// 注册导航菜单
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-custom-theme' ),
'footer' => __( '页脚菜单', 'my-custom-theme' ),
) );
// 支持 HTML5 标记
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption' ) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );模板標籤同循環
模板標籤係 WordPress 提供嘅 PHP 函數，用喺模板檔案度動態輸出內容。最核心嘅係「循環」（The Loop），佢係一段 PHP 代碼，用嚟檢查當前頁面有冇文章，並依次輸出每一篇文章。
在 index.php 或 single.php 當中，循環嘅基本結構如下：
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<article>
<h2><?php the_title(); ?></h2>
<div class="entry-content">
<?php the_content(); ?>
</div>
</article>
<?php endwhile; else : ?>
<p><?php _e( '抱歉，没有找到任何内容。', 'my-custom-theme' ); ?></p>
<?php endif; ?>呢度，the_title() 同埋 the_content() 就係模板標籤，佢哋分別輸出當前文章嘅標題同正文內容。其他常用嘅模板標籤仲包括 the_permalink()（文章連結）、the_post_thumbnail()（特色圖像）同 the_author()（作者）等等。
實現響應式設計同高級特性
現代網站必須喺各種設備上面都可以良好顯示。同時，為咗提升主題嘅穩健性同可維護性，需要引入一啲高級開發實踐。
推薦閱讀 掌握 WordPress 主題開發：從入門到精通嘅完整實戰指南。
使用 CSS 實現響應式佈局
響應式設計嘅核心係媒體查詢（Media Queries）。你可以喺 style.css 度為唔同屏幕闊度定義唔同嘅樣式規則。一個常見嘅模式係「移動優先」，即係先編寫移動端嘅基礎樣式，然後逐步為更大屏幕添加覆蓋樣式。
/* 基础样式（针对移动设备） */
.container {
width: 100%;
padding: 0 15px;
}
/* 中等屏幕（平板，768px 及以上） */
@media (min-width: 768px) {
.container {
width: 750px;
margin: 0 auto;
}
}
/* 大屏幕（桌面，992px 及以上） */
@media (min-width: 992px) {
.container {
width: 970px;
}
}引入子主題進行定制
直接修改父主題（你正在開發嘅主題）嘅代碼有風險，當父主題更新時，你嘅修改會被覆蓋。WordPress 嘅子主題功能完美解決咗呢個問題。子主題繼承父主題嘅所有功能，但允許你只覆蓋需要修改嘅文件（如 style.css、functions.php 或者某個模板檔案）。
整子主題好簡單：喺 /wp-content/themes/ 下面開個新資料夾，再整一個包含以下標頭資訊嘅 style.css 檔案，當中 Template: 行必須指定父主題嘅目錄名。
/*
Theme Name: 我的自定义主题 - 子主题
Template: my-custom-theme
*/然後，喺子主題嘅 functions.php 喺入面，你可以安全地加新功能或者改現有功能，而唔使掂到父主題嘅代碼。呢個係 WordPress 主題生態中一種好勁又安全嘅定制同更新策略。
摘要
由零開始開發一個 WordPress 自訂主題係一個系統性工程，佢要求開發者唔單止要熟 PHP、HTML、CSS 同 JavaScript 等前端技術，仲要深入理解 WordPress 嘅核心概念，好似模板層級、循環、模板標籤同掛鈎系統。透過搭建本地環境、創建基礎檔案結構、喺 functions.php 入面增強功能、構建模板系統，同最終應用響應式設計同子主題策略，你可以逐步構建出一個又符合標準又滿足個性化需求嘅高質素主題。呢個過程唔單止係技術實踐，更加係對 WordPress 靈活性同強大擴展能力嘅深度體驗。
常見問題
開發 WordPress 主題係咪一定要精通 PHP 呢？
係呀，具備紮實嘅 PHP 基礎係進行 WordPress 主題深度開發嘅必要條件。因為 WordPress 本身係用 PHP 編寫嘅，所有模板檔案（如 page.php, single.php）同核心功能文件 functions.php 都係 PHP 腳本。你需要使用 PHP 來調用 WordPress 嘅函數（模板標籤同 API）、處理數據同控制邏輯流程。雖然你可以透過頁面構建器或者子主題進行一啲表面調整，但係想真正實現自訂版面同功能，PHP 知識就不可或缺。
主題嘅 functions.php 檔案可以有幾多個？
唔可以。每個主題（或者子主題）有且只有一個名為 functions.php 嘅文件。呢個文件喺主題初始化時會自動載入。如果你需要將功能模組化以保持代碼整潔，可以喺 functions.php 入面用 require_once() 或 include_once() 語句嚟引入其他位於主題目錄下嘅 PHP 文件。例如，你可以建立 /inc/ 目錄，將自訂文章類型、小工具、短代碼等功能分別寫喺唔同嘅文件入面，然後喺主 functions.php 中統一引入。
點樣可以令我嘅主題支援多語言（國際化）？
令主題支援多語言，即國際化（i18n），主要涉及兩個步驟。首先，喺主題嘅所有文字輸出位置，用 WordPress 嘅翻譯函數包住字串。最常用嘅係 __()（返返翻譯後嘅字串）同 _e()（直接輸出翻譯後嘅字串）。你必須喺代碼中指定喺 style.css 頭部定義嘅 Text Domain。
echo __( ‘这是一个示例文本‘， ‘my-custom-theme‘ );其次，你需要用好似 Poedit 噉嘅工具，掃描主題中所有可翻譯字串，生成一個 .pot（模板）檔案。翻譯者可以基於呢個創建對應語言嘅 .po 同埋編譯好嘅 .mo 文件。將呢啲語言檔案放喺主題嘅 /languages/ 目錄下，當用戶切換網站語言時，對應嘅翻譯就會自動載入。
開發完成後，點樣將主題打包發佈？
喺發佈前，請確保移除所有調試代碼、註解中嘅敏感資訊，並最小化 CSS 同 JavaScript 檔案以提升效能。然後，創建一個包含所有主題檔案嘅 ZIP 壓縮包。關鍵嘅根目錄檔案必須包含：style.css（帶有完整正確嘅頭部資訊）、index.php 同埋 functions.php。你仲可以包含一個 screenshot.png（1200×900 像素）作為主題喺後台嘅預覽圖。如果想將主題提交到 WordPress 官方主題目錄，需要跟從嚴格嘅代碼規範同審核指南。對於自行分發，確保你嘅主題跟從 GPL 許可證，並提供一個清晰嘅 readme.txt 檔案說明安裝同使用方法。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。