準備工作與環境配置
在開始編寫第一行代碼之前，你需要一個合適的開發環境。這包括一個本地服務器環境和代碼編輯器。推薦使用 XAMPP、MAMP 或 Laragon 來搭建本地服務器，它們能一鍵安裝並運行 Apache、MySQL 和 PHP。選擇一個你喜歡的代碼編輯器，例如 Visual Studio Code、Sublime Text 或 PHPStorm，它們對代碼高亮和自動補全的支持將極大提升你的開發效率。
接下來，你需要在本地 WordPress 安裝中爲你的新主題創建一個目錄。所有 WordPress 主題都存放在 /wp-content/themes/ 目錄下。在這個文件夾裏，爲你即將創建的主題新建一個文件夾，例如命名爲 my-first-theme。這個文件夾的名稱就是你的主題標識，它將體現在後臺的主題列表中。
同時，你需要了解 WordPress 主題開發的兩大基石：模板文件和樣式表文件。最基本的 WordPress 主題只需要兩個文件：style.css 以及 index.php。style.css 不僅控制着網站的視覺樣式，其文件頭部的註釋塊更是主題的“身份證”，包含了主題名稱、作者、描述等元信息。index.php 則是默認的主模板文件。
推荐阅读 完整的 WordPress 主题开发指南：从零开始构建自定义主题。
創建核心主題文件
定義主題樣式與信息
一切從 style.css 開始。在主題文件夾根目錄下創建這個文件，並在文件頂部添加一個格式化的註釋塊。這個註釋塊是 WordPress 識別並加載主題的關鍵。下面的代碼展示了一個基本的樣式表頭部：
/*
Theme Name: My First Theme
Theme URI: https://example.com/my-first-theme/
Author: Your Name
Author URI: https://yourwebsite.com
Description: 这是一个学习 WordPress 主题开发而创建的入门级主题。
Version: 1.0
License: GNU General Public License v2 or later
Text Domain: my-first-theme
*/其中,Text Domain 用於國際化（i18n），爲未來的多語言翻譯做準備。創建好這個文件後，登錄 WordPress 後臺的“外觀”->“主題”頁面，你應該就能看到你的主題了，儘管它現在還沒有任何功能。
構建基礎模板結構
接下來創建主題的骨架文件 index.php。這是最基礎的模板，當 WordPress 找不到更具體的模板文件（如 single.php 或者 page.php）時，就會使用它。一個最簡單的 index.php 可以只包含調用 WordPress 頭部、循環和尾部的基本函數。
<!DOCTYPE html>
<html no numeric noise key 1011>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
</head>
<body no numeric noise key 1008>
<header>
<h1><a href="/zh-hant/</?php echo esc_url( home_url( '/' ) ); ?>"></a></h1>
<p></p>
</header>
<main>
<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
// 文章内容输出
the_title( '<h2>', '</h2>' );
the_content();
endwhile;
else :
echo '<p>暂无文章。</p>';
endif;
?>
</main>
<footer>
<p>©</p>
</footer>
</body>
</html>這個文件使用了 WordPress 的核心模板標籤，如 bloginfo() 獲取網站信息，the_title() 以及 the_content() 在循環中輸出文章標題和內容。wp_head() 以及 wp_footer() 是至關重要的鉤子，它們允許 WordPress 核心、插件和其他腳本向頁面的 <head> 以及 <footer> 區域注入代碼。
拆分模板與引入功能
模塊化模板文件
将 index.php 中的所有代碼寫在一個文件裏會導致代碼難以維護。最佳實踐是將其拆分爲多個模板部件（Template Parts）。創建以下文件來組織代碼結構：
* header.php：存放 <head> 區域和網站頂部導航等公共頭部內容。
* footer.php：存放網站底部版權信息等公共尾部內容。
* sidebar.php：存放側邊欄小工具區域（可選）。
* functions.php：主題的功能函數文件。
推荐阅读 從零開始：手把手教你開發一個自定義的WordPress主題。
然後，使用 get_header()、get_footer() 以及 get_sidebar() 等函數在 index.php 中引入它們。改造後的 index.php 核心部分將變得非常簡潔：
<main>
<article>
<?php the_title( '<h2>', '</h2>' ); ?>
</article>
<p><?php esc_html_e( '抱歉，没有找到符合条件的内容。', 'my-first-theme' ); ?></p>
</main>注意我們使用了 esc_html_e( '抱歉，没有找到符合条件的内容。', 'my-first-theme' ) 來輸出翻譯就緒的文本，這是國際化的標準做法。
增強主題功能
functions.php 文件是你的主題的“控制中心”。它用於添加主題支持的功能、註冊菜單和側邊欄、加載樣式表和腳本等。它不是一個模板文件，而是在主題初始化時自動加載。
下面是一個基礎的 functions.php 示例：
__( '主导航菜单', 'my-first-theme' ),
) );
// 添加对 HTML5 标记的支持
add_theme_support( 'html5', array( 'search-form', 'comment-form', 'comment-list', 'gallery', 'caption' ) );
// 添加标题标签支持
add_theme_support( 'title-tag' );
}
add_action( 'after_setup_theme', 'my_first_theme_setup' );
// 注册侧边栏小工具区域
function my_first_theme_widgets_init() {
register_sidebar( array(
'name' => __( '主侧边栏', 'my-first-theme' ),
'id' => 'sidebar-1',
'description' => __( '在此添加小工具。', 'my-first-theme' ),
'before_widget' => '<section id="%1$s" class="widget %2$s">',
'after_widget' => '</section>',
'before_title' => '<h3 class="widget-title">',
'after_title' => '</h3>',
) );
}
add_action( 'widgets_init', 'my_first_theme_widgets_init' );
// 加载主题的样式表
function my_first_theme_scripts() {
wp_enqueue_style( 'my-first-theme-style', get_stylesheet_uri(), array(), wp_get_theme()->get( 'Version' ) );
}
add_action( 'wp_enqueue_scripts', 'my_first_theme_scripts' );
?>在這個文件中，我們定義了函數 my_first_theme_setup，并通过 add_action( ‘after_setup_theme’， ‘my_first_theme_setup’ ) 將其掛載到 WordPress 初始化主題的特定動作鉤子上。同樣，我們使用 register_sidebar 函數註冊了一個小工具區域，並通過 wp_enqueue_style 函數正確引入了主題樣式表。
創建專用模板與樣式
爲不同頁面類型定製模板
WordPress 的模板層次結構允許你爲不同類型的頁面創建特定的模板文件。例如：
* front-page.php：用作靜態首頁。
* home.php：博客文章列表頁。
* single.php：單篇文章詳情頁。
* page.php：單頁面。
* archive.php：分類、標籤、作者等存檔頁。
* search.php：搜索結果頁。
* 404.php：404 錯誤頁面。
推荐阅读 WordPress主題開發入門實戰指南：從零打造自定義主題架構與模板。
创建 page.php 可以讓你獨立控制所有頁面的外觀，而不影響文章頁。它的結構與 index.php 類似，但通常不需要顯示文章發佈的元數據（如日期、作者）。
設計響應式佈局與交互
現代 WordPress 主題必須是響應式的。這意味着你的 CSS 需要適配從手機到桌面的所有屏幕尺寸。建議使用移動優先（Mobile First）的 CSS 策略，即先爲小屏幕編寫基礎樣式，然後使用媒體查詢（Media Queries）爲大屏幕添加增強樣式。
同時，你的主題可能需要一些JavaScript來提供交互功能，如下拉菜單、輪播圖等。正確的做法是在 functions.php 使用中文（简体） wp_enqueue_script() 函數來註冊和排隊腳本，並確保依賴關係（如 jQuery）正確聲明。這樣可以避免腳本衝突和重複加載，併兼容 WordPress 的腳本優化功能。
总结
通過以上步驟，你已經完成了一個最基本的、可運行的 WordPress 自定義主題。你學會了如何創建定義主題信息的 style.css，構建基礎的 index.php 模板，將模板拆分爲模塊化的部件，以及在 functions.php 中增強主題功能。你還了解了 WordPress 強大的模板層次結構，這爲創建更復雜的專用模板頁面鋪平了道路。
主題開發是一個不斷迭代和深入的過程。接下來，你可以探索子主題（Child Theme）開發來安全地修改現有主題，學習使用 WordPress 定製器（Customizer）API 讓用戶能夠通過後臺實時調整主題設置，或者深入研究 WordPress 的 REST API 來創建與前端框架結合的主題。保持對官方開發者文檔的關注，並積極參與社區，是持續提升的關鍵。
常见问题解答（FAQ）
開發 WordPress 主題必須精通 PHP 嗎？
是的，具備紮實的 PHP 基礎是 WordPress 主題開發的必要條件。因爲 WordPress 本身是用 PHP 編寫的，所有模板文件（如 index.php、single.php）和功能文件（functions.php）都需要使用 PHP 代碼來動態生成內容、調用 WordPress 函數和操作數據。
同時，你還需要熟悉 HTML 和 CSS 來構建頁面結構和樣式，並對 JavaScript（特別是 jQuery，因爲它被包含在 WordPress 核心中）有基本的瞭解，以添加交互功能。
爲什麼我的主題更改在 WordPress 後臺不顯示？
這通常是由瀏覽器或服務器緩存造成的。首先，嘗試在瀏覽器中按 Ctrl + F5（Windows/Linux）或 Cmd + Shift + R（Mac）進行強制刷新，以清除瀏覽器緩存。
如果問題依舊，可能是服務器端或 WordPress 緩存插件（如 W3 Total Cache, WP Super Cache）緩存了舊文件。請嘗試清空所有緩存插件中的緩存。在開發階段，建議暫時停用這些緩存插件以避免干擾。
如何讓我的主題支持多語言？
讓主題支持多語言（國際化與本地化，i18n 和 l10n）主要依賴於 WordPress 的翻譯函數。在主題中，所有面向用戶的文本字符串都不應直接寫出，而應使用翻譯函數包裹。
例如，使用 (‘文本’， ‘my-first-theme’) 進行翻譯，或使用 echo esc_html(‘文本’， ‘my-first-theme’) 進行輸出和轉義。你需要在 style.css 的頭部和 load_theme_textdomain() 函数调用中要正确设置参数。 Text Domain（文本域），然後使用如 Poedit 這樣的工具創建 .pot 翻譯模板和 .po/.mo 語言文件。
主題的 functions.php 和插件的功能有什麼區別？
functions.php 文件中的代碼功能與插件代碼功能類似，都可以用來擴展 WordPress。主要區別在於作用域和用途。
functions.php 中的功能是與當前主題緊密綁定的。當用戶切換主題時，這些功能通常不再可用。它適合添加與主題視覺呈現、佈局、模板直接相關的功能（如註冊菜單位置、添加主題支持選項）。
而插件提供的功能是獨立於主題的，無論使用什麼主題，只要插件啓用，其功能就存在。它適合添加與主題外觀無關的通用性功能（如聯繫表單、SEO優化、電商功能）。如果一個功能在更換主題後仍需保留，那麼它應該被實現爲一個插件。
接下来，我该怎么做呢？
延伸阅读与实用知识
以下内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，之后再逐步扩展到相关主题，这样通常效果会更好。