WordPress 主题开发完整教程：制作你的第一个自定义主题

虽然 WordPress 有数以万计的主题，但如果你需要完全定制的设计或功能，学习主题开发是必经之路。本文介绍如何从零开始开发一个 WordPress 主题，包含主题结构、模板文件、主题函数和样式表。

主题的基本结构

一个最基本的 WordPress 主题只需要两个文件：style.css（样式表，包含主题元数据）和 index.php（主模板文件）。在 wp-content/themes/ 目录下创建你的主题文件夹，建立这两个文件即可激活主题。

style.css 的主题头部

每个主题必须在 style.css 开头包含主题元数据注释：/* Theme Name: My Custom Theme Theme URI: https://example.com Description: A custom WordPress theme Author: Your Name Version: 1.0 */。WordPress 通过这些信息识别和管理主题。

模板文件层级

WordPress 使用模板文件层级来决定显示什么页面：index.php（最后的兜底模板）front-page.php（首页）home.php（博客文章列表）single.php（单篇文章）page.php（单页）archive.php（归档页）search.php（搜索结果）404.php（404 页面）header.php / footer.php / sidebar.php（可复用组件）

常用的模板标签

bloginfo('name') 显示网站标题；bloginfo('description') 显示副标题；wp_title() 输出页面标题；wp_head() 在 head 标签中加载必要脚本和样式；wp_footer() 在页脚加载脚本；get_header() / get_footer() / get_sidebar() 加载公共模板。

主循环（The Loop）

主循环是 WordPress 显示文章的核心代码：if ( have_posts() ) : while ( have_posts() ) : the_post(); // 显示文章内容 endwhile; endif;。在循环内可以使用 the_title()、the_content()、the_excerpt() 等函数输出文章内容。

functions.php 主题函数

functions.php 是主题的"大脑"，用于添加自定义功能和修改默认行为。例如：注册菜单位置（register_nav_menus）、启用主题功能（add_theme_support）、添加侧边栏（register_sidebar）、加载 CSS 和 JS（wp_enqueue_style）。

总结

WordPress 主题开发虽然涉及 PHP 知识，但入门并不难。从创建一个简单的 index.php 开始，逐步添加更多模板文件和功能，你就能掌握主题开发的精髓。