WordPress主題是網站外觀和功能的核心。透過自定義開發，開發者可以完全掌控網站的設計邏輯、效能表現與功能擴充套件，告別對第三方主題的限制。本指南將引導你從最基礎的目錄結構開始，逐步構建一個功能完整、符合現代開發標準的WordPress自定義主題。你將掌握主題架構的核心思想、模板檔案的組織邏輯，並學會如何透過PHP函式和鉤子注入動態內容。
主題開發的基礎與環境準備
在開始編寫程式碼之前，建立一個正確的開發環境和了解主題的基礎結構至關重要。這能確保你的開發工作高效且符合WordPress生態的規範。
搭建本地开发环境
我們推薦使用本地開發環境，如Local、XAMPP或MAMP。這些工具能一鍵安裝PHP、MySQL和Apache/Nginx。在環境中建立一個新的WordPress安裝，作為你主題的測試平臺。
推荐阅读 WordPress 主題開發指南：從零到一建構專業主題。
理解主題的標準目錄結構
一個最簡化的、可被WordPress識別的主題只需要兩個檔案：style.css 以及 index.php。然而，一個結構良好的自定義主題目錄應合理組織各類檔案。一個典型的主題目錄結構如下：
your-theme/
├── style.css (必需，主题样式表和信息头)
├── index.php (必需，主模板文件)
├── functions.php (主题功能增强文件)
├── header.php (头部模板)
├── footer.php (底部模板)
├── sidebar.php (侧边栏模板)
└── assets/ (静态资源目录)
├── css/
├── js/
└── images/建立核心樣式表文件
style.css 檔案不僅是樣式檔案，更是主題的“身份證”。其檔案頂部的註釋塊包含了WordPress識別主題所需的所有元資訊。
/*
Theme Name: 我的自定义主题
Theme URI: https://example.com/my-custom-theme
Author: 你的名字
Author URI: https://example.com
Description: 一个从零开始开发的自定义WordPress主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/其中,Text Domain 用於國際化，是後續呼叫翻譯函式時必須用到的識別符號。
構建核心模板檔案體系
WordPress採用模板層級系統來決定不同頁面型別使用哪個模板檔案。構建這些檔案是主題開發的核心工作。
建立基礎模板檔案
首先，建立拆分的頭部和底部模板。檔案 header.php 應包含HTML文件頭、區域以及頁面主體的開始部分，通常使用 wp_head() 函式來讓外掛和核心功能注入程式碼。
推荐阅读 WordPress主題開發從入門到精通：構建自定義網站的全方位指南。
<!DOCTYPE html>
<html no numeric noise key 1006>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
</head>
<body no numeric noise key 1003>
<header>
<h1><a href="/zh-tw/</?php echo esc_url( home_url( '/' ) ); ?>"></a></h1>
</header>檔案 footer.php 則包含頁尾內容，並以 wp_footer() 函式結束。
<footer>
<p>©</p>
</footer>
</body>
</html>實現主模板檔案
index.php 作為最終的模板回退檔案，其基本職責是引入頭部和底部，並構建主迴圈以顯示文章列表。
<main>
<article>
<h2><a href="/zh-tw/</?php the_permalink(); ?>"></a></h2>
<div></div>
</article>
<p>暂无文章。</p>
</main>開發專用頁面模板
根據模板層級，你可以為特定頁面建立更具體的模板。例如，建立 single.php 用于展示单篇文章。page.php 用于显示独立页面的。archive.php 用於顯示分類歸檔。WordPress會自動優先呼叫這些更具體的模板。
透過函式檔案增強主題功能
functions.php 檔案是你的主題“控制中心”，用於新增功能、註冊選單、支援特色影象等，無需修改核心檔案。
新增主題基礎支援
关于 functions.php 在中文中，我们可以用“使用”来表达“use”的意思。比如：“我使用了这个工具。”或者“他使用了那个方法。” add_theme_support() 函式來宣告主題支援的功能。這是一個標準的起點。
function my_custom_theme_setup() {
// 让WordPress管理文档标题
add_theme_support( 'title-tag' );
// 启用文章和页面的特色图像功能
add_theme_support( 'post-thumbnails' );
// 注册导航菜单位置
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-custom-theme' ),
) );
// 支持HTML5标记
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption', 'style', 'script' ) );
}
add_action( 'after_setup_theme', 'my_custom_theme_setup' );註冊側邊欄小工具區域
使用
（注：此处"使用"指的是某种产品或服务的使用情况） register_sidebar() 函式來定義小工具區域，允許使用者在後臺動態新增內容。
推荐阅读 入门级 WordPress 主题开发指南 —— 从零开始搭建你的首个自定义主题。
function my_custom_theme_widgets_init() {
register_sidebar( array(
'name' => __( '主侧边栏', 'my-custom-theme' ),
'id' => 'sidebar-1',
'description' => __( '在此添加小工具。', 'my-custom-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_custom_theme_widgets_init' );安全地引入指令碼與樣式
永遠不要直接在模板中硬連結CSS和JS檔案。應使用 wp_enqueue_style() 以及 wp_enqueue_script() 创建一个函数，并将其挂载到 wp_enqueue_scripts 鉤子上。
function my_custom_theme_scripts() {
// 引入主题主样式表
wp_enqueue_style( 'my-custom-theme-style', get_stylesheet_uri(), array(), wp_get_theme()->get( 'Version' ) );
// 引入自定义JavaScript文件
wp_enqueue_script( 'my-custom-theme-script', get_template_directory_uri() . '/assets/js/main.js', array(), '1.0.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_custom_theme_scripts' );實現模板標籤與迴圈
模板標籤是WordPress提供的一系列PHP函式，用於在模板中動態輸出內容，如文章標題、內容、日期等。它們通常在主迴圈內部使用。
理解並運用主迴圈
主迴圈是WordPress模板中最核心的概念，它使用全域性變數 $wp_query 來遍歷當前頁面需要顯示的文章。基本結構如下：
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<!-- 在这里使用模板标签 -->
<?php endwhile; else : ?>
<!-- 没有找到文章时的内容 -->
<?php endif; ?>在呼叫 the_post() 後，全域性的“文章資料”就被設定好了，隨後可以使用各種模板標籤。
使用常用模板標籤輸出內容
在迴圈內部，你可以呼叫一系列函式來輸出文章資訊。例如：
- the_title()：輸出文章標題。
- the_permalink()：輸出文章永久連結。
- the_content()：輸出文章完整內容。
- the_excerpt()：輸出文章摘要。
- the_post_thumbnail()：輸出文章特色影象。
- the_date() 以及 the_author()：輸出日期和作者。
實現文章分頁導航
在文章列表（如首頁、歸檔頁）的迴圈結束後，需要提供分頁導航。可以使用 the_posts_pagination() 函式來輸出一個美觀且可訪問的分頁連結列表。
the_posts_pagination( array(
'mid_size' => 2,
'prev_text' => __( '上一页', 'my-custom-theme' ),
'next_text' => __( '下一页', 'my-custom-theme' ),
) );总结
從建立包含正確資訊頭的 style.css 和基礎的 index.php 開始，你已經走過了構建一個自定義WordPress主題的核心路徑。我們深入探討了模板層級系統，拆分了 header.php 以及 footer.php 以提升程式碼複用性，並透過 functions.php 檔案穩健地添加了主題功能與資源。理解並正確使用“主迴圈”和“模板標籤”是將動態內容呈現在頁面上的關鍵。遵循這些步驟和最佳實踐，你不僅建立了一個可工作的主題，更建立了一個易於維護、擴充套件和符合WordPress標準的專案基礎。
常见问题解答（FAQ）
开发WordPress主题必须掌握PHP吗？
是的，PHP是必須掌握的。WordPress核心本身由PHP編寫，所有模板檔案、功能邏輯和與資料庫的互動都依賴於PHP。HTML、CSS和JavaScript用於構建前端表現和互動，但PHP是將動態資料注入前端的基礎。
為什麼我的主題在後臺不顯示或無法啟用？
最常見的原因是 style.css 檔案頂部的主題資訊頭註釋格式不正確、缺少必要資訊，或者檔案編碼有問題。請嚴格按照規範填寫資訊頭，並確保檔案編碼為UTF-8 without BOM。其次，檢查主題資料夾是否被正確放置在/wp-content/themes/请看下方目录。
functions.php檔案和外掛有什麼區別？
functions.php 檔案中的功能與當前主題深度繫結，當切換主題時，這些功能將失效。它適合新增與主題外觀、佈局緊密相關的功能（如註冊選單、定義小工具區域、新增主題支援選項）。而外掛提供的功能通常獨立於主題，切換主題後依然可用，適合新增通用性功能（如聯絡表單、SEO最佳化、快取）。
怎样让我的主题支持多语言（国际化）？
你需要使用WordPress的國際化函式來包裝所有面向用戶的文字。在程式碼中，使用 () 或者 _e() 等函式，並指定在 style.css 请将以下中文简体句子翻译成中文简体，并详细解释其含义：
\n中定義的 Text Domain例如：echo ( ‘阅读更多’, ‘my-custom-theme’ );。然後，使用如Poedit這樣的工具生成.pot翻譯模板檔案，供翻譯者建立.po以及.mo語言檔案。
開發時應該直接修改核心模板檔案嗎？
絕對不要直接修改WordPress核心檔案，也不應直接修改你正在使用的其他父主題的核心檔案（除非你建立的是子主題）。任何修改都會在下次更新時被覆蓋。自定義開發應始終在你自己的獨立主題或子主題中進行，這是WordPress開發的基本原則。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。