开始前的准备工作
在动手编写任何代码之前，需要确保开发环境已经就绪。首先，你需要一个本地服务器环境，例如XAMPP、MAMP或使用Docker。其次，一个代码编辑器是必不可少的，Visual Studio Code或PHPStorm都是不错的选择。最重要的是，你需要安装最新版本的WordPress，并确保其运行正常。
接下来，在你的WordPress安装目录下的wp-content/themes文件夹中，创建一个新的文件夹，这将是你的主题目录。例如，你可以将其命名为my-first-theme。这个目录的名字将直接成为你的主题标识符，因此建议使用小写字母、数字和连字符。
在主题文件夹内，有两个文件是启动一个WordPress主题所必需且最低限度的：style.css和index.php。没有它们，WordPress将无法在后台的“外观”->“主题”列表中识别你的主题。
推荐阅读 从零开始学习WordPress主题开发：打造个性化网站的完整指南。
理解主题的核心文件结构
一个功能完整的WordPress主题由一系列模板文件组成，它们遵循特定的命名约定。每个文件负责渲染网站的不同部分。
样式表与主题信息声明
style.css文件不仅仅是用来写CSS样式，它的头部注释区域更是WordPress用来读取主题元数据（meta data）的地方。这个区域必须在文件的最顶部，并且遵循特定的格式。
/*
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
Text Domain: my-first-theme
*/“Text Domain”用于国际化，是后续加载翻译文件的关键标识。填写完这些信息后，刷新WordPress后台的主题页面，你应该就能看到一个名为“我的第一个主题”的缩略图了。
主模板文件的作用
index.php是你的主题的主模板文件，也是网站默认的“回退”模板。当WordPress找不到更具体的模板文件（如single.php或page.php）时，就会使用index.php。其最基本的结构是调用WordPress的头部、主循环内容以及尾部。
<?php get_header(); ?>
<main id="main">
<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
// 输出文章内容
the_title( '<h2>', '</h2>' );
the_content();
endwhile;
else :
echo '<p>没有找到任何文章。</p>';
endif;
?>
</main>
<?php get_footer(); ?>扩展基础模板与引入功能
仅有index.php、style.css是不够的，我们需要将头部、尾部和侧边栏等部分分离，使结构更清晰，并引入主题的核心功能。
推荐阅读 从零开始：手把手教你开发一个自定义的WordPress主题。
分离头部与尾部模板
创建header.php文件，它包含文档类型声明、HTML的部分以及网站的标题和导航区域。使用wp_head()钩子以确保插件和WordPress核心能正确注入必要的脚本和样式。
<!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()钩子。
<footer>
<p>© <?php echo date('Y'); ?> <?php bloginfo( 'name' ); ?></p>
</footer>
<?php wp_footer(); ?>
</body>
</html>这样，在index.php中，我们就可以使用get_header()和get_footer()函数来引入它们。
创建功能文件
functions.php是主题的“大脑”，用于添加功能、注册菜单、启用特色图像、定义侧边栏等。它不是一个模板文件，而是一个在主题初始化时自动加载的PHP文件。
下面是functions.php的一个基础示例：
<?php
// 启用文章和页面的特色图像功能
add_theme_support( 'post-thumbnails' );
// 注册一个导航菜单位置
function my_first_theme_register_menus() {
register_nav_menus(
array(
'primary-menu' => __( '主导航菜单', 'my-first-theme' ),
)
);
}
add_action( 'init', 'my_first_theme_register_menus' );
// 引入主题的样式表和脚本
function my_first_theme_enqueue_scripts() {
// 引入主样式表
wp_enqueue_style( 'my-first-theme-style', get_stylesheet_uri(), array(), '1.0' );
// 引入一个自定义的JavaScript文件
wp_enqueue_script( 'my-first-theme-script', get_template_directory_uri() . '/js/script.js', array('jquery'), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_first_theme_enqueue_scripts' );
?>创建更多模板文件
为了让不同类型的页面有更合适的布局，我们需要创建更多专门的模板文件。
推荐阅读 从安装到精通：WordPress 建站完整指南与实用技巧全解析。
文章单页与页面模板
single.php用于渲染单篇博客文章。它的结构与index.php类似，但通常包含评论模板comments.php的调用。
page.php用于渲染静态页面。它通常不显示分类、标签等元数据，而更专注于页面内容本身。
文章归档列表模板
archive.php用于显示分类、标签、作者、日期等归档页面。你可以使用条件标签如is_category()、is_tag()来区分不同的归档类型，并显示相应的标题。
创建404错误页面
404.php是当用户访问不存在的URL时显示的页面。一个好的404页面应该包含友好的提示、搜索框和主要页面的链接，帮助用户找到所需内容。
总结
通过本指南，你完成了从创建文件夹和核心文件，到理解模板层次结构，再到扩展主题功能和创建专用模板的完整流程。你已经构建了一个具备基本结构、可被WordPress识别并拥有扩展功能的主题。虽然它看起来简单，但已经包含了所有核心概念。接下来，你可以深入学习模板标签、自定义查询、WordPress循环的更多用法，以及如何创建自定义文章类型和主题定制器选项，来让你的主题功能更加强大和个性化。
FAQ 常见问题
### 为什么我的主题没有在WordPress后台显示？
请首先检查你的主题文件夹是否放置在正确的wp-content/themes/目录下。其次，确认文件夹内是否包含必需的style.css和index.php文件。最后，打开style.css文件，确保顶部的主题信息注释块格式完全正确，特别是Theme Name:这一行。
如何为我的主题添加自定义Logo支持？
你需要在主题的functions.php文件中添加一行代码来启用此功能。使用add_theme_support( ‘custom-logo’ )函数。启用后，用户就可以在“外观”->“自定义”->“站点身份”中上传和设置Logo了。你还需要在header.php中合适的位置使用the_custom_logo()函数来显示它。
主题的functions.php文件和插件有什么区别？
functions.php中的功能是紧密绑定到当前激活主题的。如果你切换了主题，这些功能将不再可用。而插件的功能是独立于主题的，无论使用哪个主题，只要插件是激活状态，其功能就会生效。因此，如果你的功能是与主题的视觉呈现（如注册菜单位置、定义布局）强相关，可以放在functions.php中；如果是通用功能（如联系表单、SEO优化），则更适合做成插件。
如何让我的主题支持多语言？
你需要做好两件事。第一，在开发时，对所有面向用户的字符串使用翻译函数进行包裹，例如__( ‘文本’, ‘my-first-theme’ )或_e( ‘文本’, ‘my-first-theme’ )，并确保‘my-first-theme’与style.css中声明的“Text Domain”一致。第二，使用如Poedit这样的工具，从你的主题代码中提取出所有待翻译的字符串，生成.pot文件，再由翻译人员创建对应语言的.po和编译后的.mo文件，并放置在主题的/languages/目录下。
下一步，接下来该怎么做？
延伸阅读与实用知识
下面这些内容与本文主题相关，适合继续深入阅读。优先从与你当前问题最接近的文章开始看，再逐步扩展到周边主题，效果通常会更好。