准备工作与环境搭建
在開始編寫程式碼之前，你需要一個合適的開發環境。這包括一個本地伺服器環境（如XAMPP、MAMP或Local by Flywheel）以及一個程式碼編輯器（如VS Code、Sublime Text或PHPStorm）。本地伺服器環境能夠模擬線上伺服器，讓你在自己的電腦上安全地開發和測試主題，而無需在每次修改後都上傳到網路伺服器。
核心檔案是每個WordPress主題的基石。一個最基礎的主題至少需要兩個檔案：style.css 以及 index.php其中,style.css 不僅僅是樣式表，它更重要的功能是作為主題的“資訊頭”，用於向WordPress系統宣告你的主題。在這個檔案中，你需要透過特定的註釋塊來定義主題名稱、作者、描述、版本等元資訊。
此外，雖然不是必須，但強烈建議建立一個functions.php 檔案。這個檔案是你的主題“功能增強器”，用於新增自定義功能、註冊選單、側邊欄，以及引入其他指令碼和樣式檔案。透過它，你可以擴充套件主題的能力而無需修改核心檔案。
推荐阅读 WordPress主題開發入門指南：從零開始建立你的第一個自定義主題。
現代WordPress主題開發還建議使用子主題（Child Theme）。這是一種在不直接修改父主題檔案的情況下，對主題進行自定義和功能新增的安全方法。當父主題更新時，你的自定義內容（儲存在子主題中）將得到保留。建立子主題同樣需要上述兩個核心檔案，並在style.css 的樣式頭中透過Template:欄位宣告其父主題。
構建主題的核心模板檔案
WordPress使用模板層級（Template Hierarchy）系統來決定對於特定的頁面請求，應該使用哪個PHP模板檔案來渲染內容。理解這套規則是開發主題的關鍵。
文章與頁面顯示模板
最基本的模板是single.php以及page.php，它們分別用於控制單篇部落格文章和獨立頁面的顯示。在這些模板中，你會使用一系列WordPress核心函式來迴圈輸出內容。最重要的迴圈結構通常如下所示：
<h1></h1>
<div class="entry-content">
</div>這段程式碼檢查是否有文章，然後進入迴圈，依次輸出文章的標題和內容。函式如the_title()以及the_content()用於輸出對應的資料。
文章列表與存檔模板
當用戶訪問部落格首頁、分類目錄頁或作者存檔頁時，WordPress會使用列表模板。最常見的列表模板是index.php（作為最後的兜底選項）和archive.php。在列表模板中，迴圈會遍歷多篇文章，通常我們使用the_excerpt()來輸出文章摘要而非全文。
推荐阅读 逐步掌握WordPress主题开发：从零开始构建自定义主题。
// 在循环中输出文章列表项
<article>
<h2><a href="/zh-tw/</?php the_permalink(); ?>"></a></h2>
</article>the_permalink()函式用於獲取當前文章的永久連結。
主題的通用組成部分
為了提高程式碼的複用性和可維護性，你應該將公共的頁面部分拆分到獨立的模板檔案中。這透過get_header(), get_footer(), get_sidebar()以及get_template_part()等函式來實現。
例如，你的header.php檔案包含HTML文件的頭部、區域以及網站的頂部導航選單。在single.php中，你只需在開頭呼叫get_header()，WordPress就會自動引入header.php的內容。
同樣，對於在多個地方重複使用的程式碼塊（如文章元資訊），你可以將其儲存為content.php或者template-parts/content.php，然後在主模板中使用get_template_part('template-parts/content', get_post_format());呼叫它。第二個引數允許你根據文章格式（如相簿、引語）載入不同的變體檔案（如content-gallery.php）。
使用函式檔案增強主題功能
functions.php 檔案是主題的“控制中心”，所有不屬於直接HTML輸出的功能性程式碼都應放在這裡。它會在主題初始化時被WordPress自動載入。
註冊主題功能與選單
一個基礎且必要的操作是使用add_theme_support() 函式來宣告你的主題支援哪些WordPress功能。例如，啟用文章特色圖片、自定義選單和HTML5標記支援是標準做法。
推荐阅读 WordPress 的核心架构及其工作原理。
function my_theme_setup() {
// 添加文章和页面特色图片支持
add_theme_support('post-thumbnails');
// 为导航菜单功能添加支持
add_theme_support('menus');
// 为评论列表、搜索表单等添加HTML5标记支持
add_theme_support('html5', array('comment-list', 'search-form'));
}
add_action('after_setup_theme', 'my_theme_setup');然後，你可以使用register_nav_menus() 函式來定義主題中可用的選單位置，例如“頂部主導航”和“頁尾導航”。
引入樣式表與JavaScript
正確地將CSS和JavaScript檔案排入佇列（enqueue）是專業開發的關鍵。這確保了依賴關係正確，並且避免了指令碼衝突。絕對不要直接在模板檔案中使用或者標籤引入資源。
function my_theme_scripts() {
// 引入主题的主样式表
wp_enqueue_style('my-theme-style', get_stylesheet_uri());
// 引入自定义JavaScript文件，依赖于jQuery
wp_enqueue_script('my-theme-script', get_template_directory_uri() . '/js/main.js', array('jquery'), null, true);
}
add_action('wp_enqueue_scripts', 'my_theme_scripts');鉤子wp_enqueue_scripts 用於在網站前端載入指令碼和樣式，而get_stylesheet_uri()以及get_template_directory_uri() 函式能幫你獲取主題目錄的正確URL。
建立小工具區域
側邊欄或頁尾的小工具區域（Widget Areas）為使用者提供了通過後臺拖拽式介面自定義內容的能力。使用register_sidebar() 函式可以建立一個新的小工具區域。
function my_theme_widgets_init() {
register_sidebar(array(
'name' => '主侧边栏',
'id' => 'sidebar-1',
'description' => '此区域的小工具将显示在文章和页面侧边。',
'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');註冊後，你需要在模板檔案（如sidebar.php请将下文翻译成中文，并详细说明翻译过程：
（在此处插入用户提供的英文文本）dynamic_sidebar('sidebar-1');函式來輸出這個區域。
製作響應式佈局與樣式編寫
現代網站必須在各種裝置上都能良好顯示。這意味著你的主題必須是響應式的。實現響應式設計主要依靠CSS媒體查詢（Media Queries）和流動式佈局（Fluid Layouts）。
移動優先的樣式策略
建議採用“移動優先”的CSS編寫策略。即先為移動裝置（小螢幕）編寫基礎樣式，然後使用媒體查詢逐漸為更大螢幕新增或覆蓋樣式。
/* 基础样式（针对移动设备） */
.container {
width: 100%;
padding: 0 15px;
}
.article {
font-size: 16px;
line-height: 1.6;
}
/* 针对平板及以上设备 */
@media (min-width: 768px) {
.container {
max-width: 750px;
margin: 0 auto;
}
}
/* 针对桌面设备 */
@media (min-width: 992px) {
.container {
max-width: 970px;
}
.article {
font-size: 18px;
}
}這種策略確保了核心內容在所有裝置上都可訪問，並逐步增強更大螢幕上的體驗。
靈活處理圖片與媒體
確保圖片和嵌入內容（如影片）不會溢位其容器是響應式設計的基本要求。一個簡單的通用規則是：
img,
iframe,
video {
max-width: 100%;
height: auto;
}這條CSS規則確保媒體元素的寬度不會超過其父容器的寬度，同時高度會按比例自動調整，從而避免佈局被破壞。
利用WordPress輔助類與函式
WordPress本身會輸出很多有用的CSS類，你可以利用它們進行更精確的樣式控制。例如，標籤上會新增頁面、文章型別的類（如.page, .single-post），以及文章ID類（如.postid-123）。在文章列表的迴圈中，post_class()函式會為每篇文章的容器輸出一系列類名（如文章格式、分類等），這為精細化樣式設計提供了極大便利。
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<!-- 文章内容 -->
</article>在樣式表中，你可以這樣定位：
/* 为所有文章添加通用样式 */
article {
margin-bottom: 2em;
}
/* 仅为“引语”格式的文章添加特殊样式 */
.format-quote {
background-color: #f9f9f9;
border-left: 4px solid #ccc;
padding-left: 1em;
}总结
WordPress主題開發是一個將創意、前端技術（HTML、CSS、JavaScript）和後端技術（PHP）相結合的過程。從建立一個包含style.css以及index.php的基礎資料夾開始，逐步學習並實現模板層級系統，將頁面拆分為可複用的模板部件。核心的functions.php檔案是你擴充套件主題功能、註冊選單和指令碼的舞臺。最後，透過響應式的CSS設計，確保你的主題能在從手機到桌上型電腦的所有裝置上提供優秀的瀏覽體驗。遵循最佳實踐，如使用子主題進行修改、正確排入佇列指令碼和樣式，將使你的主題更專業、更安全，並且易於維護。
常见问题解答（FAQ）
沒有PHP基礎可以開發WordPress主題嗎？
雖然理論上可以只修改HTML和CSS來調整現有主題的外觀，但要真正從零開始開發一個功能完整、符合WordPress標準的主題，PHP知識是必不可少的。你需要理解基本的PHP語法、函式呼叫以及WordPress特有的模板標籤和鉤子（Hooks）系統。建議至少先學習PHP和WordPress基礎模板標籤。
主題開發完成後如何釋出給他人使用？
在將主題釋出到WordPress官方主題目錄或商業銷售之前，你需要進行嚴格的測試，並確保它遵循《WordPress主題開發手冊》中的編碼標準。這包括對程式碼進行安全審查、確保主題完全響應式、進行國際化（i18n）準備（使用翻譯函式如__()以及_e()），並移除所有除錯程式碼。然後，你可以選擇提交到官方目錄，或透過自己的網站進行分發。
子主題和父主題更新有什麼關係？
子主題的存在是為了安全地修改父主題。當你使用子主題時，你對樣式和功能的定製都儲存在子主題的檔案中。當父主題釋出更新時，你只需像更新其他主題一樣更新父主題即可。你的子主題檔案將保持不變，所有自定義內容都會保留。這是更新核心功能（父主題）而不丟失個性化設計（子主題）的最佳實踐。
如何為我的主題新增自定義選項頁面？
為高階主題新增自定義選項頁面，通常使用WordPress的設定API（Settings API）或透過整合一個流行的選項框架（如Redux、Kirki或使用Carbon Fields庫）來實現。設定API是WordPress核心提供的一套標準化介面，用於安全地建立、驗證和儲存選項。對於初學者，使用一個成熟的框架可以更快速地構建出使用者友好的選項面板，但會增加主題的複雜性和檔案體積。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。