Blockbase主题？

学完这篇，你能把 Blockbase 装起来、看懂它的模板结构，并基于它搭出一个自己的区块子主题。

Blockbase 是 Automattic 维护的一个「起点主题」，它本身不太像一个能直接上线的成品，而是给做区块主题的人当父主题用的。它的所有样式都写在 theme.json 里，页面结构全是 HTML 区块模板。下面按步骤来。

第一步：确认环境，把 Blockbase 下载到本地

这一步要做的是确认你的 WordPress 版本够新，并拿到主题压缩包。Blockbase 要求 WordPress 5.9 或更高版本，建议直接用 6.4 以上，否则站点编辑器里的「样式」面板会缺功能。

打开浏览器访问 https://github.com/Automattic/blockbase，点右上角绿色的 Code 按钮，在弹出菜单里选 Download ZIP，得到一个 blockbase-trunk.zip。

注意：GitHub 下载的压缩包解压后文件夹名是 blockbase-trunk。WordPress 只认文件夹名，父主题目录必须叫 blockbase，所以后面上传前或上传后要把它改成 blockbase。

第二步：在后台安装并启用

这一步把主题装进网站，装完后你能在主题列表里看到它。进入后台左侧菜单 外观 → 主题 → 安装主题，点页面顶部的 上传主题 按钮，点 选择文件 选中刚才的 zip 包，再点 现在安装。安装完成后点 启用。

如果你只是想先看看效果，启用后访问前台首页，会发现它长得非常「素」——几乎没有装饰，这是正常的，它的定位就是让你在上面加东西。

注意：启用 Blockbase 后不要在站点编辑器里马上大改。站点编辑器保存的模板和样式都存在数据库里，并且绑定在当前主题上，之后一旦切换主题，这些改动不会跟着走。

第三步：用站点编辑器摸清它的结构

这一步是看懂 Blockbase 有哪些模板和模板部件，为改版做准备。进入 外观 → 编辑器（WordPress 6.0–6.4 里这个菜单叫「外观 → 站点编辑器」）。点左上角的 WordPress 图标打开侧边栏，选 模板 → 管理所有模板，你会看到 index、single、page、archive、search、404 这些模板；切到 模板部件，能看到 header 和 footer。

想改哪一块，就点进去，用区块编辑器直接改，右上角点 保存。改页头就去开 header 部件，全站生效。

第四步：建一个子主题（强烈建议）

这一步是让后续所有改动都留在你自己的主题里，不会被父主题更新冲掉。在你的网站文件里，进入 wp-content/themes/，新建文件夹 blockbase-child，在里面新建一个 style.css，内容如下：

/*
Theme Name: My Blockbase Child
Template: blockbase
Version: 1.0
*/

然后再建一个 theme.json：

{
  "version": 2,
  "settings": {
    "appearanceTools": true
  }
}

回到后台 外观 → 主题，启用「My Blockbase Child」。子主题的 theme.json 会自动和父主题合并，你只需要写要覆盖的部分。

注意：Template: blockbase 里的 blockbase 必须是父主题文件夹名，写错一个字母，主题列表里就不会显示这个子主题，或者显示「缺少父主题」。

第五步：用 theme.json 改颜色和字体

这一步让你不改模板也能换全站配色。打开子主题的 theme.json，在 settings.color.palette 里加一行：

"color": {
  "palette": [
    { "slug": "primary", "color": "#1a5fb4", "name": "主色" }
  ]
}

保存后刷新后台，进 外观 → 编辑器 → 样式（右侧栏那个半黑半白的圆形图标），你会发现色板里多了「主色」。在样式面板里改完点 保存，前台立刻生效。

注意：改 theme.json 时 JSON 里最后一项后面不能有逗号，多一个逗号整个文件会被忽略，样式看起来「没反应」多半是这个原因。

小结

• Blockbase 是起点主题，不是成品主题，适合当父主题用。
• 装之前确认 WordPress 5.9 以上，建议 6.4+。
• 父主题文件夹名必须是 blockbase，GitHub 下载的包要改掉 -trunk。
• 先建子主题再动手，站点编辑器里的改动是绑主题的，切换会丢。
• 结构在 外观 → 编辑器 → 模板 / 模板部件 里看，样式在 样式 面板改。
• 子主题只需写要覆盖的 theme.json，父主题配置会自动合并。