WordPress 主题开发快速入门指南

发布于 作者:

导读

很多 WordPress 初学者都有个误解：认为开发主题必须精通 PHP、JavaScript 和 CSS。实际上，从 WordPress 5.9 引入块编辑器（Block Editor）和站点编辑器（Site Editor）之后，创建主题的门槛已经大幅降低。你现在完全可以通过可视化界面，像搭积木一样构建自己的主题，全程不需要写一行代码。

本文带你走一遍直接的路径：激活一个现有主题 → 在站点编辑器里随意调整 → 一键导出成新主题。整个过程大约需要 20 分钟，完成后你会得到一个可安装的 ZIP 文件。这篇文章不会讲太多理论，重点是让你先跑通整个流程，建立直观感受。代码的事情，后面再说。

一步：激活一个主题来上手

学做主题有效的方法，就是拿现成的主题来拆解、修改。

注意：在开发圈里，复用代码是基本功，不是偷懒。大多数场景下，你想实现的功能，早就有人做过了。站在别人肩膀上起步，比从零开始要明智得多。

打开你的 WordPress 后台，进入 外观 → 主题，激活一个默认主题。推荐选择新的版本——写这篇文章时是 Twenty Twenty-Four。默认主题之所以适合学习，是因为它们严格遵守 WordPress 编码规范，并且兼顾了各种使用场景，代码质量很高。

如果你的兴趣点在经典主题（即不使用块编辑器的传统 PHP 主题），可以直接跳到官方手册的“经典主题”章节。但本指南后续内容全部围绕块主题（Block Theme）展开。

二步：进站点编辑器里随便折腾

主题激活后，通过 外观 → 编辑器 进入站点编辑器。这是一个可视化界面，你看到的页面就是主题在前端的样子，所有修改都是实时预览的。

先在左侧菜单里找到 样式（Styles），你会看到主题自带的几套风格预设（Style Variations）。Twenty Twenty-Four 默认带了四五种配色方案，随便点一个试试效果。

接着点击样式书（Style Book）图标——那个长得像眼睛的按钮。在弹出的面板里，你可以修改网站全局样式：字体、颜色、间距、排版……所有设置都是点选和拖拽，完全不用碰代码。

这个阶段的目标不是做出作品，而是熟悉界面。花点时间把每个选项卡都点开看看，知道哪些东西能调、在哪里调。这份熟悉感在后面进阶学习时会派上大用场。

三步：导出你的一个主题

改满意了？记得点右上角的 保存。然后点击顶部菜单栏的 ⋮（选项），选择 导出。

WordPress 会打包一个 ZIP 文件给你，文件名跟你基于修改的那个主题一致（比如 twentytwentyfour.zip）。恭喜，你已经“创建”了人生中一个 WordPress 主题。

不过这里有个小问题：这个主题的名字还叫“Twenty Twenty-Four”。你需要给它改个名。

解压 ZIP 包，把文件夹重命名成你想要的主题名称（比如 my-first-theme）。然后打开文件夹里的 style.css 文件，你会看到文件顶部有这样的代码块：

css

/*
Theme Name: Twenty Twenty-Four
Theme URI: https://wordpress.org/themes/twentytwentyfour/
Author: the WordPress team
Author URI: https://wordpress.org
Description: ...
*/

把 Theme Name 改成你自己的主题名，其他信息也建议一并更新。这就是你需要碰的代码。

改完后重新压缩成 ZIP，这个主题就可以上传到任何 WordPress 网站使用了。

进阶方案：用 Create Block Theme 插件

上面介绍的导出方法是 WordPress 自带的功能。如果你想要更细致的控制，推荐安装官方维护的 Create Block Theme 插件。

激活插件后，站点编辑器右上角会出现一个扳手图标。点击它，你会看到更多选项：

  • Save Changes：将你的修改保存到当前主题文件
  • Export ZIP：导出主题压缩包（比核心功能更稳定）
  • Create Theme：填写完整的主题信息（作者、描述、版本号等），然后一键导出
  • Edit Theme Info：直接修改主题的元数据

用 Create Theme 功能，你可以在导出前就把主题名称、作者、描述、版本号等信息填好，导出的 ZIP 直接就是成品。

注意：这个插件目前还不支持上传自定义主题截图。如果你打算把主题分享给别人，需要在主题根目录手动放一张 screenshot.png 或 screenshot.jpg 作为预览图。尺寸建议 1200×900 像素。

总结

走完这三步，你已经具备了 WordPress 块主题开发的基本工作流：

  1. 从现有主题起步，而不是从零开始
  2. 利用站点编辑器做可视化定制，积累对样式系统的感知
  3. 用导出功能或 Create Block Theme 插件打包成可分发的新主题

这个流程的核心价值在于：它让你先看到结果，再理解过程。你手里有了一个能跑的主题文件，后续深入阅读手册时，所有概念都对应着你已经操作过的界面，理解成本会低很多。

下一步，建议你打开导出的主题文件夹，看看 theme.json 和 templates 目录里的 HTML 文件——这些就是块主题的真正骨架。慢慢琢磨，别急。