本文共计2631个字，预计阅读时长10.5分钟。

当前加载方案：Barba PJAX 相比 Xiuno 原生跳转的优势与边界

{% tip info %}

本文介绍的是本站当前已经启用的加载方案：在 Xiuno BBS 服务端渲染基础上，使用 Barba PJAX 处理安全的公开页面跳转。它不是替换 Xiuno 框架，而是在原有框架之上补充更连续的前台浏览体验。

{% endtip %}

{% label 当前线上方案, blue %} {% label Barba PJAX, purple %} {% label 服务端渲染保留, green %}

一句话说明

Xiuno 继续负责路由、权限、模板渲染、数据库和发帖等核心能力；前台在访问公开页面时，只替换主要内容容器，而不是让浏览器完整卸载并重新加载整个页面。

这让首页、板块页、文章页、用户页、排行榜和友链等公开内容之间的浏览更连贯，同时保留传统论坛对登录、发帖、编辑、删除和退出等关键操作的稳定处理方式。

{% tabs 查看当前加载过程, 1 %}

1. 浏览器请求完整 HTML 页面。
2. 主题先显示 barbara_loading 全屏加载层。
3. DOM 就绪后，加载层淡出，页面进入可交互状态。

1. Barba 拦截符合条件的公开 GET 链接。
2. 浏览器请求目标页面 HTML，但保留当前站点外壳。
3. 当前内容短暂保留约 70ms，并显示粉色进度条和局部加载提示。
4. 新内容进入后以约 160ms 的淡入上移效果显示。

登录、注册、退出、发帖、编辑、删除、后台和其他可能改变服务器状态的入口，继续使用完整页面跳转。这样可以避免重定向、表单状态、权限变化和消息提示被前台路由错误接管。

{% endtabs %}

与 Xiuno 原生跳转相比，改善在哪里？

这里的“Xiuno 原生跳转”指未额外接入 PJAX 时的常规服务端页面跳转：点击链接后，浏览器重新请求完整页面，并重新解析整个文档。

| 对比项 | Xiuno 原生完整跳转 | 当前 Barba PJAX 方案 |

| --- | --- | --- |

| 页面外壳 | 每次重新加载导航、侧栏和页脚 | 尽量保留现有外壳，只替换主要内容 |

| 视觉连续性 | 容易出现空白、闪烁或浏览器默认加载状态 | 有局部提示、进度条和内容淡入 |

| 静态资源 | 浏览器按缓存策略重新校验和加载 | 已加载的公共资源通常可继续复用 |

| 返回与前进 | 常规浏览器历史记录 | 保留浏览器历史，并在恢复页面时主动收起加载层 |

| 复杂操作 | 所有操作都是整页流程 | 写操作仍回到整页流程，降低兼容风险 |

| 首次访问 | 完整加载 | 仍是完整加载，不承诺首屏性能凭空提升 |

{% folding open green, 实际可感知的优势 %}

1. 阅读节奏更连续：从首页进入板块、从板块进入文章时，导航和周边区域不会反复被整页卸载。
2. 加载状态更明确：顶部细进度条和内容区提示告诉用户请求仍在进行，减少“点了没有反应”的感觉。
3. 公共页面切换更轻：浏览器不需要重新建立整份文档的视觉结构，通常能降低白屏感。
4. 保留 Xiuno 的服务端优势：页面仍由 Xiuno 输出，SEO、权限判断、模板钩子和已有插件无需改成单页应用。
5. 风险控制更保守：账户与写操作不强行 PJAX 化，避免为了动画牺牲发帖、登录和管理流程的可靠性。

{% endfolding %}

它不是什么

{% note warning fas fa-triangle-exclamation %}

PJAX 不是后端加速器，也不会减少 Xiuno 渲染页面、查询数据库或执行插件逻辑的时间。目标页面如果本身慢，用户仍要等待服务器响应；当前方案主要改善的是等待期间的视觉连续性和重复加载体验。

{% endnote %}

当前线上也没有开启悬停预取。这意味着鼠标移到链接上不会提前请求页面，优点是节省带宽、避免无意义请求；代价是首次点击某个未缓存页面时，仍要等待正常的网络和服务端响应。

为什么不把所有页面都交给 PJAX？

{% folding blue, 公开阅读页面适合 %}

• 首页与分页列表
• 板块与分类筛选
• 文章详情
• 用户公开主页
• 排行榜、友链、条款等只读页面

{% endfolding %}

{% folding orange, 这些页面继续完整跳转 %}

• 登录、注册、找回密码、退出登录
• 发帖、编辑、删除、回帖等写操作
• 个人中心、消息、商城、后台及需要登录态确认的页面
• 文件下载、接口响应、外部链接

{% endfolding %}

这种分界并不追求“所有链接都丝滑”，而是优先确保论坛的核心功能可靠。一个论坛的加载体验可以渐进增强，但账户、内容和权限操作必须保持可预期。

当前方案的限制与后续方向

{% changelog 2026-07-30, 当前加载方案说明, v1.0 %}

{% change added, 当前具备 %}

• 公开页面的 Barba PJAX 切换
• 首次加载层淡出
• 顶部进度提示、局部加载提示和内容淡入
• 历史返回后主动恢复页面可见状态

{% endchange %}

{% change improved, 已采用的保护 %}

• 写操作和高风险路由不参与 PJAX
• 请求失败时回退为普通页面跳转
• 兼容浏览器前进、后退与页面恢复

{% endchange %}

{% change fixed, 需要持续验证 %}

• 每增加一个插件路由，都需要确认它是否有统一内容容器。
• 页面内依赖脚本的组件需要在 PJAX 后正确重新初始化。
• 视觉动画应服从加载速度和可访问性，用户启用“减少动态效果”时不应强制动画。

{% endchange %}

{% endchangelog %}

结论

当前方案的价值不在于“比 Xiuno 更快”，而在于在不改动 Xiuno 核心架构的前提下，让公开内容浏览少一些整页闪动、多一些连续感。

Xiuno 仍然是论坛的服务端基础；Barba PJAX 只是前台体验层的渐进增强。对于内容社区，这种组合比把所有功能强行改造成单页应用更容易维护，也更适合保留现有插件生态。

{% checkbox green checked, Xiuno 继续负责服务端路由、权限与数据 %}

{% checkbox green checked, PJAX 只增强公开阅读页面 %}

{% checkbox green checked, 写操作保留完整跳转 %}

{% checkbox green checked, 页面体验与功能稳定性同时优先 %}