惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
云风的 BLOG
云风的 BLOG
小众软件
小众软件
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
Apple Machine Learning Research
Apple Machine Learning Research
博客园 - 司徒正美
博客园 - 聂微东
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
美团技术团队
宝玉的分享
宝玉的分享
量子位
V
Visual Studio Blog
罗磊的独立博客
Vercel News
Vercel News
B
Blog
J
Java Code Geeks
S
SegmentFault 最新的问题
Recent Announcements
Recent Announcements
有赞技术团队
有赞技术团队
P
Proofpoint News Feed
GbyAI
GbyAI
G
Google Developers Blog
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC

姓王者的博客

Linux用户Secure Boot自主维护指南 | 姓王者的博客 MAD Bugs 已经开始——关于信息安全的军备竞赛 | 姓王者的博客 解决钉钉Dingtalk无法在Linux新版内核上启动问题-修复可执行栈错误 | 姓王者的博客 突发:GitHub 正遭受大规模 Issue 赌博广告轰炸 | 姓王者的博客 Ubuntu26.04-beta体验:坚毅浣熊! | 姓王者的博客 fakeclaw装作龙虾发贴吧 | 姓王者的博客 找回12年前的QQ记忆 | 姓王者的博客 在Linux上玩Flash网页游戏-洛克王国 | 姓王者的博客 Copilot将使用交互数据来训练 | 姓王者的博客 重要通知-请更新我的GPG公钥 | 姓王者的博客 为了自由Android | 姓王者的博客 GPL"2,3"事 | 姓王者的博客 短文-对VitePlus的一点🤏小贡献 | 姓王者的博客 Bing收录没了?亲测有效的快速恢复指南 | 姓王者的博客 解决桌面设备二维码快速识别的工具-ClipQR | 姓王者的博客 解决 Nautilus 自定义终端插件安装依赖问题 | 姓王者的博客 OpenClaw 该熄火了 | 姓王者的博客 Vite8 - 统一的基建开始 | 姓王者的博客 Astro 6 推出啦 | 姓王者的博客 ubuntu的openvpn异常暂停推送更新 | 姓王者的博客 Ubuntu 24.04 安装 Win10 虚拟机 | 姓王者的博客 ESA-后记:热爱阿里云 | 姓王者的博客 Moonbit 0.8.0 重大发布,我也要改一下我的包 | 姓王者的博客 ESA Pages 边缘开发大赛获奖 | 姓王者的博客 从edgeone迁移到esa | 姓王者的博客 出租人类:AI时代的荒诞与真实 | 姓王者的博客 Astro 5.17构建性能优化实践:从18s到13s | 姓王者的博客 Moonbit License Checker 开发使用 | 姓王者的博客 Stalux Astro博客主题自荐 | 姓王者的博客 把Hexo永久链接迁移到Astro | 姓王者的博客
Astro: 优化katex,mermaid和灯箱使用 | 姓王者的博客
作者:xingwangzhe · 2026-02-06 · via 姓王者的博客

🕒 阅读时间:2 分钟 📝 字数:438 👀 阅读量: Loading...

在前文 Astro 5.17构建性能优化实践:从18s到13s中,我已经成功减少了构建时间,这次,通过继续优化 katexmermaid灯箱 的使用,我进一步提升了博客的 客户端构建时 性能。

核心问题

传统的做法通常是在 Layout 中直接 import 对应的 CSS 文件,或者在 astro.config.mjs 中添加全局集成。这会导致在普通的页面,即使没有使用 KaTeX,Mermaid,灯箱 的文章,也会加载这些资源,造成 不必要的性能开销

优化思路:构建时检测

我们利用 Astro 对 Markdown 处理的钩子(Remark 插件),在构建初期就 “预知” 文章的内容特征。

1. 增强内容检测插件

修改 src/utils/remark-post-body.ts,在遍历 Markdown 的 抽象语法树(AST) 时,通过 unist-util-visit 查找特定的节点:

// 伪代码示例

visit(tree, (node: any) => {

if (node.type === "image") hasImage = true;

if (node.type === "math") hasKatex = true;

if (node.type === "code" && node.lang === "mermaid") {

hasMermaid = true;

// 将代码块转换为特定格式以便前端渲染

node.type = "html";

node.value = `<pre class="mermaid">${node.value}</pre>`;

}

});

这些标识位会被自动注入到文章的 remarkPluginFrontmatter 中。

2. 布局层的条件渲染

PostLayout.astro 中,我们可以根据这些标识位,动态引入 样式组件和脚本。由于 astro 文件的 frontmatter 部分是 构建时静态分析 import,为了实现动态注入,我们将样式进行了 组件化包裹,再通过组件引入放在 条件渲染 中:

---

import "katex/dist/katex.min.css";

---

<!-- 无内容,只有frontmatter静态导入的css -->


---

import "photoswipe/dist/photoswipe.css";

---

<!-- 无内容,只有frontmatter静态导入的css -->


---

// 仅在需要时引入组件

import KatexStyle from "@components/stalux/posts/KatexStyle.astro";

import PhotoSwipeStyle from "@components/stalux/posts/PhotoSwipeStyle.astro";

const { hasKatex, hasImage, hasMermaid } = Astro.props;

---

{hasKatex && <KatexStyle />}

{hasImage && <PhotoSwipeStyle />}

<!-- 页面内容 -->

<slot />

{hasMermaid && (

<script>

import mermaid from "mermaid";

// 动态初始化逻辑...

</script>

)}

带来的改变

维度优化措施最终效果
构建性能自动化检测与 按需加载 katex,mermaid,灯箱整体流水线运行效率显著提升,构建速度更快
客户端体验样式与脚本按需加载,适配 astro:page-load页面首屏体积更小,完美兼容视图转换动画

总结

之前还有很多优化,比如说 减少 render 的重复使用,在这里就不说了。总之最后通过优化,时间上从 13s 减少到 11s,客户端的性能也有了质的提升!