常见问题
首页与板块
首页某个板块没有显示？
两个常见原因：
- 没写进
sections：板块必须在sections数组中才会渲染； - 板块名拼写不符：名字要与
layout/_partial/section-<name>.ejs一致（注意quicklinks的 s）。
about-contact 是合并板块，同样需要显式出现在 sections 中。
怎么隐藏一个板块？
从 sections 数组中删除对应那一行即可，不需要删除其配置节点 —— 保留节点便于日后恢复。详见板块总览。
想让某个板块排在首页最前面？
调整 sections 数组中的位置即可，数组顺序就是页面顺序。
首页板块的数据从哪来？
除 news 板块动态读取最新文章外，其余板块内容全部来自 _config.yml（或站点覆盖文件），改配置即可更新，不需要动模板。
依赖与构建
首页 / 归档页不生成？
补装生成器 —— Hexo 7 核心不自带：
1 | npm i hexo-generator-index hexo-generator-archive hexo-generator-category hexo-generator-tag |
报错找不到 ejs 渲染器？
主题的模板是 EJS，必须安装 hexo-renderer-ejs：
1 | npm i hexo-renderer-ejs |
改了配置但页面没变化？
Hexo 有缓存，改完 YAML 请重新构建：
1 | hexo clean && hexo generate |
内容与页面
页面点击 404？
多半是把页面写成了 source/about.md。请改为 source/about/index.md，这样才会生成 /about/（与导航里的写法一致）。详见页面与 Front-matter。
新闻列表是空的？
检查两点：source/news/index.md 的 front-matter 里写了 layout: news；以及 source/_posts/ 下确实有文章。
文章封面不显示？
确认 cover 路径正确（如 /images/thumb-1.svg），且图片确实存在于站点 source/images/（或其它会被复制到 public/ 的目录）。
联系与合规
联系表单提交到哪里？
主题不收集数据，而是把表单提交到你指定的服务。在 contact.form_action 填入服务端点即可，例如：
1 | contact: |
留空则不渲染表单。详见联系与地图。
地图怎么嵌入？
把地图服务商提供的 iframe 嵌入地址填入 contact.map（填 URL，不是整段 <iframe> 标签），留空则不显示地图区域。
如何修改备案号？
在 footer.icp 填 ICP 备案号、footer.police 填公安备案号，并可通过 icp_url / police_url 指定跳转地址。详见页脚与备案。
预设与定制
换预设后颜色没变？
确认改的是生效的配置 —— 站点覆盖文件 _config.hexo-theme-xongyi.yml 优先于主题 _config.yml；然后重新 hexo clean && hexo generate。
升级主题会覆盖我的自定义吗？
只要自定义都写在站点根目录的 _config.hexo-theme-xongyi.yml 中，git pull / git submodule update 升级主题时就不会丢失。
想改主色但不想换预设？
预设与主色是两件事。保持 preset 不变，通过注入覆写 CSS 令牌 --primary 即可，详见自定义样式与模板。
可以给某个板块单独调样式吗？
可以。板块容器带有对应的类名，用注入的自定义 CSS 精确覆盖即可；但优先尝试用现有配置项（标题、副标题、条目），改动成本更低。
兼容性
支持哪些浏览器？
Chrome / Edge / Firefox / Safari 最近两个大版本。主题使用了 CSS 变量与 IntersectionObserver，旧浏览器会优雅降级（失去动画，不影响阅读）。主题也遵循系统的 prefers-reduced-motion 设置。
支持 Hexo 6 或更早版本吗？
推荐 Hexo 7.x。更早版本可能因生成器与 API 差异出现异常，建议升级 Hexo。
能同时装 hexo-theme-xfm 和 Xongyi 吗？
可以。两套主题都是独立的 themes/<name>/ 目录，站点用 theme: <name> 选择其一。切换主题后请 hexo clean 再构建。
评论