準備工作與環境搭建
在開始編寫代碼之前，建立一個高效且專業的本地開發環境至關重要。這不僅能讓你在不影響線上網站的情況下進行測試，還能極大地提升開發效率。
配置本地开发环境
我們推薦使用本地服務器軟件包，例如 Local by Flywheel、MAMP 或 XAMPP。這些工具可以一鍵在你的電腦上安裝 Apache/Nginx、PHP 和 MySQL，完美模擬線上服務器環境。安裝完成後，創建一個新的 WordPress 站點，並確保你的 PHP 版本符合 WordPress 的最新要求。
創建主題的基礎目錄與文件
一个 WordPress 主题本质上是一个位于服务器上的文件夹，包含用于设计和布局网站的各种文件和资源。这些文件和资源包括 HTML 模板、样式表、图像、脚本等。 /wp-content/themes/ 目錄下的文件夾。首先，為你的主題創建一個具有唯一性的文件夾，例如 my-custom-theme。在該文件夾內，你必須創建兩個核心文件：style.css 以及 index.php。
推荐阅读 WordPress 主题开发：从零到精通的完整指南与实践教程。
style.css 不僅僅是樣式表，它更是一個主題的“身份證”，其頂部的註釋塊用於向 WordPress 聲明主題信息。一個基本的樣式表頭部如下所示：
/*
Theme Name: My Custom Theme
Theme URI: https://example.com/my-custom-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
*/index.php 是主題的默認模板文件，即使其他模板文件缺失，它也必須存在。此時，你可以先在其中寫入簡單的 HTML 結構來測試。
构建主题的核心模板文件
WordPress 使用模板層級系統來決定如何顯示不同類型的內容。理解並創建這些核心模板文件是主題開發的基礎。
創建網站頭部與底部模板
為了實現代碼複用，我們需要將網頁的頭部（Header）和底部（Footer）分離成獨立文件。創建 header.php 文件，它應包含從 開始到打開 標籤之前的所有代碼，關鍵是要包含 wp_head() 函数调用。
<!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-hk/</?php echo esc_url( home_url( '/' ) ); ?>"></a></h1>
</header>同樣，創建 footer.php 文件，它應包含頁腳內容，並以調用 wp_footer() 函數和結束標籤收尾。然後，在 index.php 在中文里，我们通常会用“使用”来表达这个意思。 get_header() 以及 get_footer() 可以通过函数来引入这些功能。
推荐阅读 全面解析WordPress主题开发：从入门到精通的实践指南。
設計文章循環與頁面內容
文章循環是 WordPress 用來從數據庫中獲取並顯示文章的核心機制。在 index.php 的主體部分，你需要使用標準的循環結構。
<article>
<h2></h2>
<div></div>
</article>
<?php endwhile;
else :
echo '<p>暂无文章。</p>';
endif;
?>接下來，為單個文章頁面創建模板 single.php，為靜態頁面創建 page.php。你還可以創建 front-page.php 作為自定義首頁，或 archive.php 來顯示分類、標籤等歸檔列表。
添加功能與樣式
一個完整的主題不僅需要結構，還需要交互功能和視覺設計。這通過功能文件和樣式表來實現。
引入主題功能支持
创建 functions.php 文件。這個文件用於擴展主題功能，它不是必須的，但極其重要。在這裏，你可以註冊菜單、啓用特色圖像、添加主題支持等。
<?php
function my_theme_setup() {
// 让 WordPress 管理标题标签
add_theme_support( 'title-tag' );
// 启用文章和页面的特色图像
add_theme_support( 'post-thumbnails' );
// 注册一个导航菜单位置
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-custom-theme' ),
) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );
// 引入样式表和脚本
function my_theme_scripts() {
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri() );
wp_enqueue_script( 'my-theme-script', get_template_directory_uri() . '/js/script.js', array(), false, true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );
?>編寫響應式樣式表
关于 style.css 的聲明信息下方，開始編寫你的 CSS。現代主題必須是響應式的。建議使用移動優先的原則，並利用 CSS 媒體查詢來適配更大屏幕。
/* 基础样式 - 移动设备 */
body { font-family: sans-serif; margin: 0; }
.container { width: 100%; padding: 1rem; }
/* 平板设备及以上 */
@media (min-width: 768px) {
.container { max-width: 720px; margin: 0 auto; }
}
/* 桌面设备 */
@media (min-width: 992px) {
.container { max-width: 960px; }
}你可以創建額外的 CSS 文件並通過 functions.php 请将下面的英文句子翻译成中文，并详细解释：\n中的 wp_enqueue_style() 引入，以保持代碼組織有序。
推荐阅读 深入解析WordPress主题开发：从入门到精通的完整实践指南。
進階主題開發技巧
當掌握了基礎之後，以下技巧能讓你的主題更專業、更強大。
創建自定義文章類型與側邊欄
對於作品集、產品等非標準內容，你可以通過 functions.php 请将下面的英文句子翻译成中文，并详细解释：\n中的 register_post_type() 函數創建自定義文章類型。同時，使用 register_sidebar() 函數來創建小工具區域（側邊欄），並在模板中使用 dynamic_sidebar() 函數調用它。
實現子主題與主題國際化
為了確保主題更新時你的修改不會丟失，強烈建議為你的個性化主題創建一個“子主題”。子主題只需要一個 style.css 和一个人在一起 functions.php，它繼承父主題的所有功能，並允許你安全地覆蓋樣式和功能。
此外，為了讓主題能被全球用户使用，需要進行國際化準備。這意味着在代碼中所有需要翻譯的文本處，使用 __() 或者 _e() 等翻譯函數進行包裹，並設置好 Text Domain。然後，可以使用 Poedit 等工具生成 .pot 翻譯模板文件。
总结
從零開始打造一個 WordPress 主題是一個系統性的學習過程，涵蓋了從環境搭建、PHP 模板語法、核心文件結構到功能擴展和樣式設計的完整路徑。關鍵在於動手實踐：從創建最簡單的 style.css 以及 index.php 開始，逐步添加頭部、底部、循環，再到通過 functions.php 增強功能。理解模板層級和鈎子函數是進階的核心。最終，通過創建子主題和進行國際化準備，你的作品將具備專業級的可維護性和可擴展性。記住，最好的學習方式就是不斷地編碼、測試和迭代。
常见问题解答（FAQ）
### 開發 WordPress 主題必須精通 PHP 嗎？
是的，具備紮實的 PHP 基礎是必要的，因為 WordPress 核心及其模板系統主要由 PHP 驅動。你需要理解 PHP 語法、函數、循環以及如何與 WordPress 的 API（如鈎子、函數）交互。同時，對 HTML、CSS 和基礎 JavaScript 的掌握也至關重要。
為什麼我的主題在後台不顯示？
這通常是由於 style.css 文件頂部的主題信息註釋塊格式不正確或缺失造成的。請嚴格按照格式填寫 Theme Name、Author 等信息，並確保該文件位於你主題文件夾的根目錄下。此外，檢查主題文件夾是否被正確放置在 /wp-content/themes/ 路徑中。
get_template_part() 函數有什麼用處？
get_template_part() 函數是組織主題代碼的最佳實踐之一。它用於從其他文件（如 content.php, sidebar.php）中加載代碼片段，從而避免在多個模板文件中重複相同的 HTML 結構。這極大地提高了代碼的可複用性和可維護性。
如何讓我的主題支持古騰堡編輯器？
為了讓主題更好地兼容古騰堡編輯器，你需要在 functions.php 中添加相關主題支持。例如，使用 add_theme_support(‘editor-styles’) 來加載編輯器的樣式；使用 add_theme_support(‘wp-block-styles’) 來支持前端塊樣式；還可以使用 add_theme_support(‘responsive-embeds’) 使嵌入內容具有響應性。為常用的塊（如分組塊、封面塊）編寫前端樣式也很重要。
接下来，我该怎么做呢？
延伸阅读与实用知识
下方这些内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始看起，然后再逐步扩展到相关主题，这样通常效果会更好。