创建一个 WordPress 主题并没有想象中那么复杂。一个最简单的主题只需要两个文件就能运行，但一个功能完整的主题需要合理的文件结构和规范的代码组织。本文将带你从零开始，一步一步创建一个完整的 WordPress 主题。

第一步：创建主题文件夹和样式表文件

在 /wp-content/themes/ 目录下创建一个新文件夹，命名使用小写字母和连字符，例如 my-first-theme。在里面创建两个核心文件：style.css 和 index.php。

style.css 是主题的“身份证”，WordPress 通过它来识别和显示主题信息。文件头部必须包含以下注释信息：

/*
Theme Name: 我的第一个主题
Theme URI: https://你的网站.com
Author: 你的名字
Author URI: https://你的网站.com
Description: 这是一个从零开始创建的自定义主题
Version: 1.0
License: GPL v2 or later
Text Domain: my-first-theme
*/

index.php 是主题的回退模板。当 WordPress 找不到更具体的模板文件时，就会使用它。即使是空文件，WordPress 也能识别这个主题。

第二步：创建基础模板文件

一个功能完整的主题通常包含以下模板文件：

header.php：存放网站顶部 HTML 结构，包括 head 标签内的内容、导航菜单等。通过 get_header() 函数在页面中调用。

footer.php：存放网站底部 HTML 结构，包括版权信息、关闭标签等。通过 get_footer() 函数调用。

sidebar.php：存放侧边栏内容。通过 get_sidebar() 函数调用。

functions.php：主题的功能核心，用于添加特色功能、注册导航菜单、加载样式和脚本等。

single.php：单篇文章的显示模板。

page.php：独立页面的显示模板。

archive.php：归档页面的显示模板，包括分类、标签、日期归档等。

404.php：404 错误页面模板。

search.php：搜索结果页面模板。

第三步：编写 functions.php 添加主题功能

functions.php 是主题功能的核心。在这里，你可以注册主题特色功能、加载样式和脚本、注册导航菜单：

首先启用特色图片支持，这是几乎所有主题都需要的基础功能。然后注册导航菜单位置，让用户可以在后台管理菜单。接着通过 wp_enqueue_scripts 钩子加载主题的样式表和脚本文件。

对于脚本，建议在注册时设置 in_footer 参数为 true，让脚本在页面底部加载，避免阻塞页面渲染。

第四步：理解模板层级

WordPress 会根据访问的页面类型，按照特定的优先级寻找模板文件。例如，访问一篇博客文章时，系统会依次寻找 single-post.php、single.php、singular.php，最后才是 index.php。

理解这个层级是进行主题开发的关键。通过精准地创建特定文件，比如 category-news.php 专门针对新闻分类，可以在不影响全站架构的前提下实现特定页面的个性化定制。

对于页面模板，WordPress 支持页面属性中的“模板”下拉选择，你可以在主题根目录创建以 page- 开头的 PHP 文件，或者使用页面模板注释。

第五步：完善样式和响应式设计

在 style.css 中完善网站的视觉样式，确保在不同屏幕尺寸下都能良好显示。2026 年，移动优先的设计理念已经成为标配。建议从移动端样式开始编写，然后通过媒体查询逐步增强到桌面端。

第六步：测试和部署

在将主题上线之前，务必在测试环境中完整测试所有功能。确认无误后，将主题文件夹上传到正式服务器的主题目录，在 WordPress 后台激活即可。