从Hueman到Twenty Twenty-Five，主题切换与多语言菜单配置

一次以备份为前提、以多语言菜单配置为核心的主题切换实战。

一、为什么要换主题？

我的博客 shuijingwanwq.com 一直使用 Hueman 主题，这是一款经典、稳定、功能丰富的主题，陪我走过了很长一段时间。但随着博客内容的增加和访客设备的变化，我逐渐发现了一些问题。

最关键的数据来自网站统计：超过35%的访客屏幕宽度在1680px以上。而Hueman主题对超宽屏的支持并不理想，内容区域最大宽度有限，导致大量空白边距，阅读体验不够舒适。

另外，WordPress已经进入了块主题（Block Theme）时代，全站编辑（FSE）提供了更灵活、更可视化的定制方式。我希望将博客切换到一款对宽屏更友好、更现代化、且维护更积极的主题上。

经过一番调研，我选择了 Twenty Twenty-Five —— 它是WordPress官方最新默认主题（2025年），专为博客和内容创作优化，原生支持全站编辑，且对宽屏有良好的适配。

二、切换前的准备工作

任何主题切换，第一步必须是 备份。

我使用 UpdraftPlus 插件对网站的文件和数据库进行了完整备份。

除了备份，我还做了几件事：

• 记录旧主题的自定义代码：Hueman的functions.php中有不少我自己添加的功能性代码，后续需要迁移。
• 截图记录小工具和菜单设置：虽然我决定放弃旧的小工具布局，但菜单结构需要保留。
• 准备新主题的配置思路：明确需要调整的内容宽度、首页展示方式、多语言菜单等。

三、选择Twenty Twenty-Five的考虑

Twenty Twenty-Five 是 WordPress 6.7 及以后版本的默认主题，它具有以下优点：

• 完全支持全站编辑：所有布局调整都可以在站点编辑器中可视化完成。
• 对博客友好：排版精致，阅读体验优秀。
• 宽屏适配良好：可以在样式设置中自由调整内容宽度和宽幅宽度。
• 轻量快速：无多余依赖，性能表现出色。
• 官方长期维护：作为默认主题，更新有保障。

当然，它也有学习成本 —— 对于习惯了经典主题（如Hueman）的用户，块主题的菜单管理、小工具、模板结构都需要重新适应。这也正是这篇博客要记录的内容。

四、关于旧主题自定义代码的后续计划

在Hueman的functions.php中，我添加了以下几段自定义代码（见旧主题文件编辑截图）：

这些代码包括：

1. 禁用WordPress Emoji功能：移除Emoji的JS/CSS，提升加载速度。
2. 为薄内容标签页添加noindex：当某个标签下文章数少于2篇时，自动输出<meta name="robots" content="noindex, follow">，防止低质量页面被索引。
3. 调整标签云显示数量：将标签小工具显示的上限改为300个。

这些功能与主题本身无关，属于站点级功能，因此最好的做法是将其从主题中剥离，放到一个站点专属插件中，或者使用 Code Snippets 插件管理。

我计划后续使用 Code Snippets 插件，将每个功能独立为一个代码片段，并设置为“仅在前端运行”。这样，无论以后换什么主题，这些功能都不会丢失。

注意：Hueman主题自带的 load_template( get_template_directory() . '/functions/init-core.php' ); 和版本检查代码是主题内部依赖，不可迁移。

五、配置首页显示方式

启用Twenty Twenty-Five后，首页默认可能显示一个静态页面或某种模板，而我需要的是 最新文章列表，并且只显示摘要而非全文。

进入 设置 > 阅读，在“您的主页显示”中选中“您的最新文章”，同时将“对于Feed中的每篇文章”改为“摘要”。

这样首页就显示为文章列表，且每篇文章只展示摘要，符合技术博客的阅读习惯。

六、多语言菜单的配置过程（重点）

我的博客支持中英双语，使用 Polylang免费版 实现。在Hueman（经典主题）中，我可以在 外观 > 菜单 中为每个菜单指定显示语言，非常简单。

但在Twenty Twenty-Five（块主题）中，事情变得复杂了：

• 块主题的菜单显示位置不再由“外观 > 菜单”页面控制，而是由站点编辑器中的“导航”块控制。
• Polylang免费版在块主题下，不会在菜单编辑页面显示“语言分配”下拉框。
• 这意味着：我无法直接告诉Polylang“中文主菜单”和“英文主菜单”分别对应哪种语言。

我评估了几种方案：

1. 在站点编辑器中创建两个导航块，分别绑定不同菜单，并尝试用条件显示 —— 但块主题的导航块没有内置“按语言显示”的条件逻辑。
2. Conditional Menus插件 —— 但有用户反馈该插件与Polylang存在已知兼容性问题，且无法识别“语言”作为条件，因此没有采用。
3. Polylang官方推荐的Site Editor Classic Features插件 —— 可以在块主题中恢复经典小工具，但操作略显繁琐，也没有采用。

最终，我找到了一个轻量级插件：TMS Extensions for Polylang。它提供了一个名为 “Menu by Language” 的块，专门用于在块主题中为每种语言显示不同的导航菜单，且完全免费。

操作步骤：

1. 安装并激活 TMS Extensions for Polylang。
2. 进入 外观 > 编辑器，编辑 “页眉” 模板。
3. 在区块插入器中找到 “Menu by Language” 块，添加到页眉中合适位置。
4. 点击该块，在右侧设置面板中，分别为 “中文（中国）” 和 “ENGLISH” 选择对应的菜单（中文主菜单、英文主菜单）。
5. 保存模板。

完成以上配置后，前台页眉会根据当前页面语言自动切换菜单。

七、总结

这次主题切换的核心工作可以概括为三件事：

1. 备份：使用UpdraftPlus完成全站备份，确保可回退。
2. 选主题：根据宽屏访客占比高的特点，选择Twenty Twenty-Five。
3. 配置多语言菜单：通过TMS Extensions for Polylang插件，解决了Polylang免费版在块主题下无法为不同语言分配菜单的问题。

这次经历也让我意识到，将功能代码与主题分离（如使用Code Snippets）是值得投入时间去做的事，后续会逐步完善。