搭建 WordPress 主题开发环境
要開始開發WordPress主題，首先需要一個穩定高效的本地開發環境。這能讓你在不影響線上網站的情況下進行編碼、測試和除錯。主流的選擇包括使用XAMPP、MAMP、Local by Flywheel或Docker等工具。這些工具會一鍵安裝PHP、MySQL和Web伺服器（如Apache或Nginx），為你構建一個與真實線上伺服器環境高度一致的沙箱。
接下來，你需要在本地環境中安裝一個全新的WordPress。從官方網站下載最新的WordPress安裝包，將其解壓到本地伺服器的網站根目錄（例如XAMPP的htdocs資料夾）。然後透過瀏覽器訪問本地地址，按照指引完成資料庫配置和管理員賬戶建立。一個純淨的WordPress安裝是理想的學習和開發起點。
最後，你需要準備合適的程式碼編輯器。Visual Studio Code、PhpStorm或Sublime Text都是流行的選擇，它們提供語法高亮、程式碼自動補全和除錯功能，能極大提升開發效率。建議安裝一些針對WordPress開發的擴充套件外掛，例如PHP Intelephense或WordPress相關的程式碼片段庫。
推荐阅读 零到一：WordPress主题开发的完整指南及最佳实践。
主題基礎結構與核心檔案
一個最簡化的WordPress主題至少需要兩個檔案：樣式表style.css和主模板檔案index.php。style.css的作用不僅僅是定義樣式，其檔案頭部的註釋塊更是主題的“身份證”，用於向WordPress系統宣告主題的元資訊。
下面是一個style.css檔案頭部的示例：
/*
Theme Name: 我的第一个主题
Theme URI: https://example.com/my-first-theme
Author: 你的名字
Author URI: https://example.com
Description: 这是一个用于学习的自定义WordPress主题。
Version: 1.0
License: GPL v2 or later
Text Domain: my-first-theme
*/Text Domain用於國際化（i18n），是後續載入翻譯文字域的關鍵標識。而index.php是主題的預設模板，當沒有其他更具體的模板可用時，WordPress就會使用它來渲染頁面。
隨著主題功能複雜化，你需要遵循WordPress模板層級結構來建立更多模板檔案。例如，header.php用於存放網站頭部（如DOCTYPE、<head>標籤和導航選單），footer.php用於存放網站底部，sidebar.php用於側邊欄。在index.php在中，您可以使用get_header()、get_footer()以及get_sidebar()這些模板函式來引入這些部分，實現程式碼複用。
另一個至關重要的檔案是functions.php。它不是用來直接輸出內容的，而是作為主題的功能增強檔案。你可以在這裡新增主題支援功能、註冊選單和側邊欄小工具區域、引入CSS和JavaScript檔案，以及定義各種自定義函式。它是主題的“大腦”，控制著主題的行為和功能擴充套件。
推荐阅读 入门级WordPress主题开发：从零开始构建你的首款网站皮肤。
模板標籤與迴圈機制
WordPress的核心魅力在於其動態內容生成能力，而這主要透過“模板標籤”和“主迴圈”實現。模板標籤是WordPress提供的PHP函式，用於在模板檔案中輸出動態內容，例如部落格標題、文章內容、釋出時間等。
最核心的概念是“The Loop”（主迴圈）。這是一段標準的PHP程式碼結構，用於檢查當前頁面是否有“文章”（泛指任何文章型別，如部落格文章、頁面等）需要顯示，如果有，則迴圈輸出每一篇。以下是index.php中一個典型迴圈的示例：
<article>
<h2><a href="/zh-tw/</?php the_permalink(); ?>"></a></h2>
<div class="entry-meta">
发布于：<?php the_date(); ?> | 作者：<?php the_author(); ?>
</div>
<div class="entry-content">
</div>
</article>
<p>抱歉，没有找到任何文章。</p>在这个循环中，have_posts()以及the_post()函式控制迴圈的程序。the_title()、the_permalink()、the_excerpt()等模板標籤則在迴圈體內輸出每篇文章的具體資訊。理解並熟練運用迴圈是開發任何內容型模板的基礎。
除了文章列表，你還需要處理單篇文章和獨立頁面。這時就需要建立single.php（用於單篇文章）和page.php（用於獨立頁面）。在這些模板中，你通常會使用the_content()來輸出完整的文章內容，並可能新增評論模板（透過comments_template()呼叫comments.php）。
為主題新增高階功能
當基礎佈局和內容展示完成後，你可以透過functions.php為主題注入更強大的功能。首先是為主題新增對WordPress核心功能的支援，這透過add_theme_support()函数实现。
例如，啟用文章縮圖（特色影象）功能是現代主題的標配：
推荐阅读 《WordPress主题开发完全指南：从入门到精通的实战教程》。
add_action( 'after_setup_theme', 'mytheme_setup' );
function mytheme_setup() {
add_theme_support( 'post-thumbnails' );
// 还可以添加其他支持，如自定义Logo、文章格式等
add_theme_support( 'custom-logo' );
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption' ) );
}註冊導航選單位置讓使用者可以在後臺“外觀”->“選單”中管理選單。你需要在functions.php中宣告選單位置，然後在模板檔案（通常是header.php）中呼叫它。
// 在 functions.php 中注册菜单
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-first-theme' ),
'footer' => __( '页脚菜单', 'my-first-theme' ),
) );
// 在 header.php 中显示主导航菜单
wp_nav_menu( array(
'theme_location' => 'primary',
'menu_class' => 'primary-menu',
) );引入樣式表和指令碼檔案必須遵循WordPress的規範，使用wp_enqueue_style()以及wp_enqueue_script()函式，並將這些操作掛載到wp_enqueue_scripts這個鉤子上。這確保了依賴關係被正確處理，並避免重複載入。
add_action( 'wp_enqueue_scripts', 'mytheme_scripts' );
function mytheme_scripts() {
// 引入主样式表
wp_enqueue_style( 'mytheme-style', get_stylesheet_uri() );
// 引入自定义JavaScript文件
wp_enqueue_script( 'mytheme-script', get_template_directory_uri() . '/js/main.js', array(), '1.0', true );
}最後，你還可以透過建立sidebar.php並註冊側邊欄小工具區域，讓使用者能夠自由地通過後臺“小工具”介面拖拽元件來定製側邊欄內容，這極大地增強了主題的靈活性。
总结
WordPress主題開發是一個將創意、設計和技術融合的過程。從搭建本地環境開始，你逐步構建了包含核心檔案（style.css, index.php, functions.php）的主題框架。透過理解和運用模板層級結構與主迴圈，你實現了動態內容的精準輸出。最後，透過functions.php整合選單、小工具、特色影象等高階功能，你將一個靜態的HTML模板轉化為一個功能完整、使用者友好的動態WordPress主題。持續學習模板標籤、鉤子（Hooks）和最佳實踐，你將能夠創建出更強大、更專業的主題。
常见问题解答（FAQ）
### 開發主題必須掌握PHP嗎？
是的，PHP是WordPress的伺服器端程式語言，主題的模板檔案（.php）主要使用PHP混合HTML來編寫。你需要掌握PHP基礎語法、函式使用以及WordPress特有的模板標籤和函式。HTML和CSS則是前端表現層的基礎，三者缺一不可。
怎样让我的主题支持多语言？
為了讓主題支援多語言（國際化），你需要在style.css正确设置头部信息Text Domain并在functions.php中呼叫load_theme_textdomain()函式來載入翻譯檔案。在模板檔案中，所有需要翻譯的文字都必須使用WordPress的翻譯函式進行包裝，例如__( '文本', 'my-theme-textdomain' )或者_e( '文本', 'my-theme-textdomain' )。
主题和插件有什么区别？
主題（Theme）主要控制網站的外觀和展示層，包括佈局、樣式、模板結構等。外掛（Plugin）則用於為網站新增特定的功能，這種功能應獨立於主題設計，例如聯絡表單、SEO最佳化、快取等。一個良好的實踐是：與視覺呈現緊密相關的程式碼放在主題裡，而獨立的功能性程式碼應制作成外掛，這樣即使在切換主題後，核心功能依然存在。
如何除錯開發過程中出現的錯誤？
推薦開啟WordPress的除錯模式。你可以在網站的wp-config.php文件中，将WP_DEBUG常量的值設定為true。這樣，PHP錯誤、警告和通知將直接顯示在頁面上。同時，結合瀏覽器的開發者工具（Console, Network, Elements面板）進行前端除錯，可以快速定位和解決CSS、JavaScript以及網路請求相關問題。在開發完成後，務必記得關閉除錯模式。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。