開發環境與基礎準備
在開始撰寫具體的主題程式碼之前，正確的開發環境是成功的基石。這絕非僅僅安裝一個程式碼編輯器那麼簡單，而是一個旨在提升效率、保障程式碼品質與簡化除錯的完整工作流程。
首先，我們強烈建議在本機電腦上建置一個與正式環境相似的開發環境。這通常意味著使用諸如 Local by Flywheel、XAMPP、MAMP 或 Laragon 這類工具來安裝 Apache/Nginx、PHP 和 MySQL。本機開發可以讓你快速迭代，無須等待檔案上傳，並能安全地測試新功能。
其次，一個強大的程式碼編輯器是不可或缺的。Visual Studio Code 因其豐富的擴充套件生態系統（如 PHP Intelephense、WordPress Snippet 等）而廣受開發者歡迎。版本控制工具，特別是 Git，必須從一開始就整合到你的工作流程中。使用 Git 來追蹤所有程式碼變更，並透過 GitHub、GitLab 或 Bitbucket 等平台進行備份與協作。
推荐阅读 WordPress主題開發從入門到精通：手把手教你構建自定義網站。
一個標準 WordPress 佈景主題的基礎檔案結構看起來如下。你需要在 WordPress 安裝目錄的 wp-content/themes 下建立一個新的資料夾，例如 my-custom-theme。
my-custom-theme/
├── style.css // 主样式表，包含主题元信息
├── index.php // 主题的默认模板文件
├── functions.php // 主题功能文件，用于添加功能与集成
├── screenshot.png // 主题后台预览图
├── assets/ // 静态资源目录
│ ├── css/
│ ├── js/
│ └── images/
└── template-parts/ // 模板零件目录其中,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: A custom WordPress theme built from scratch.
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/Text Domain 用於國際化，務必與你的主題資料夾名稱保持一致。
核心範本檔案與層級結構
WordPress 採用「範本階層」系統來決定為目前請求的頁面使用哪個範本檔案。理解這個階層是建構靈活主題的關鍵。從本質上說，WordPress 會從最具體的範本檔案開始尋找，如果沒有，則回退到更通用的檔案，最終回退到 index.php。
整個流程可以概括為：單篇文章頁面 > 單一頁面 > 分類彙整頁面 > 標籤頁面 > 作者頁面 > 日期頁面 > 彙整頁面 > 搜尋頁面 > 首頁 > 最終回退。對於文章單頁，WordPress 會優先尋找 single-post-{slug}.php，其次是 single-{post-type}.php，然後是 single.php最后才是 singular.php。
推荐阅读 WordPress主题开发完全指南：从零开始搭建自定义网站。
建構頁面通用範本
header.php 以及 footer.php 是構成網站統一外觀的基石。header.php 檔案通常包含文件型別宣告、 區域（透過 wp_head() 函式輸出關鍵中繼資料與腳本）以及網站標題、導覽等開頭內容。在需要引入頁首的地方，使用 get_header() 函数。
footer.php 則包含頁尾內容，並在結束前呼叫 wp_footer() 函式（這對於許多外掛正確執行至關重要），最後使用 get_footer() 函数引入。
控制文章迴圈與內容顯示
絕大多數模板檔案的核心是“迴圈”（The Loop）。這是 WordPress 用來從資料庫中檢索內容並顯示在頁面上的 PHP 程式碼結構。其基本模式如下：
<!-- 在这里显示每一篇文章的内容 -->
<h2></h2>
<div></div>
<p>抱歉，没有找到任何内容。</p>在迴圈內部，你可以使用一系列模板標籤來輸出內容，例如 the_title()、the_content()、the_excerpt()、the_permalink() 等。為了提升程式碼重用性，可以將迴圈中重複使用的部分（如文章摘要、文章中繼資訊）提取到 template-parts 目錄下的零件範本中，然後使用 get_template_part() 函数调用。
主題功能與自訂整合
functions.php 檔案是你的佈景主題的「控制中心」。它不是一個樣板檔案，而是一個在佈景主題初始化時自動載入的 PHP 檔案，用於定義函式、註冊功能、新增篩選器與動作鉤點。
新增主題基礎支援功能
首先，你應該使用 add_theme_support() 函式來宣告佈景主題支援的功能。這會為你的佈景主題啟用 WordPress 核心功能。
推荐阅读 從零開始掌握 WordPress主題開發：構建自定義網站的最佳實踐與指南。
function my_theme_setup() {
// 让主题支持文章和页面的特色图像
add_theme_support( 'post-thumbnails' );
// 支持在后台自定义<title>标签
add_theme_support( 'title-tag' );
// 支持HTML5的标记格式
add_theme_support( 'html5', array( 'search-form', 'comment-form', 'comment-list', 'gallery', 'caption' ) );
// 支持自定义Logo
add_theme_support( 'custom-logo', array(
'height' => 100,
'width' => 400,
'flex-height' => true,
'flex-width' => true,
) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );註冊導航選單與側邊欄
導覽選單允許使用者在後台「外觀 > 選單」中管理。你需要先使用 register_nav_menus() 函式註冊選單位置，然後在範本中使用 wp_nav_menu() 函式來顯示。
function my_theme_menus() {
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-custom-theme' ),
'footer' => __( '页脚菜单', 'my-custom-theme' ),
) );
}
add_action( 'after_setup_theme', 'my_theme_menus' );小工具側邊欄（或稱「視窗小工具區域」）是另一個重要功能。使用 register_sidebar() 进行函数注册。
function my_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_theme_widgets_init' );模板中使用了以下内容： dynamic_sidebar( 'sidebar-1' ) 來呼叫。
安全地引入指令碼與樣式
永遠不要直接在模板檔案中硬連結 CSS 和 JavaScript 檔案。正確的做法是透過 wp_enqueue_scripts 動作鉤子，使用 wp_enqueue_style() 以及 wp_enqueue_script() 函式來載入。
function my_theme_scripts() {
// 引入主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri(), array(), wp_get_theme()->get('Version') );
// 引入自定义JavaScript文件
wp_enqueue_script( 'my-theme-script', get_template_directory_uri() . '/assets/js/main.js', array('jquery'), wp_get_theme()->get('Version'), true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );高階主題特性與自定義
當基礎主題構建完成後，你可以透過更高階的技術來提升其專業性和靈活性。
建立自定義文章型別與分類法
為了管理部落格文章和頁面之外的內容（如產品、作品集、團隊成員等），你需要建立自定義文章型別。同樣，可以使用自定義分類法來組織這些內容。這通常在 functions.php 通过中介机构 register_post_type() 以及 register_taxonomy() 函式完成。為了保持程式碼整潔，建議將這部分邏輯放在一個獨立的檔案中，並透過 require_once 引入。
整合 WordPress 自訂器
WordPress 自訂器（Customizer）為使用者提供了即時預覽的佈景主題選項設定介面。你可以透過 WP_Customize_Manager 物件為其新增設定、控制和板塊。例如，新增一個站點標題顏色的選項：
function my_theme_customize_register( $wp_customize ) {
// 添加一个设置
$wp_customize->add_setting( 'header_color', array(
'default' => '#333333',
'transport' => 'refresh',
'sanitize_callback' => 'sanitize_hex_color',
) );
// 添加一个控制
$wp_customize->add_control( new WP_Customize_Color_Control( $wp_customize, 'header_color', array(
'label' => __( '页眉背景色', 'my-custom-theme' ),
'section' => 'colors',
'settings' => 'header_color',
) ) );
}
add_action( 'customize_register', 'my_theme_customize_register' );然後，在 header.php 或內嵌樣式中使用 get_theme_mod( 'header_color' ) 来输出这个值。
支援子主題
為了讓你的佈景主題易於擴充且更新安全，從一開始就考慮子佈景主題的相容性至關重要。這意味著所有樣式和腳本的載入都應使用 get_template_directory_uri() 以及 get_stylesheet_directory_uri() 等函式，並且在 style.css 中避免使用絕對路徑。子主題開發者可以透過覆蓋你的模板檔案來定製外觀。
总结
WordPress 主題開發是一個將創意、設計與程式設計技術相結合的過程。從搭建本地環境、理解模板層級，到構建核心模板檔案、在 functions.php 中整合強大功能，再到實現自訂文章類型和自訂器等高階特性，每一步都旨在建立一個既符合標準又獨具特色的網站解決方案。遵循最佳實踐，如使用動作鉤點、編寫可重複使用的程式碼和確保子主題相容性，將使你的主題更健壯、更專業，並能在 WordPress 生態系中長期保持活力。
常见问题解答（FAQ）
開發WordPress主題必須掌握哪些核心技術？
開發一個現代 WordPress 主題，你需要掌握的核心技術包括：HTML5 和語義化標記、CSS3（包括 Flexbox 和 Grid 佈局）、PHP（特別是面向物件程式設計基礎）、JavaScript（以及可能相關的框架如 React，用於古騰堡塊開發）。此外，深刻理解 WordPress 的核心概念，如模板層級、迴圈、動作鉤子與過濾器、以及 REST API，是必不可少的。
functions.php 和外掛有什麼區別？
functions.php 是主題的一部分，其功能與主題深度綁定。當使用者切換主題時，functions.php 中的程式碼將不再生效。它通常用於新增與主題外觀和功能直接相關的特性，如註冊選單、支援特色圖片、載入主題專屬樣式指令碼等。
外掛則是獨立於主題的功能模組，旨在提供可在不同主題間通用的功能。如果一個功能與主題的視覺表現無關，並且使用者可能希望在更換主題後保留該功能（如聯絡表單、SEO 最佳化、快取），那麼它更適合作為外掛來開發。最佳實務是保持主題專注於呈現，而將複雜功能交由外掛處理。
如何讓我的佈景主題符合 WordPress 編碼標準？
遵循 WordPress 編碼標準是保證程式碼品質、可讀性和社群協作性的關鍵。對於 PHP 程式碼，應遵循 WordPress PHP 編碼標準，這包括使用單引號、適當的縮排、大括號風格等。對於 CSS、JavaScript 和 HTML 也有相應的標準。
你可以使用諸如 PHP_CodeSniffer 搭配 WordPress 標準規則集、ESLint、Stylelint 等工具，在程式碼編輯器或 CI/CD 流程中自動檢查。同時，確保對所有使用者可見的文字使用翻譯函式（如 __()、_e()）並進行國際化處理。
主題開發完成後，如何進行測試？
全面的測試是釋出主題前的關鍵步驟。首先，在多種環境（不同 PHP 版本、不同 MySQL 版本）下進行基礎功能測試。其次，使用 WordPress 官方主題檢查外掛（Theme Check）進行合規性掃描，確保沒有使用已棄用的函式或違反主題審查指南。
然後，進行跨瀏覽器和響應式測試，確保在主流瀏覽器（Chrome, Firefox, Safari, Edge）和不同裝置尺寸上顯示正常。還需要測試與流行外掛的相容性，並確保在開啟除錯模式（在 wp-config.php 设置中文环境 define('WP_DEBUG', true);）後沒有 PHP 警告、通知或錯誤。最後，進行效能測試，評估頁面載入速度。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。