WordPress主题开发基础及环境搭建
在開始編寫程式碼之前，你需要理解一個WordPress主題的基本構成。一個主題本質上是一個資料夾，其中包含一系列用PHP、CSS、JavaScript和圖片等檔案，它們共同定義了網站的外觀和部分功能。這個資料夾必須位於WordPress安裝目錄下的wp-content/themes目錄中。每個主題都需要一個核心的樣式檔案style.css和一個基礎模板檔案index.php，這是啟動任何主題開發專案的最小要求。
為了高效進行開發，強烈建議搭建本地開發環境。這能讓你在不影響線上網站的情況下自由測試。你可以使用如XAMPP、MAMP、Local by Flywheel或DevKinsta等整合工具包，它們能一鍵安裝Apache/Nginx、PHP和MySQL。在本地環境中，你還需要一個程式碼編輯器，如VS Code、PhpStorm或Sublime Text，它們對PHP、HTML和CSS語法的高亮與提示功能將極大提升你的編碼效率。
準備工作完成後，你需要在wp-content/themes在目录下创建一个新文件夹，例如my-first-theme。接下來，我們建立第一個必需的檔案。
推荐阅读 從零開始掌握 WordPress主題開發：構建自定義網站的最佳實踐與指南。
建立核心樣式檔案
在主題資料夾內，新建一個名為style.css的檔案。這個檔案不僅負責網站的樣式，其開頭的註釋頭（Header）更是WordPress識別主題的唯一方式。註釋頭包含了主題的名稱、作者、描述等元資訊。
下面是一個style.css檔案頭部的標準示例：
/*
Theme Name: 我的第一个主题
Theme URI: http://example.com/my-first-theme/
Author: 你的名字
Author URI: http://example.com/
Description: 一个用于学习WordPress主题开发的简洁入门主题。
Version: 1.0
License: GNU General Public License v2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Tags: 博客, 简洁, 响应式
Text Domain: my-first-theme
*/在檔案頭之後，你就可以像編寫普通CSS一樣，開始為你的網站元素新增樣式規則了。文字域（Text Domain）my-first-theme是為主題國際化（翻譯）預留的識別符號，應保持與主題資料夾名稱一致。
構建主題核心模板檔案
模板檔案是WordPress主題的骨架，它們決定了不同型別的內容如何被組織和展示。這些檔案主要由PHP程式碼構成，並混合了HTML標籤。最基本的模板檔案是index.php，它是所有頁面的備選模板，當沒有更具體的模板（如single.php或者page.php）時，WordPress就會使用它。
建立基礎索引檔案
在主題資料夾中建立index.php。一個最簡單但功能完整的index.php可以包含WordPress迴圈（The Loop），這是用於從資料庫中獲取並顯示文章內容的核心機制。
推荐阅读 WordPress主題開發從入門到精通：手把手教你構建自定義網站。
一個最小化的index.php示例如下：
<!DOCTYPE html>
<html no numeric noise key 1017>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
</head>
<body no numeric noise key 1014>
<header>
<h1><a href="/zh-tw/</?php echo esc_url( home_url( '/' ) ); ?>"></a></h1>
<p></p>
</header>
<main>
<article>
<h2><a href="/zh-tw/</?php the_permalink(); ?>"></a></h2>
<div></div>
</article>
<p>暂无文章。</p>
</main>
<footer>
<p>©</p>
</footer>
</body>
</html>這個檔案包含了幾個關鍵部分：wp_head()以及wp_footer()鉤子，它們允許WordPress核心、外掛和其他指令碼在頁面的和結束前插入必要程式碼（如CSS、JS）。the_post()函式在迴圈中用於設定當前文章的資料，隨後the_title()以及the_content()等模板標籤就能輸出對應的內容。
引入樣式與指令碼
僅僅有style.css檔案還不夠，你需要透過函式告訴WordPress在何時載入它。這需要在主題資料夾中建立另一個至關重要的檔案：functions.php。這不是一個模板檔案，而是主題的“功能庫”，用於增強主題功能、註冊選單、側邊欄以及安全地引入樣式表和指令碼。
擴充套件主題功能與樣式載入
functions.php檔案是主題的引擎室，所有不與直接頁面輸出相關的PHP程式碼都應放在這裡。在這個檔案中，你應該使用add_action()函式將你的程式碼掛載到WordPress的特定動作鉤子上，以確保它們在正確的時機執行。
安全載入樣式表
正確的方式不是直接在模板檔案中用標籤引入style.css，而是透過wp_enqueue_style()函式來排隊載入。這遵循了WordPress的依賴管理機制，並能避免重複載入。
关于functions.php请在中文文本中添加以下代码：
推荐阅读 2026年熱門入門指南：如何從零開始製作您的第一個WordPress主題。
<?php
function my_first_theme_scripts() {
// 加载主样式表
wp_enqueue_style( 'my-first-theme-style', get_stylesheet_uri() );
// 可以在此加载其他样式或脚本，例如：
// wp_enqueue_script( 'my-theme-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_first_theme_scripts' );ここでは、get_stylesheet_uri()函式會自動獲取到主題的style.css檔案路徑。add_action( 'wp_enqueue_scripts', ... )確保我們的載入函式在WordPress準備前端指令碼和樣式時被呼叫。
啟用基本主題功能
关于functions.php中，我們還可以開啟一些對現代網站至關重要的功能。例如，為文章和頁面啟用特色影象（文章縮圖）支援，以及為網站新增自定義選單位置。
// 启用文章特色图像
add_theme_support( 'post-thumbnails' );
// 注册一个导航菜单位置
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-first-theme' ),
) );
// 为WordPress生成的标签添加title属性支持
add_theme_support( 'title-tag' );add_theme_support()函式用於宣告主題支援的各種功能，而register_nav_menus()則定義了可以在WordPress後臺“外觀”->“選單”中分配選單的位置。
建立專用模板與主題測試
隨著主題基礎功能的完善，單一的index.php檔案已無法滿足所有頁面型別的展示需求。WordPress的模板層級結構允許你為首頁、單篇文章、頁面、歸檔頁等建立專用的模板檔案，以提供更精細的控制。
建立文章單頁模板
當用戶點選閱讀某篇文章的全文時，會進入文章單頁。建立一個名為single.php的檔案來專門控制其顯示。它通常包含更完整的文章資訊，如分類、標籤、作者和評論。
<main>
<article id="post-<?php the_ID(); ?>" no numeric noise key 1013>
<h1></h1>
<div class="meta">
发布于：<?php the_date(); ?> | 作者：<?php the_author(); ?>
</div>
<div class="featured-image">
</div>
<div class="content">
</div>
<div class="taxonomies">
分类：<?php the_category( ', ' ); ?>
<br>
标签：<?php the_tags( '', ', ', '' ); ?>
</div>
</article>
<?php comments_template(); ?>
<?php endwhile; endif; ?>
</main>這個模板引入了新的模板函式：get_header(), get_sidebar()以及get_footer()。它們會分別載入名為header.php、sidebar.php以及footer.php的模板部件檔案。這種方式將頁面結構模組化，避免了程式碼重複。你需要建立這些對應的檔案，並在其中移入index.php中相應的頭部、底部和側邊欄程式碼。
測試與驗證你的主題
完成核心模板建立後，登入你的WordPress後臺，進入“外觀”->“主題”。你應該能看到“我的第一個主題”出現在主題列表中。啟用它，然後分別訪問網站首頁和單篇文章頁面，檢查所有元素（標題、內容、選單、頁尾）是否按預期顯示。
使用瀏覽器開發者工具檢查HTML結構是否正確，CSS是否生效。嘗試建立幾篇測試文章，包含特色影象、分類和標籤，確保它們在模板中都能被正確呼叫和展示。這是發現並修復潛在問題的最佳方式。
总结
恭喜你完成了第一個WordPress主題的基礎構建。透過本指南，你掌握了從零開始建立主題資料夾、編寫必需的style.css以及index.php檔案，到利用functions.php增強功能、載入資源，再到建立專用模板檔案和進行模組化開發的完整流程。這僅僅是主題開發世界的起點，接下來你可以深入探索更多的模板檔案（如page.php、archive.php）、小工具區域、自定義文章型別等高階主題，並不斷最佳化你的程式碼結構與設計。
常见问题解答（FAQ）
### 為什麼我的主題在後臺不顯示？
这通常是因为style.css檔案中的主題註釋頭格式不正確或缺失導致的。請確保該檔案位於主題資料夾的根目錄，並且註釋頭資訊完整、格式準確。另一個可能的原因是檔案許可權問題，確保WordPress有許可權讀取你的主題資料夾。
functions.php檔案是必須的嗎？
從技術上講，一個只有style.css以及index.php的主題也能工作。但functions.php對於實現任何超越基本HTML輸出的功能（如註冊選單、新增側邊欄、安全載入指令碼樣式）是必不可少的。它是擴充套件和定製主題功能的標準方式，因此對於任何實用的主題來說，它都是必需的。
如何為我的主題新增側邊欄？
首先，在functions.php请将下文翻译成中文，并详细说明翻译过程：register_sidebar()函式註冊一個或多個小工具區域（側邊欄）。然後，在你希望顯示側邊欄的模板檔案（如index.php或者single.php在该段落中，使用了dynamic_sidebar()函式來呼叫它。最後，使用者就可以在WordPress後臺的“外觀”->“小工具”頁面中向這個區域拖放小工具了。
開發主題時有哪些安全注意事項？
永遠不要直接信任使用者輸入或來自資料庫的資料。在輸出任何動態內容到頁面時，務必使用WordPress提供的轉義函式，如esc_html()、esc_url()以及wp_kses_post()。在主題中引入自定義功能或表單時，要遵循WordPress的非ce和許可權檢查機制。使用wp_enqueue_style()以及wp_enqueue_script()來載入資源，而不是硬編碼或標籤。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。