准备工作与环境搭建
在开始编写代码之前，建立一个高效且专业的本地开发环境至关重要。这不仅能让你在不影响线上网站的情况下进行测试，还能极大地提升开发效率。
本地开发环境的配置
我们推荐使用本地服务器软件包，例如 Local by Flywheel、MAMP 或 XAMPP。这些工具可以一键在你的电脑上安装 Apache/Nginx、PHP 和 MySQL，完美模拟线上服务器环境。安装完成后，创建一个新的 WordPress 站点，并确保你的 PHP 版本符合 WordPress 的最新要求。
创建主题的基础目录与文件
一个 WordPress 主题本质上是一个位于 /wp-content/themes/ 目录下的文件夹。首先，为你的主题创建一个具有唯一性的文件夹，例如 my-custom-theme。在该文件夹内，你必须创建两个核心文件：style.css 和 index.php。
推荐阅读 WordPress 主题开发：从零到精通的完整指南与实践教程。
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: 这是一个为学习目的而创建的个性化 WordPress 主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/index.php 是主题的默认模板文件，即使其他模板文件缺失，它也必须存在。此时，你可以先在其中写入简单的 HTML 结构来测试。
构建主题的核心模板文件
WordPress 使用模板层级系统来决定如何显示不同类型的内容。理解并创建这些核心模板文件是主题开发的基础。
创建网站头部与底部模板
为了实现代码复用，我们需要将网页的头部（Header）和底部（Footer）分离成独立文件。创建 header.php 文件，它应包含从 开始到打开 标签之前的所有代码，关键是要包含 wp_head() 函数调用。
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
<?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>
<?php wp_body_open(); ?>
<header>
<h1><a href="<?php echo esc_url( home_url( '/' ) ); ?>"><?php bloginfo( 'name' ); ?></a></h1>
</header>同样，创建 footer.php 文件，它应包含页脚内容，并以调用 wp_footer() 函数和结束标签收尾。然后，在 index.php 中，使用 get_header() 和 get_footer() 函数来引入它们。
推荐阅读 全面解析WordPress主题开发：从入门到精通的实践指南。
设计文章循环与页面内容
文章循环是 WordPress 用来从数据库中获取并显示文章的核心机制。在 index.php 的主体部分，你需要使用标准的循环结构。
<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post(); ?>
<article>
<h2><?php the_title(); ?></h2>
<div><?php the_content(); ?></div>
</article>
<?php endwhile;
else :
echo '<p>暂无文章。</p>';
endif;
?>接下来，为单个文章页面创建模板 single.php，为静态页面创建 page.php。你还可以创建 front-page.php 作为自定义首页，或 archive.php 来显示分类、标签等归档列表。
添加功能与样式
一个完整的主题不仅需要结构，还需要交互功能和视觉设计。这通过功能文件和样式表来实现。
引入主题功能支持
创建 functions.php 文件。这个文件用于扩展主题功能，它不是必须的，但极其重要。在这里，你可以注册菜单、启用特色图像、添加主题支持等。
<?php
function my_theme_setup() {
// 让 WordPress 管理标题标签
add_theme_support( 'title-tag' );
// 启用文章和页面的特色图像
add_theme_support( 'post-thumbnails' );
// 注册一个导航菜单位置
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-custom-theme' ),
) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );
// 引入样式表和脚本
function my_theme_scripts() {
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri() );
wp_enqueue_script( 'my-theme-script', get_template_directory_uri() . '/js/script.js', array(), false, true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );
?>编写响应式样式表
在 style.css 的声明信息下方，开始编写你的 CSS。现代主题必须是响应式的。建议使用移动优先的原则，并利用 CSS 媒体查询来适配更大屏幕。
/* 基础样式 - 移动设备 */
body { font-family: sans-serif; margin: 0; }
.container { width: 100%; padding: 1rem; }
/* 平板设备及以上 */
@media (min-width: 768px) {
.container { max-width: 720px; margin: 0 auto; }
}
/* 桌面设备 */
@media (min-width: 992px) {
.container { max-width: 960px; }
}你可以创建额外的 CSS 文件并通过 functions.php 中的 wp_enqueue_style() 引入，以保持代码组织有序。
推荐阅读 深入解析WordPress主题开发：从入门到精通的完整实践指南。
进阶主题开发技巧
当掌握了基础之后，以下技巧能让你的主题更专业、更强大。
创建自定义文章类型与侧边栏
对于作品集、产品等非标准内容，你可以通过 functions.php 中的 register_post_type() 函数创建自定义文章类型。同时，使用 register_sidebar() 函数来创建小工具区域（侧边栏），并在模板中使用 dynamic_sidebar() 函数调用它。
实现子主题与主题国际化
为了确保主题更新时你的修改不会丢失，强烈建议为你的个性化主题创建一个“子主题”。子主题只需要一个 style.css 和一个 functions.php，它继承父主题的所有功能，并允许你安全地覆盖样式和功能。
此外，为了让主题能被全球用户使用，需要进行国际化准备。这意味着在代码中所有需要翻译的文本处，使用 __() 或 _e() 等翻译函数进行包裹，并设置好 Text Domain。然后，可以使用 Poedit 等工具生成 .pot 翻译模板文件。
总结
从零开始打造一个 WordPress 主题是一个系统性的学习过程，涵盖了从环境搭建、PHP 模板语法、核心文件结构到功能扩展和样式设计的完整路径。关键在于动手实践：从创建最简单的 style.css 和 index.php 开始，逐步添加头部、底部、循环，再到通过 functions.php 增强功能。理解模板层级和钩子函数是进阶的核心。最终，通过创建子主题和进行国际化准备，你的作品将具备专业级的可维护性和可扩展性。记住，最好的学习方式就是不断地编码、测试和迭代。
FAQ 常见问题
### 开发 WordPress 主题必须精通 PHP 吗？
是的，具备扎实的 PHP 基础是必要的，因为 WordPress 核心及其模板系统主要由 PHP 驱动。你需要理解 PHP 语法、函数、循环以及如何与 WordPress 的 API（如钩子、函数）交互。同时，对 HTML、CSS 和基础 JavaScript 的掌握也至关重要。
为什么我的主题在后台不显示？
这通常是由于 style.css 文件顶部的主题信息注释块格式不正确或缺失造成的。请严格按照格式填写 Theme Name、Author 等信息，并确保该文件位于你主题文件夹的根目录下。此外，检查主题文件夹是否被正确放置在 /wp-content/themes/ 路径中。
get_template_part() 函数有什么用处？
get_template_part() 函数是组织主题代码的最佳实践之一。它用于从其他文件（如 content.php, sidebar.php）中加载代码片段，从而避免在多个模板文件中重复相同的 HTML 结构。这极大地提高了代码的可复用性和可维护性。
如何让我的主题支持古腾堡编辑器？
为了让主题更好地兼容古腾堡编辑器，你需要在 functions.php 中添加相关主题支持。例如，使用 add_theme_support(‘editor-styles’) 来加载编辑器的样式；使用 add_theme_support(‘wp-block-styles’) 来支持前端块样式；还可以使用 add_theme_support(‘responsive-embeds’) 使嵌入内容具有响应性。为常用的块（如分组块、封面块）编写前端样式也很重要。
下一步，接下来该怎么做？
延伸阅读与实用知识
下面这些内容与本文主题相关，适合继续深入阅读。优先从与你当前问题最接近的文章开始看，再逐步扩展到周边主题，效果通常会更好。