構建一個自訂嘅 WordPress 主題，即係話你可以完全掌控網站嘅外觀、功能同埋效能。同用預製主題唔同，自訂開發容許你構建一個獨特、高效而且同你個品牌完全夾嘅網站。呢個指南會帶你由基礎環境搭建到發佈一個功能完善嘅主題。
開發環境同基礎檔案結構
喺開始寫程式碼之前，建立一個合適嘅本地開發環境係好重要嘅。你可以用 XAMPP、MAMP，或者更加專業嘅 Valet 同埋 Local by Flywheel。確保你嘅環境支援 PHP 7.4 或者更高嘅版本，同埋 MySQL 或者 MariaDB 資料庫。
一個 WordPress 主題本質上係一個喺 wp-content/themes/ 檔案夾入面嘅目錄。呢個目錄必須至少包含兩個核心檔案：樣式表同埋索引模板。
推薦閱讀 WordPress主題開發入門指南：從零開始構建你嘅網站外觀。
首先，喺 wp-content/themes/ 下面創建一個新檔案夾，例如 my-custom-theme. 跟住，創建第一個必需檔案：style.css. 呢個檔案唔單止定義咗主題嘅樣式，檔案頭嘅註解仲包含咗主題嘅元數據。
/*
Theme Name: My Custom Theme
Theme URI: https://yourdomain.com/
Author: Your Name
Author URI: https://yourdomain.com/
Description: 一个从头开始构建的自定义 WordPress 主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/跟落嚟，創建第二個必需檔案：index.php. 呢個係主題嘅預設模板檔案，當 WordPress 搵唔到更特定嘅模板嗰陣，就會用佢。一個最簡單嘅 index.php 可以只包含一個循環，用於顯示文章列表。
<?php get_header(); ?>
<main>
<?php if ( have_posts() ) :
while ( have_posts() ) : the_post(); ?>
<article>
<h2><?php the_title(); ?></h2>
<div><?php the_content(); ?></div>
</article>
<?php endwhile;
endif; ?>
</main>理解模板層級
WordPress 使用模板層級來決定為特定頁面使用邊個模板檔案。例如，當訪問一篇單獨嘅文章時，WordPress 會優先搵 single.php，如果唔存在，就會退返去 singular.php，最後先係 index.php。理解呢個層級關係係高效開發主題嘅關鍵。你應該根據需求創建對應嘅模板檔案，例如 page.php（頁面）、archive.php（歸檔頁）同埋 single.php（單篇文章）。
核心模板檔案同主題功能
除咗 index.php 同埋 style.css,一個功能完整嘅主題仲需要其他幾個核心模板文件嚟分割頁面結構，實現代碼重用。
創建 header.php 檔案，佢通常包含文件類型聲明、<head> 區域同埋網站嘅頂部導航同標誌。使用 wp_head() 函數至關重要，佢允許 WordPress 核心、插件同你嘅主題喺呢度注入必要嘅代碼（例如樣式表連結、元標籤）。
推薦閱讀 從零到一精通 WordPress 主題開發：構建現代化網站實戰指南。
<!DOCTYPE html>
<html no numeric noise key 1005>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
<?php wp_head(); ?>
</head>
<body no numeric noise key 1002>
<header>
<h1><a href="/yue/</?php echo esc_url( home_url( '/' ) ); ?>"><?php bloginfo( 'name' ); ?></a></h1>
</header>創建 footer.php 文件，佢包含頁腳內容同埋關閉嘅 HTML 標籤。同樣，必須調用 wp_footer() 函數，用嚟載入腳本同插件需要嘅代碼。
functions.php 檔案係你主題嘅「控制中心」。佢唔係一個模板檔案，而係一個喺主題初始化時自動載入嘅 PHP 檔案。喺呢度，你可以註冊選單、側邊欄，加入主題支援嘅功能，同埋排入樣式表同腳本。
<?php
// 添加主题支持
function my_theme_setup() {
add_theme_support( 'title-tag' ); // 让 WordPress 管理标题标签
add_theme_support( 'post-thumbnails' ); // 启用文章缩略图功能
add_theme_support( 'html5', array( 'search-form', 'comment-form', 'comment-list', 'gallery', 'caption' ) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );
// 注册导航菜单
function my_theme_menus() {
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-custom-theme' ),
'footer' => __( '页脚菜单', 'my-custom-theme' ),
) );
}
add_action( 'init', 'my_theme_menus' );動態生成選單
在 header.php 喺度，你可以用 wp_nav_menu() 函數用嚟顯示你註冊嘅選單。呢個函數會輸出一個由 WordPress 後台「外觀 > 選單」中設定嘅、包含正確 CSS 類別同結構嘅無序列表。
<nav>
<?php
wp_nav_menu( array(
'theme_location' => 'primary',
'menu_class' => 'primary-menu',
'container' => false,
) );
?>
</nav>樣式、腳本與響應式設計
現代 WordPress 主題必須遵循最佳實踐來載入 CSS 同埋 JavaScript 檔案，確保網站喺所有裝置上都能夠正常顯示。
在 functions.php 入面，用 wp_enqueue_style() 同埋 wp_enqueue_script() 用函數嚟排入資源。咁樣可以確保正確嘅依賴管理同埋載入順序，仲畀插件同子主題有得覆蓋。
function my_theme_scripts() {
// 排入主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri(), array(), '1.0.0' );
// 排入自定义 JavaScript 文件
wp_enqueue_script( 'my-theme-script', get_template_directory_uri() . '/js/main.js', array( 'jquery' ), '1.0.0', true );
// 为脚本本地化数据（可选）
wp_localize_script( 'my-theme-script', 'myThemeData', array(
'ajax_url' => admin_url( 'admin-ajax.php' ),
) );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );響應式設計應該作為默認標準。喺你嘅 style.css 入面，用媒體查詢嚟調整唔同屏幕尺寸嘅版面。一個常見嘅模式係「移動優先」，即係先寫流動裝置嘅基礎樣式，然後再用 min-width 媒體查詢為更大嘅屏幕加入增強樣式。
推薦閱讀 手把手教你打造功能強大嘅自訂WordPress主題。
/* 基础移动样式 */
.container { width: 100%; padding: 0 15px; }
.menu { display: block; }
/* 平板电脑及以上 */
@media (min-width: 768px) {
.container { width: 750px; margin: 0 auto; }
.menu { display: flex; }
}
/* 桌面电脑 */
@media (min-width: 992px) {
.container { width: 970px; }
}使用 WordPress 內置嘅類別同函數
WordPress 提供咗好多有用嘅 CSS 類別同 PHP 函數嚟輔助樣式開發。body_class() 函數會輸出一系列基於當前頁面類型嘅 CSS 類別（例如 home, single-post, page-id-2），你可以喺 CSS 入面用呢啲 class 嚟寫針對性嘅樣式。post_class() 個 function 就會為每篇文章嘅容器元素輸出類似嘅 class。
進階功能同小工具整合
為咗令你個主題更加專業同易用，可以整合一啲進階功能，例如自訂文章類型、小工具區域（側邊欄）同自訂器設定。
小部件區域容許用戶透過 WordPress 後台嘅「外觀 > 小工具」拖拽模組嚟自訂內容。喺 functions.php 度登記一個側邊欄小部件區域。
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' => '<h3 class="widget-title">',
'after_title' => '</h3>',
) );
}
add_action( 'widgets_init', 'my_theme_widgets_init' );登記之後，你就可以喺模板檔案（例如 sidebar.php）用 dynamic_sidebar() 用函數嚟呼叫呢個區域。
WordPress 自訂器（Customizer）容許用戶即時預覽主題修改。你可以為你嘅主題加一啲簡單設定，例如網站 Logo 或者頁腳版權文字。呢樣嘢涉及使用 WP_Customize_Manager 類，喺 functions.php 入面加返相關嘅代碼。
function my_theme_customize_register( $wp_customize ) {
// 添加一个“版权信息”设置
$wp_customize->add_setting( 'footer_copyright', array(
'default' => '© 2026 Your Site Name',
'sanitize_callback' => 'sanitize_text_field',
) );
$wp_customize->add_control( 'footer_copyright', array(
'label' => __( '页脚版权文本', 'my-custom-theme' ),
'section' => 'title_tagline', // 放在“站点身份”区域
'type' => 'text',
) );
}
add_action( 'customize_register', 'my_theme_customize_register' );跟住，喺你嘅 footer.php 喺度，你可以用 get_theme_mod() 函數嚟輸出呢個設定嘅數值：<?php echo esc_html( get_theme_mod( 'footer_copyright' ) ); ?>。
摘要
WordPress 主題開發係一個將 PHP、HTML、CSS 同 JavaScript 知識同 WordPress 核心架構結合嘅過程。由建立正確嘅檔案結構開始，逐步實現模板層級、核心功能檔案、資源管理同埋響應式設計。透過整合小工具同自訂器等進階功能，你可以創建出又強大又易用嘅專業主題。關鍵在於理解 WordPress 嘅運作機制，並跟返佢嘅編碼標準同最佳實踐，咁樣可以確保你嘅主題安全、高效同埋容易維護。
常見問題
開發 WordPress 主題需要咩先決知識？
你需要有HTML同CSS嘅堅實基礎，呢啲係構建網頁外觀嘅基石。同時，一定要掌握PHP嘅基本語法，因為WordPress核心同主題模板都係用PHP寫嘅。對JavaScript（特別係jQuery）嘅了解對於加互動功能好有幫助。最後，了解WordPress嘅基本概念，例如循環、掛鉤同模板層級，係成功開發主題嘅關鍵。
主題嘅functions.php檔案可以有幾長？佢會唔會影響效能？
functions.php 檔案理論上可以好長，但為咗可維護性，強烈建議將佢模組化。你可以將唔同功能（例如自訂文章類型、短代碼、小工具）拆分成獨立檔案，然後喺 functions.php 入面用 require_once 或 include 入面引入。只要代碼寫得高效而且冇冗餘查詢，佢嘅長度對效能嘅影響微乎其微。對於大型項目，拆開檔案係標準做法。
點樣令我嘅主題支援多語言翻譯？
令主題支援國際化（i18n）係面向全球用戶嘅重要一步。喺你嘅 PHP 代碼入面，所有面向用戶嘅文本字串都應該用 WordPress 嘅翻譯函數包住，例如 __()（用於回顯文本）或者 _e()（用於直接輸出文本）。你需要喺 style.css 嘅頭同埋 load_theme_textdomain() 函數調用度正確設定 Text Domain。之後，開發者可以用 Poedit 呢類工具生成 .pot 模板檔案，並創建對應嘅 .po 同埋 .mo 翻譯檔案。
我開發嘅主題點樣提交到 WordPress 官方主題目錄？
提交到官方目錄需要滿足嚴格嘅要求。你嘅代碼必須遵循 WordPress 編碼標準，唔可以用任何簡碼或小工具嚟硬編碼內容，確保所有功能安全且符合 GPL 許可證。主題必須通過 Theme Check 插件嘅測試，同埋要有良好嘅響應式設計、可訪問性同完整嘅文檔。提交過程係透過 WordPress 官網嘅提交頁面進行，之後會有審核團隊進行審查。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。