准备工作与环境搭建
在開始編寫程式碼之前，一個穩定且高效的本地開發環境是必不可少的。這不僅能讓你在不影響線上網站的情況下進行測試，還能極大地提升開發效率。
本地開發環境配置
推薦使用整合的本地開發工具，如 Local by Flywheel、XAMPP 或 MAMP。這些工具一鍵式安裝了 WordPress 執行所需的 PHP、MySQL 和 Web 伺服器（如 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 主题本质上是一个位于服务器上的文件夹，包含用于设计和布局网站的各种文件和资源。这些文件和资源包括 HTML 模板、样式表、图像、脚本等。 /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 中，迴圈的基本結構如下：
<article>
<h2></h2>
<div class="entry-content">
</div>
</article>
<p><?php _e( '抱歉，没有找到任何内容。', 'my-custom-theme' ); ?></p>ここでは、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 靈活性和強大擴充套件能力的深度體驗。
常见问题解答（FAQ）
開發 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 檔案說明安裝和使用方法。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。