開發環境與基礎檔案準備
在開始編寫任何程式碼之前，搭建一個高效的本地開發環境至關重要。推薦使用 Local by Flywheel、XAMPP 或 MAMP 等工具快速搭建包含 PHP、MySQL 和 Apache/Nginx 的本地伺服器。在此環境中安裝好 WordPress 後，你便可以開始建立屬於你自己的主題。
一个 WordPress 主题本质上是一个位于服务器上的文件夹，包含用于设计和布局网站的各种文件和资源。这些文件和资源包括 HTML 模板、样式表、图像、脚本等。 /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 中：
<article>
<h2></h2>
<div></div>
</article>
<p>抱歉，没有找到任何文章。</p>在这个循环中，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 的資料流與模板系統，並遵循其編碼標準。將功能、樣式與結構清晰分離，是構建可維護、高效能主題的關鍵。接下來，你可以探索子主題開發、自定義文章型別、主題定製器等更高階的主題，來進一步擴充套件你的主題能力。
常见问题解答（FAQ）
### 主題開發必須掌握 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 中找到。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。