開發環境與基礎檔案結構
在開始構建一個WordPress主題之前，建立一個高效、結構清晰的開發環境至關重要。這不僅有助於程式碼組織，也為後續的維護和擴充套件打下基礎。一個標準的WordPress主題是一個位於/wp-content/themes/目錄下的資料夾，其內部檔案遵循特定的命名和結構規範。
核心檔案與目錄
每個WordPress主題都必須至少包含兩個檔案：index.php以及style.css其中,style.css不僅是樣式表，更是一個主題的“身份證”，其檔案頭部的註釋塊用於向WordPress系統宣告主題資訊。一個典型的style.css檔案標頭如下所示：
/*
Theme Name: My Custom Theme
Theme URI: https://example.com/my-theme
Author: Your Name
Author URI: https://example.com
Description: 这是一个从头开始构建的自定义WordPress主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/除了這兩個必需檔案，一個功能完整、結構良好的主題通常包含以下目錄和檔案：
* functions.php：主題的功能檔案，用於新增功能、註冊選單、側邊欄等。
* header.php: 網站的頭部模板。
* footer.php: 網站的底部模板。
* sidebar.php侧边栏模板。
* page.php: 頁面模板。
* single.php: 文章詳情頁模板。
* archive.php: 文章歸檔頁模板。
* 404.php: 404錯誤頁面模板。
* search.php: 搜尋結果頁面模板。
* assets/目錄: 用於存放靜態資源，通常包含css/、js/、images/等子目錄。
推荐阅读 零基础入门：手把手教你搭建自定义WordPress主题。
本地開發環境配置
推薦使用本地伺服器環境軟體（如Local by Flywheel, XAMPP, MAMP）來搭建開發環境。這允許你在自己的電腦上安裝WordPress、資料庫（如MySQL）和PHP，進行離線開發和除錯，效率遠高於直接在線上伺服器修改。同時，使用版本控制系統（如Git）來管理你的主題程式碼是一個最佳實踐。
構建主題核心模板
WordPress主題開發的核心是模板層級系統。系統會根據使用者訪問的頁面型別，自動選擇對應的模板檔案來渲染頁面。理解並正確構建這些模板檔案是主題開發的關鍵。
頭部與底部模板
頭部模板header.php負責輸出每個頁面的開頭部分，通常包括HTML文件宣告、<head>區域（包含標題、字符集、視口設定、引入的樣式和指令碼）以及網站的標誌和主導航選單。在header.php的末尾，通常會呼叫<body>標籤的開始部分和wp_body_open鉤子。
底部模板footer.php則負責輸出每個頁面的結尾部分，通常包括頁尾小工具區域、版權資訊、引入的JavaScript檔案，以及關閉<body>以及<html>标签。
在其他模板檔案中，透過get_header()以及get_footer()函式來引入它們，確保網站結構的一致性。
推荐阅读 WordPress 主题开发指南：从零开始构建自定义主题的完整流程与最佳实践。
主迴圈與內容展示
WordPress的“主迴圈”是主題的引擎，它用於從資料庫中檢索並顯示文章。迴圈通常使用if ( have_posts() ) : while ( have_posts() ) : the_post();結構。在迴圈內部，你可以使用一系列模板標籤來輸出文章內容，例如the_title()、the_content()、the_excerpt()、the_permalink()、the_post_thumbnail()等等。
index.php作為最基礎的備用模板，應該包含一個完整的迴圈結構。而更具體的模板，如single.php（用於單篇文章）和page.php（用於獨立頁面），則可以根據需要定製迴圈內的展示方式。例如，single.php通常會顯示完整的文章內容和評論列表，而page.php則可能只顯示內容，不顯示釋出日期和作者資訊。
// 在 single.php 中一个典型的主循环示例
if ( have_posts() ) :
while ( have_posts() ) : the_post();
?>
<article id="post-<?php the_ID(); ?>" no numeric noise key 1004>
<header class="entry-header">
<h1 class="entry-title"></h1>
<div class="entry-meta">
<?php the_date(); ?> | 作者: <?php the_author(); ?>
</div>
</header>
<div class="entry-content">
</div>
</article>
<?php
// 显示评论区
if ( comments_open() || get_comments_number() ) :
comments_template();
endif;
endwhile;
endif;使用 functions.php 增強主題功能
functions.php檔案是你的主題的“控制中心”，所有不屬於直接顯示樣式的功能程式碼都應新增在此。它的作用相當於一個始終啟用的外掛。
註冊主題支援與選單
通过add_theme_support()函式，你可以為你的主題宣告支援哪些WordPress核心功能。例如，啟用文章特色影象、自定義徽標、文章格式等是現代主題的標配。
function my_theme_setup() {
// 添加文章特色图像支持
add_theme_support( 'post-thumbnails' );
// 添加自定义徽标支持
add_theme_support( 'custom-logo' );
// 添加标题标签支持（由WordPress自动管理）
add_theme_support( 'title-tag' );
// 添加HTML5标记支持
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption', 'style', 'script' ) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );註冊導航選單位置也是在這裡完成的。使用register_nav_menus()函式定義選單位置，然後你就可以在header.php请将下文翻译成中文，并详细说明翻译过程：wp_nav_menu()来呼叫它吧。
新增樣式表與指令碼
正確的做法是將樣式表和JavaScript檔案透過wp_enqueue_style()以及wp_enqueue_script()函式進行註冊和排隊。這確保了依賴關係正確處理，避免重複載入，並且與外掛相容。此操作應該在wp_enqueue_scripts鉤子上進行。
推荐阅读 從零開始：打造一個高效能、可自訂的 WordPress 佈景主題完整指南。
function my_theme_scripts() {
// 引入主题的主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri(), array(), '1.0.0' );
// 引入自定义CSS文件
wp_enqueue_style( 'my-custom-css', get_template_directory_uri() . '/assets/css/custom.css', array(), '1.0.0' );
// 引入jQuery（WordPress已内置）和自定义JS
wp_enqueue_script( 'my-custom-js', get_template_directory_uri() . '/assets/js/main.js', array( 'jquery' ), '1.0.0', true ); // true表示在底部加载
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );建立自定義模板與頁面模板
WordPress允許你為特定頁面或文章建立獨特的佈局，這主要透過自定義模板和頁面模板實現。
自定義文章型別與分類法模板
如果你透過程式碼或外掛註冊了自定義文章型別（如“產品”）或自定義分類法（如“產品類別”），WordPress的模板層級同樣適用。例如，你可以建立single-product.php來單獨控制“產品”型別的單頁顯示，建立archive-product.php來控制產品列表頁，建立taxonomy-product-category.php來控制特定產品分類的歸檔頁。這為構建複雜的內容型網站（如作品集、商城）提供了極大的靈活性。
條件標籤與自定義頁面模板
條件標籤（如is_front_page()、is_page()、is_single()）讓你可以在一個模板檔案內根據不同的條件輸出不同的內容。但更強大的方式是建立自定義頁面模板。
你可以在主題目錄下建立一個PHP檔案，並在檔案頭部新增特定的註釋塊來將其宣告為一個頁面模板。然後，在WordPress後臺為某個頁面選擇這個模板即可。
<?php
/**
* Template Name: 全宽页面模板
* Description: 一个没有侧边栏的全宽度页面模板
*/
get_header(); ?>
<div class="full-width-content">
<?php
while ( have_posts() ) : the_post();
the_content();
endwhile;
?>
</div>此外，從WordPress 5.0開始，古騰堡區塊編輯器成為核心。你可以透過建立區塊模板（block-template-canvas.php）或利用theme.json檔案來全域性定義主題的樣式、調色盤和區塊支援，實現更現代、視覺化的主題構建方式。
总结
從零開發一個WordPress主題是一個系統性的工程，它要求開發者不僅掌握PHP、HTML、CSS和JavaScript，更要深入理解WordPress的核心概念，如模板層級、主迴圈、鉤子與動作、模板標籤等。從搭建規範的目錄結構開始，逐步構建頭部、底部和核心模板檔案，利用functions.php來增強功能和正確載入資源，最後透過自定義模板和條件邏輯實現複雜的頁面佈局。遵循這一流程，你將能夠打造出完全符合設計需求、效能優異且易於維護的自定義主題，從而在WordPress的世界裡獲得最大的自由度與控制力。
常见问题解答（FAQ）
主題開發一定要從零開始嗎？
不一定。對於初學者或希望快速上手的開發者，從一個現有的基礎主題（Underscores, _s）或父主題（如Genesis, Astra）開始是絕佳選擇。它們已經搭建好了標準的檔案結構和基礎程式碼，你可以在此基礎上進行修改和定製，這比完全從零開始要高效得多。
style.css 檔案可以完全為空嗎？
不可以。雖然樣式可以為空，但檔案頂部的主題資訊註釋塊必須存在且格式正確，否則WordPress將無法識別你的主題。該註釋塊是主題在WordPress後臺列表中顯示的名稱、作者、描述等資訊的來源。
怎样让我的主题支持多语言（国际化）？
你需要使用WordPress的國際化函式（如__()、_e()）來包裹所有需要翻譯的文字字串。然後在style.css以及functions.php正确设置中文环境变量Text Domain，並使用Poedit等工具建立.pot模板檔案以及對應的.po以及.mo翻譯檔案。這是一個專業主題的必備特性。
為什麼我的自定義模板在後臺頁面屬性中不顯示？
請首先檢查你的自定義頁面模板檔案是否位於主題的根目錄下，並且檔案頂部的註釋塊格式必須完全正確，特別是“Template Name:”這一行。檔名和路徑錯誤，或註釋格式有誤，都會導致WordPress無法識別該模板。
開發完成的主題如何釋出或分享給他人使用？
最規範的方式是將你的主題資料夾打包成ZIP檔案。使用者可以在WordPress後臺的“外觀”->“主題”->“新增新主題”->“上傳主題”中直接上傳並安裝此ZIP包。如果你希望釋出到WordPress官方主題目錄，則需要遵循更嚴格的程式碼標準和審查流程，包括安全性、程式碼質量、國際化支援等。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。