想要開始WordPress主題開發，一臺配置了本地PHP環境的計算機是首要條件。你可以選擇XAMPP、MAMP、Local by Flywheel等工具來快速搭建。之後，你需要一個程式碼編輯器，例如Visual Studio Code、PHPStorm或Sublime Text，它們能提供語法高亮、程式碼提示等功能，顯著提升開發效率。最後，請確保安裝並激活了最新版本的WordPress。
在開始編碼前，理解WordPress主題的目錄結構至關重要。一個最基礎的主題至少需要兩個檔案：style.css以及index.php。但在實際開發中，我們通常需要更多檔案來解耦功能。典型的現代主題結構可能如下所示：
your-theme/
├── style.css # 主题样式和基本信息
├── index.php # 主模板文件
├── header.php # 头部模板
├── footer.php # 底部模板
├── sidebar.php # 侧边栏模板
├── functions.php # 功能和特性定义
├── page.php # 页面模板
├── single.php # 文章模板
└── assets/
├── css/
├── js/
└── images/建立核心主題檔案
在這一步，我們將建立主題的基石。這些檔案定義了主題的身份和基本骨架。
推荐阅读 WordPress主題開發終極指南：從零到一構建自定義主題。
定義主題資訊與主樣式表
style.css檔案不僅是樣式表，更是主題的“身份證”。它頂部的註釋塊包含了WordPress識別主題所需的所有元資訊。一個基本的頭部註釋如下所示：
/*
Theme Name: 我的第一个主题
Theme URI: https://example.com/my-first-theme
Author: 你的名字
Author URI: https://example.com
Description: 这是一个从零开始构建的简单自定义主题，用于学习WordPress主题开发。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-first-theme
*/其中,Text Domain用於國際化，是後續呼叫翻譯函式的關鍵標識。在註釋塊之後，你就可以像編寫普通CSS一樣，為你的主題新增樣式了。
構建主題的骨架模板
index.php是主題的預設主模板，也是所有頁面的後備模板。一個良好的實踐是使用WordPress的模板函式來引入模組化的部分，而不是將所有程式碼堆砌在一個檔案中。一個極簡但結構清晰的index.php可能如下所示：
<main id="primary" class="site-main">
<?php
if ( have_posts() ) :
while ( have_posts() ) :
the_post();
// 显示文章内容
the_content();
endwhile;
else :
echo '<p>暂无内容。</p>';
endif;
?>
</main>分離頭部與底部模板
header.php檔案通常包含HTML文件的頭部，直到內容區域開始之前。它應包含宣布、标签、區域（使用wp_head()鉤子）以及網站標題和主導航。關鍵函式是wp_head()，它允許外掛和主題在頭部注入必要的程式碼（如CSS和JS）。
footer.php檔案則包含內容區域結束後的所有內容，如頁尾小工具區域、版權資訊等。它必須以wp_footer()函式呼叫結束，該函式對於許多外掛（如分析程式碼）的正常工作是必需的。
推荐阅读 構建專業網站：從零開始建立自定義 WordPress 主題的完整指南。
引入功能與增強主題
functions.php檔案是你的主題的“控制中心”，它不是一個模板檔案，而是一個在主題初始化時自動載入的PHP檔案。你可以在這裡新增主題支援、註冊選單、樣式表和指令碼，以及定義各種自定義功能。
啟用核心主題功能
通过add_theme_support()函式，你可以為你的主題宣告對某些WordPress核心功能的支援。例如，啟用文章縮圖（特色影象）和HTML5標記支援是現代主題的標配：
<?php
function my_theme_setup() {
// 启用文章和评论的HTML5标记支持
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption', 'style', 'script' ) );
// 启用文章缩略图功能
add_theme_support( 'post-thumbnails' );
// 设置默认缩略图尺寸
set_post_thumbnail_size( 800, 400, true );
// 启用标题标签支持（由WordPress自动生成<title>标签）
add_theme_support( 'title-tag' );
}
add_action( 'after_setup_theme', 'my_theme_setup' );註冊選單與載入資源
註冊導航選單位置允許使用者在後臺“外觀”->“選單”中管理它們。使用register_nav_menus()函式實現：
function my_theme_menus() {
register_nav_menus(
array(
'primary' => __( '主导航菜单', 'my-first-theme' ),
'footer' => __( '页脚菜单', 'my-first-theme' ),
)
);
}
add_action( 'after_setup_theme', 'my_theme_menus' );以正確的方式載入CSS和JavaScript檔案是良好效能的保障。你應該使用wp_enqueue_style()以及wp_enqueue_script()创建一个函数，并将其挂载到wp_enqueue_scripts鉤子上。這樣可以確保依賴關係正確，並避免重複載入。
建立特定頁面模板
WordPress遵循模板層級系統，這意味著它會根據當前瀏覽的頁面型別自動尋找最匹配的模板檔案。為不同型別的頁面建立專門的模板，可以讓佈局和內容展示更加精細。
為單篇文章與獨立頁面設計模板
single.php模板用於展示單篇文章。它與index.php迴圈類似，但通常包含更完整的元資訊，如分類、標籤、作者、釋出時間和評論區域。
推荐阅读 WordPress主題開發完整教程：從零開始構建自定義主題。
page.php模板用於展示獨立的靜態頁面。它通常不顯示文章元資料（如分類、釋出時間），迴圈更簡單，專注於展示頁面編輯器的內容。
構建文章列表與歸檔頁面模板
archive.php模板用於顯示分類、標籤、作者、日期等歸檔頁面。它通常有一個標題（如“分類：科技”）和一個文章列表。
home.php或者front-page.php用於定製部落格首頁。如果存在front-page.php，它將作為站點首頁；如果存在home.php，它將作為文章索引頁。
實現自定義搜尋與404頁面
search.php用於顯示搜尋結果。你可以在這裡使用the_search_query()函式來輸出使用者的搜尋關鍵詞。
404.php則在使用者訪問不存在的地址時顯示。一個好的404頁面應該包含友好的提示、搜尋框和關鍵頁面的連結。
整合小工具與動態側邊欄
小工具是WordPress提供給使用者靈活新增內容區塊（如最新文章列表、分類目錄、搜尋框等）的功能。要讓你的主題支援小工具，需要先註冊一個或多個“側邊欄”（實際上是小工具就緒區域），然後在模板中顯示它們。
註冊小工具就緒區域
使用
（注：此处"使用"指的是某种产品或服务的使用情况）register_sidebar()函式來註冊一個側邊欄。你可以在functions.php中定義多個側邊欄，分別用於主側邊欄、頁尾區域等。
function my_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_theme_widgets_init' );在模板中呼叫側邊欄
註冊之後，你需要在模板檔案中使用dynamic_sidebar()函式來輸出這個區域。例如，在sidebar.php中：
<?php if ( is_active_sidebar( 'sidebar-1' ) ) : ?>
<aside id="secondary" class="widget-area">
<?php dynamic_sidebar( 'sidebar-1' ); ?>
</aside>
<?php endif; ?>然後，在index.php、single.php等需要側邊欄的模板中，使用get_sidebar()函式引入sidebar.php。使用者現在就可以在WordPress後臺的“外觀”->“小工具”頁面，向“主側邊欄”拖拽新增各種小工具了。
总结
從零開始構建一個WordPress自定義主題是一個系統性的學習過程，它從理解基礎的檔案結構開始，逐步深入到模板層級、功能增強與動態內容區域。核心在於掌握style.css、index.php、header.php、footer.php以及functions.php這幾個基石檔案的作用與寫法。透過add_theme_support()啟用功能，透過模板層級建立針對性的頁面模板，再透過register_sidebar()整合小工具，一個功能完整、結構清晰的主題便初具雛形。這不僅是技術實現，更是對WordPress內容管理邏輯的深刻理解。
常见问题解答（FAQ）
開發主題前必須使用子主題嗎？
不一定。如果你是從零開始完全原創一個主題，可以直接建立父主題。使用子主題的最佳場景是：當你想要對一個現有主題（父主題）進行定製和修改，並希望在未來能安全地更新父主題而不丟失你的自定義修改時。從零開始學習開發，直接建立父主題更利於理解整個架構。
為什麼我的主題在後臺“外觀”中不顯示？
这通常是因为style.css檔案頂部的主題資訊註釋塊格式不正確、缺失或存在語法錯誤導致的。請仔細檢查該檔案開頭的註釋塊是否嚴格按照格式書寫，特別是Theme Name:這一行必須存在且正確。同時，確保你的主題資料夾已放置在wp-content/themes/请看下方目录。
functions.php 和外掛有什麼區別？
functions.php檔案中的程式碼與你的主題緊密繫結，當切換主題時，這些功能通常會失效。它適合存放與主題外觀、佈局、模板功能直接相關的程式碼。而外掛用於提供獨立於主題的、可跨主題使用的功能。一個簡單的原則是：如果功能是影響網站外觀或佈局的，放在主題的functions.php中；如果是新增獨立業務邏輯（如聯絡表單、SEO最佳化）的，應制作成外掛。
怎样让我的主题支持多语言？
讓主題支援多語言（國際化與本地化）主要涉及兩個步驟。首先，在style.css的註釋塊和functions.php中所有需要翻譯的字串處，使用像__( ‘文本’, ‘my-first-theme’ )這樣的翻譯函式進行包裹，其中‘my-first-theme’是你的文字域（Text Domain）。其次，你需要使用如Poedit這樣的工具，掃描主題檔案生成.pot模板檔案，併為每種語言建立對應的.po以及.mo翻譯檔案，將它們放在主題的/languages/请看下方目录。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。