准备工作与环境搭建
在開始動手編寫代碼之前，你需要一個穩定、專業的本地開發環境。強烈建議不要在線上服務器直接修改主題文件，本地的開發環境可以讓你自由測試而不會影響網站的正常訪問。你可以選擇集成環境軟件，如 XAMPP、MAMP (Mac) 或 Laragon (Windows)，它們能一鍵安裝並配置好 Apache、MySQL 和 PHP。
WordPress 本身也需要在你的本地環境中安裝。訪問 WordPress 官網下載最新的安裝包，解壓到本地服務器的網站根目錄（例如 XAMPP 的 htdocs 文件夾）。隨後，通過瀏覽器訪問並完成著名的“五分鐘安裝”。安裝過程中，請記住你設置的數據信息。
最後，你需要一款趁手的代碼編輯器或集成開發環境。Visual Studio Code、PhpStorm 或 Sublime Text 都是優秀的選擇，它們能提供語法高亮、代碼提示和文件管理功能，極大提高開發效率。
推荐阅读 一步步掌握WordPress主題開發：從零開始構建自定義主題。
理解 WordPress 主題基礎結構
一个 WordPress 主题本质上是一个位于 的模板文件集合。 /wp-content/themes/ 目錄下的文件夾，它包含一系列遵循特定規則的文件和目錄。這些文件共同協作，告訴 WordPress 如何呈現網站的外觀和內容。
其最核心的機制是“模板層級”。WordPress 會根據當前訪問的頁面類型，自動選擇對應的模板文件來呈現內容。例如，當訪問一篇博客文章時，WordPress 會優先尋找 single.php；當訪問博客首頁時，會尋找 home.php 或者 index.php。這種機制賦予了主題極大的靈活性。
每個主題都必須包含兩個基礎文件：style.css 以及 index.php。style.css 的作用不僅是提供樣式，其文件頭部註釋塊更是主題的“身份證”，用於向 WordPress 聲明主題的名稱、作者、描述等元信息。index.php 則是最後的安全網，如果其他更具體的模板文件不存在，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
*/Text Domain 用於國際化，它是後續調用翻譯函數時使用的標識符。
推荐阅读 構建專業網站：從零開始創建自定義WordPress主題的完整指南。
除了這兩個文件，一個功能完整的主題通常還會包含：header.php（網頁頭部）、footer.php（網頁底部）、sidebar.php（側邊欄）以及 functions.php（主題功能增強文件）。通過理解這個基礎結構，你就掌握了主題開發的骨架。
創建核心模板文件
現在，讓我們開始創建第一個主題。在你的 /wp-content/themes/ 目錄下，新建一個文件夾，命名爲例如 my-first-theme。然後，在該文件夾內創建最基本的文件。
首先創建 style.css，並添加上一部分提到的主題頭部註釋。接下來，創建 index.php，這是你的第一個模板文件。一個最簡單的 index.php 可以只包含調用文章標題和內容的循環：
<main>
<article>
<h2></h2>
<div></div>
</article>
<p>暂无内容。</p>
</main>這段代碼使用了模板標籤 get_header(), get_sidebar(), get_footer(), the_title() 以及 the_content()。爲了讓它工作，你需要創建對應的頭部、側邊欄和底部文件。
创建 header.php，它應該包含 HTML 文檔的起始部分，直到主要內容區開始：
<!DOCTYPE html>
<html no numeric noise key 1007>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
</head>
<body no numeric noise key 1004>
<header>
<h1><a href="/zh-hant/</?php echo esc_url( home_url( '/' ) ); ?>"></a></h1>
<p></p>
<nav>
'primary'
) );
?>
</nav>
</header>這裏，wp_head() 是至關重要的鉤子，它允許 WordPress 核心、插件和主題向頁面頭部插入必要的代碼（如樣式錶鏈接）。body_class() 函數會輸出一系列語義化的 CSS 類名，方便你進行精細化樣式控制。
推荐阅读 WordPress 核心架構與工作原理。
创建 footer.php 來關閉打開的標籤：
<footer>
<p>©</p>
</footer>
</body>
</html>注意，wp_footer() 是與 wp_head() 相對的尾部鉤子，同樣不可或缺。
创建 sidebar.php，暫時可以只放一個簡單的控件調用：
<aside>
<?php if ( is_active_sidebar( 'sidebar-1' ) ) : ?>
<?php dynamic_sidebar( 'sidebar-1' ); ?>
<?php endif; ?>
</aside>此時，你的主題已經具備了基礎的“套模板”功能，可以在後臺激活並預覽了。雖然簡陋，但它遵循了 WordPress 的核心架構。
通過 Functions.php 增強主題功能
functions.php 文件是你的主題的“控制中心”。它不是一個模板文件，而是一個在主題初始化時自動加載的 PHP 文件，用於添加功能、註冊組件、掛鉤到 WordPress 的各個 API。這是實現主題專業化的關鍵。
你需要在主題根目錄創建這個文件。首先，讓我們爲主題添加樣式表和腳本文件。正確的做法是通過 WordPress 提供的函數來“入隊”，而不是直接在 HTML 中寫 <link> 标签。
<?php
function my_first_theme_scripts() {
// 添加主题的主样式表
wp_enqueue_style( 'main-style', get_stylesheet_uri() );
// 添加一个自定义样式表
wp_enqueue_style( 'custom-style', get_template_directory_uri() . '/assets/css/custom.css', array(), '1.0' );
// 添加一个 JavaScript 文件
wp_enqueue_script( 'main-script', get_template_directory_uri() . '/assets/js/main.js', array('jquery'), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_first_theme_scripts' );這裏，wp_enqueue_style() 以及 wp_enqueue_script() 是用於安全添加資源的函數。get_stylesheet_uri() 指向主題的 style.css。add_action() 將我們的函數掛載到 wp_enqueue_scripts 這個鉤子上，確保它在正確的時機執行。
接下來，註冊導航菜單和側邊欄（小工具區域）：
function my_first_theme_setup() {
// 注册一个导航菜单位置
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-first-theme' ),
'footer' => __( '底部菜单', 'my-first-theme' ),
) );
// 启用文章特色图像功能
add_theme_support( 'post-thumbnails' );
// 为“文章”类型启用文章格式支持
add_theme_support( 'post-formats', array( 'aside', 'gallery', 'quote' ) );
// 添加对 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' );register_nav_menus() 讓後臺的“外觀”->“菜單”界面中出現可供選擇的菜單位置。add_theme_support() 函數用於開啓各種主題功能，這是現代主題開發的標準做法。例如，開啓 title-tag 後，你就不必在 header.php 中手動輸出 <title> 標籤了。
最後，註冊一個側邊欄小工具區域：
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' => '<h2 class="widget-title">',
'after_title' => '</h2>',
) );
}
add_action( 'widgets_init', 'my_first_theme_widgets_init' );至此，你的主題已經具備了從基礎呈現到功能增強的完整鏈條。通過後臺設置菜單、添加小工具，你就能看到主題的動態變化。
总结
從創建一個包含 style.css 以及 index.php 的文件夾開始，到構建分離的模板部件（header.php, footer.php），再到通過強大的 functions.php 文件註冊菜單、側邊欄並安全地加載資源，你已經走過了創建一個自定義 WordPress 主題的完整核心路徑。這個過程的核心在於理解並遵循 WordPress 的模板層級和鉤子系統。
你不再僅僅是一個主題的使用者，而是其創造者。掌握了這些基礎知識後，你可以繼續深入學習更復雜的模板文件，如 single.php、page.php、archive.php，探索 WordPress 循環的更多可能性，並利用條件標籤（如 is_page(), is_single()）實現更精細的頁面控制。主題開發的世界廣闊而有趣，這僅僅是一個堅實的起點。
常见问题解答（FAQ）
開發 WordPress 主題需要精通 PHP 嗎？
需要具備 PHP 的基礎知識，但無需達到精通的水平。你至少需要理解變量、數組、條件語句（if/else）、循環（while/foreach）以及函數的基本概念。因爲 WordPress 主題開發大量使用了其內置的 PHP 函數（模板標籤）和鉤子系統，所以學習重點在於理解 WordPress 特有的 PHP 函數如何使用，而非從頭編寫複雜的 PHP 算法。
爲什麼必須使用 wp_head() 和 wp_footer() 函數？
這兩個函數是 WordPress 的核心鉤子。wp_head() 位於 </head> 標籤前，它允許 WordPress 核心、插件和你自己的主題在頁面頭部插入必要的代碼，例如 CSS 樣式錶鏈接、元標籤、JavaScript 變量等。wp_footer() 位於 </body> 標籤前，常用於插入分析代碼、延遲加載的 JavaScript 文件。如果缺少它們，許多插件將無法正常工作，甚至 WordPress 自身的某些功能也會出現異常。
如何爲我的主題添加頁面模板？
創建一個新的 PHP 文件，例如 page-fullwidth.php。在這個文件的頂部，你需要添加一個特定的模板名稱註釋塊。例如：
<?php
/**
* Template Name: 全宽页面
* Description: 一个没有侧边栏的页面模板
*/然後，你可以在這個文件內編寫不同於 page.php 的 HTML 結構，比如省略 get_sidebar() 調用。保存後，在 WordPress 後臺編輯頁面時，在“頁面屬性”的“模板”下拉列表中，就會出現“全寬頁面”這個選項供你選擇。
主題開發中如何處理 CSS 和 JavaScript 纔是最佳實踐？
最佳實踐是使用 WordPress 提供的 wp_enqueue_style() 以及 wp_enqueue_script() 函數，在 functions.php 中掛載到 wp_enqueue_scripts 鉤子來添加資源。這種方式可以：1）正確處理依賴關係（例如你的腳本依賴 jQuery）；2）避免重複加載同一資源；3）方便插件和其他主題代碼進行管理；4）符合 WordPress 編碼標準。絕對要避免直接在模板文件中使用 <link> 或者 <script> 標籤硬編碼資源。
我的主題如何實現多語言支持（國際化）？
你需要做兩件事。首先，在 style.css 的頭部註釋和調用翻譯文本時，使用正確的“文本域”（Text Domain）。如指南中所示，定義 Text Domain: my-first-theme。其次，在 functions.php 和所有模板文件中，對所有需要翻譯的用戶界面文本使用 WordPress 的翻譯函數進行包裹，最常用的是 __()（返回翻譯後的字符串）和 _e()（直接回顯翻譯後的字符串）。例如：<?php _e( ‘Hello World’, ‘my-first-theme’ ); ?>。之後，你可以使用 Poedit 等工具生成 .pot 模板文件，供翻譯人員創建不同語言的 .po 以及 .mo 文件。
接下来，我该怎么做呢？
延伸阅读与实用知识
以下内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，之后再逐步扩展到相关主题，这样通常效果会更好。