開發環境與基礎準備
在開始編寫程式碼之前，一個穩定、高效的開發環境是成功的第一步。這不僅僅是安裝一個文字編輯器，更是為整個開發流程奠定基礎。
首先，你需要一個本地伺服器環境。推薦使用集成了 Apache、MySQL 和 PHP 的軟體包，如 XAMPP、MAMP 或 Laragon。它們能讓你在個人電腦上模擬出與線上伺服器幾乎一致的環境，方便進行除錯和測試。確保你的 PHP 版本不低於 7.4，MySQL 版本不低於 5.6，以相容最新的 WordPress 特性。
其次，程式碼編輯器或整合開發環境（IDE）的選擇至關重要。Visual Studio Code 因其豐富的外掛生態（如 PHP Intelephense、WordPress Snippet）而廣受開發者歡迎。PHPStorm 則是功能更強大的專業選擇，提供了對 WordPress 鉤子和函式的深度程式碼提示。
推荐阅读 零基础入门：打造一个搜索引擎友好的专业 WordPress 主题。
一個 WordPress 主題最基礎的檔案結構始於兩個檔案：style.css 以及 index.php。在主題根目錄下建立一個新資料夾，例如 “my-first-theme”。在該資料夾內，建立 style.css 檔案，並在檔案頭部新增主題資訊註釋。這些註釋是 WordPress 識別一個主題的關鍵。
/*
Theme Name: My First Theme
Theme URI: https://example.com/my-first-theme/
Author: Your Name
Author URI: https://example.com/
Description: 这是一个用于学习 WordPress 主题开发的入门主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-first-theme
*/同時，建立一個最基本的 index.php 檔案，暫時只需包含一個 HTML 骨架和一句簡單的輸出。
<!DOCTYPE html>
<html no numeric noise key 1004>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<title></title>
</head>
<body>
<h1>Hello, WordPress Theme Development!</h1>
</body>
</html>將整個主題資料夾複製到 WordPress 安裝目錄下的 wp-content/themes/ 中，然後進入 WordPress 後臺的“外觀”->“主題”頁面，你就能看到並激活你的第一個主題了。
核心模板文件与模板层级
WordPress 使用一套名為“模板層級”的規則來決定對於網站的不同頁面應該使用哪個模板檔案來渲染。理解這一機制是主題開發的核心。
理解模板層級機制
模板層級是一個從最具體到最通用的檔案查詢系統。當用戶訪問一個頁面時，WordPress 會根據頁面的型別（如文章單頁、文章歸檔頁、靜態頁面）和條件（如分類、標籤、作者），按照預設的優先順序去尋找對應的模板檔案。如果找到了最具體的檔案，就使用它；如果沒找到，則繼續尋找下一級更通用的檔案，直到最基礎的 index.php。例如，訪問一篇特定分類下的文章時，WordPress 會依次尋找：single-post-{slug}.php -> single-{post-type}.php -> single.php -> singular.php -> index.php。
推荐阅读 《WordPress主题开发完全指南：从入门到精通的全流程实战》。
建立主要頁面模板
根據模板層級，我們需要建立幾個最常用的核心模板檔案。首先是 header.php 以及 footer.php，它們用於存放網站的公共頭部和底部。在 index.php 中，我們可以使用 get_header() 以及 get_footer() 可以通过函数来引入这些组件。
index.php 是最終的備用模板，所有其他模板未找到時都會回退到這裡。它通常包含一個主迴圈，用於輸出文章列表。
single.php 用於顯示單篇文章。其核心是使用 WordPress 主迴圈來輸出文章的完整內容。
page.php 用於顯示靜態頁面。它與 single.php 結構類似，但通常不包含分類、標籤等元資訊。
archive.php 用於顯示各類歸檔頁面，如分類目錄、標籤頁、作者文章列表等。在這個模板中，你需要使用迴圈來輸出多篇文章的摘要或標題列表。
front-page.php 以及 home.php 容易混淆。當後臺“設定”->“閱讀”中指定了一個靜態首頁時，front-page.php 用於顯示你指定的那個靜態頁面，而 home.php 則用於顯示文章列表頁（部落格頁面）。如果沒有設定靜態首頁，home.php 將作為網站首頁。
推荐阅读 快速掌握 WordPress 主题开发：从入门到实战的完整指南。
主題功能與動態內容
一個優秀的主題不僅僅是靜態模板的堆砌，更需要透過 WordPress 提供的豐富函式和鉤子來引入動態內容和功能。
註冊選單與側邊欄
為了讓使用者能在後臺控制導航選單，你需要在主題的 functions.php 文件中使用了 register_nav_menus() 函式來註冊選單位置。例如，註冊一個“主導航”位置。
function my_first_theme_setup() {
register_nav_menus( array(
'primary' => __( 'Primary Menu', 'my-first-theme' ),
) );
}
add_action( 'after_setup_theme', 'my_first_theme_setup' );註冊後，使用者就可以在“外觀”->“選單”中分配選單到“主導航”位置。在模板檔案（如 header.php在该段落中，使用了 wp_nav_menu() 函式來呼叫這個選單。
側邊欄（或稱“小工具區域”）同樣需要在 functions.php 中註冊。使用 register_sidebar() 函式可以定義一個側邊欄區域。
function my_first_theme_widgets_init() {
register_sidebar( array(
'name' => __( 'Main Sidebar', 'my-first-theme' ),
'id' => 'sidebar-1',
'description' => __( 'Add widgets here.', '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' );在模板中（如 sidebar.php），使用 dynamic_sidebar( ‘sidebar-1’ ) 來輸出這個區域。
引入樣式與指令碼
正確地將 CSS 和 JavaScript 檔案加入佇列是 WordPress 主題開發的最佳實踐，這可以避免資源衝突和依賴問題。在 functions.php 在中文中，我们可以用“使用”来表达“use”的意思。比如：“我使用了这个工具。”或者“他使用了那个方法。” wp_enqueue_style() 以及 wp_enqueue_script() 创建一个函数，并将其挂载到 wp_enqueue_scripts 這個鉤子上。
function my_first_theme_scripts() {
// 引入主题主样式表
wp_enqueue_style( 'my-first-theme-style', get_stylesheet_uri() );
// 引入自定义 JavaScript 文件
wp_enqueue_script( 'my-first-theme-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '1.0.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_first_theme_scripts' );文章特色影象與縮圖
為了讓主題支援文章縮圖（特色影象），你需要在 functions.php 的主題支援函式中新增 add_theme_support( ‘post-thumbnails’ )。你還可以使用 set_post_thumbnail_size() 來設定預設的縮圖尺寸。在模板檔案中，使用 the_post_thumbnail() 函式來輸出特色影象。
進階功能與主題定製
當基礎功能完備後，你可以透過更高階的技術來提升主題的可定製性和健壯性。
實現主題定製器支援
WordPress 定製器允許使用者實時預覽並修改主題設定。你可以透過 wp_customize API 為主題新增各種設定選項，如修改 Logo、顏色、頁尾文字等。這涉及到在 functions.php 中新增一個自定義函式，並掛載到 customize_register 鉤子上，在其中使用 $wp_customize->add_setting() 以及 $wp_customize->add_control() 方法。
建立子主題進行修改
直接修改父主題（尤其是第三方主題）是不推薦的，因為更新會覆蓋你的修改。正確的方法是建立一個子主題。子主題只需要一個 style.css 檔案，並在檔案頭部的註釋中透過 Template: 欄位宣告其父主題的目錄名。子主題會繼承父主題的所有功能，你只需在子主題中建立同名檔案即可覆蓋父主題的模板檔案，或者在子主題的 functions.php 中新增新的函式來擴充套件功能。這是 WordPress 主題開發中維護和升級的黃金法則。
確保主題國際化
為了讓你的主題能被全世界的使用者使用，需要進行國際化（i18n）準備。這意味著所有在主題中輸出給使用者看的字串，都應該使用 WordPress 的翻譯函式進行包裝，最常用的是 __() 以及 _e()与此同时，我们将继续推动构建开放型世界经济，维护全球自由贸易体制，推动经济全球化朝着更加包容、普惠、平衡、共赢的方向发展。 style.css 以及 functions.php 正确设置中文环境变量 Text Domain。然後，你可以使用 Poedit 這類工具生成 .pot 模板檔案，翻譯人員可以據此建立不同語言的 .po 以及 .mo 文件。
总结
WordPress 主題開發是一個系統性的工程，從搭建本地環境、理解模板層級，到註冊核心功能、引入動態內容，再到實現定製化和國際化，每一步都環環相扣。遵循“從最具體到最通用”的模板層級規則，能讓你高效地組織模板檔案。堅持使用 WordPress 標準函式和鉤子（如 wp_enqueue_scripts、register_nav_menus）來新增功能，是保證主題相容性和可維護性的關鍵。最後，透過支援定製器和建立子主題，你的作品將不僅是一個功能性的主題，更是一個易於使用和長期維護的專業產品。掌握這些全流程，你便具備了從零開始構建一個完整、健壯的 WordPress 主題的能力。
常见问题解答（FAQ）
主題開發必須掌握 PHP 嗎？
是的，PHP 是 WordPress 的核心程式語言，主題的模板檔案、功能函式都基於 PHP。你需要掌握 PHP 的基礎語法，包括變數、陣列、條件判斷、迴圈和函式。對於更復雜的主題，面向物件程式設計（OOP）知識也會很有幫助。
如何除錯開發過程中出現的錯誤？
首先，確保在本地開發環境的 wp-config.php 檔案中開啟 WordPress 除錯模式，將 WP_DEBUG 常量被设置为 true。這會將所有 PHP 錯誤、警告和通知顯示在頁面上。其次，使用瀏覽器的開發者工具（按 F12）來檢查 CSS 和 JavaScript 錯誤。對於複雜的邏輯問題，可以使用 error_log() 函式將變數資訊列印到伺服器的錯誤日誌中進行分析。
我的主題如何提交到 WordPress 官方目錄？
提交主題到官方目錄需要滿足一系列嚴格的規範。你需要仔細閱讀官方的《主題審查手冊》，確保程式碼質量、安全性、可訪問性和相容性都達到標準。主題必須使用 GPL 相容許可證，並且不能捆綁任何非 GPL 相容的程式碼或資源。提交過程透過 WordPress 官方的提交系統進行，之後會有志願者審查員對你的主題進行稽核。
開發商業主題需要注意什麼？
開發商業主題除了要滿足所有技術規範外，還需要特別注意版權和許可問題。你使用的所有資源（如圖片、字型、第三方庫）都必須擁有合法的商業使用授權。程式碼質量要求更高，需要提供良好的文件和技術支援。同時，考慮使用加密或混淆工具來保護你的智慧財產權，並選擇一個可靠的平臺（如 ThemeForest）進行銷售和分發。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。