如果说 “Hello World” 是程序员世界中最无用的程序，那么博客系统大概就是第二名了。真想写博客？直接上 Medium、WordPress，或者干脆发推文就完事了。这世上其实并不缺另一个博客应用。
但就像写 “Hello World” 一样，自己动手写一个静态站点生成器，是快速上手一门新语言的绝佳方式。最近就有人用 Rust 重写了个人博客生成脚本——表面上是为了修复旧代码，实际上嘛，不过是想找点理由写 Rust 罢了。
尽管 Rust 常被贴上“专家级语言”“学习曲线陡峭”的标签，但出人意料的是，它居然非常适合用来干这种“简单粗暴”的活儿：快速、可靠地生成一堆 HTML 文件。原因并不是大家津津乐道的借用检查器（borrow checker）或安全并发模型，而是——
你根本不用自己写太多代码。
依赖即战力：Rust 的“百宝箱”
Rust 的包管理与构建工具 Cargo 让人眼前一亮。只需在 Cargo.toml 里声明几个开源库（Rust 社区称之为 “crates”），剩下的工作就交给别人吧。截至当时，crates.io 上已有超过 29,000 个可用的 crate，安装、编译、使用，一气呵成，毫无障碍。这正是 Rust 生态的魅力所在，开发者可以轻松地站在巨人的肩膀上，借鉴与复用大量优秀的开源项目。
要生成一个像样的博客站点，核心功能其实就三步：
- 解析 Markdown 源文件，转成 HTML
- 对代码片段进行语法高亮（用
<style> 和 CSS 实现）
- 套用模板，把内容嵌入整体页面布局
听起来工程浩大？其实不然。这些功能早有高人实现好了，你只需要“拿来主义”：
[dependencies]
maud = "*"
pulldown-cmark = "*"
syntect = "3.0"
pulldown-cmark：Markdown 解析器syntect：代码语法高亮神器maud：轻量又高效的 HTML 模板引擎
不过，实际开发中还是加了几个辅助工具：
[dependencies]
maud = "*"
pulldown-cmark = "*"
regex = "*"
lazy_static = "*"
syntect = "3.0"
chrono = "*"
clap = "*"
ordinal = "*"
有意思的是，Rust 标准库异常精简——像正则表达式、日期时间处理这类在其他语言里“内置”的功能，在 Rust 中都交给了社区 crate 来实现（比如 regex 和 chrono）。
执行一句：
$ cargo build --release
Cargo 自动拉取所有依赖，编译整合，两分半钟搞定。整个过程丝滑得让人怀疑人生。
三剑客登场：Pulldown-cmark、Syntect 与 Maud
1. Pulldown-cmark：Markdown 转 HTML，一行不写
有了 pulldown-cmark，转换 Markdown 几乎是“复制粘贴”级别的操作：
let parser = Parser::new(&markdown);
let mut html = String::new();
html::push_html(&mut html, parser);
三行代码：创建解析器 → 准备输出字符串 → 渲染 HTML。干净利落。
唯一需要额外处理的是文章头部的元数据。例如：
title: “深入 PostgreSQL 的 GiST 索引”
date: 2017/12/15
tag: the Postgres LTREE Extension
这些不是正文内容，得先剥离。于是写了个小函数跳过“头信息”：
fn other_lines(lines: &Vec<String>) -> Vec<String> {
lines.iter()
.skip_while(|l| is_header(l))
.map(|l| l.to_string())
.collect()
}
逻辑清晰：遍历每一行，跳过头部，收集剩余内容。最后拼成完整 Markdown 字符串，喂给 pulldown-cmark 即可。
2. Syntect：让代码穿上彩衣
生成的 HTML 还要经过一道“美化工序”——语法高亮。博客中的代码块通常这样写：
<pre type=”ruby”>
puts “这是我在讲的 Ruby 代码…”
</pre>
靠 type 属性标明语言，然后交给 syntect 处理。
虽然语法高亮背后涉及词法分析、语义识别、样式映射等复杂逻辑，但使用起来却异常简单。借助 lazy_static（另一个省心的 crate），只需初始化一次资源：
lazy_static! {
static ref SYNTAX_SET: SyntaxSet = SyntaxSet::load_from_folder(syntax_path()).unwrap();
static ref THEME: Theme = ThemeSet::get_theme(theme_path().as_path()).unwrap();
static ref RUBY_SYNTAX: &‘static SyntaxReference =
SYNTAX_SET.find_syntax_by_extension(“rb”).unwrap();
static ref RUST_SYNTAX: &‘static SyntaxReference =
SYNTAX_SET.find_syntax_by_extension(“rs”).unwrap();
}
这里用的是 Sublime Text 的语法定义文件和主题文件（没错，Vim 用户也能用 Sublime 的高亮规则）。这些文件提前下载好，随项目一起提交。
之后根据 <pre> 标签的 type 属性判断语言，调用 highlighted_html_for_string，自动生成带颜色的 HTML 片段。整个过程如同“自动配色机器人”，精准又高效。
3. Maud：模板？不如说是“HTML 写在 Rust 里”
最后一步：把生成的内容塞进页面模板。Rust 没有 ERB 或 Mustache 那样的传统模板引擎，但 Maud 提供了一种更酷的方式——直接在 Rust 代码里写 HTML，还带类型安全！
比如这样：
@if let Some(ref t) = post.tag {
div class=”header” {
“More on “ (t)
}
}
看起来像模板，实则是合法的 Rust 代码。Maud 在编译期就把这些结构转成高效的字符串拼接，既安全又快速。
Maud 并不会像 Ruby 中的 ERB 那样在运行时解析模板代码。上面出现的 @if 和 @for 指令，其实都是宏。更进一步说，连那些 HTML 标签，比如 div 和 ul，本质上也全都是宏。这意味着，写的 Maud 模板实际上就是一段合法的 Rust 代码。而这段代码，在编译阶段就会被 Rust 编译器严格检查，确保语法和逻辑无误后才会通过——相当于在程序跑起来之前，先过了一道“安检”。
把旧的 ERB 模板一步步转换成 Rust 宏的过程，确实有点繁琐，像是在搬砖。但这个过程却意外地成了对老 HTML 代码的一次深度“体检”。十年来藏在角落里的各种拼写错误、结构问题，就像压箱底的旧衣服一样被翻了出来。把这些“陈年旧账”摊开给 Rust 编译器看，它毫不留情地一一指出。等到最终顺利通过编译时，整个页面结构已经焕然一新，干净利落。这种编译期检查带来的健壮性提升，是许多动态语言运行时模板难以比拟的。
那么，这一切值得吗？
整个迁移过程断断续续花了好几个月，每次挤出一两个小时推进一点。如果是经验丰富的 Rust 工程师全职来做，大概一两天就能搞定。但投入这么多时间，到底换来了什么？
最直观的，是构建速度的飞跃。原来的 Ruby 脚本处理 146 篇 Markdown 博客，需要 7.7 秒；而新的 Rust 版本，仅需 0.28 秒。快了整整 27 倍以上！速度快到什么程度？根本不需要像 Makefile 那样去比对文件时间戳，判断哪些需要重新编译；甚至也不必动用多线程并行处理。为什么？因为当你按下回车、抬起头的瞬间，Rust 已经默默把所有文件按顺序处理完了——快得让你来不及反应。
不过，真正带来质变的，并不只是性能。更大的收获，其实是健壮性的提升。这背后的关键，正是 Rust 强制要求使用的 Result<T> 类型。它像一位严格的导师，逼着你去思考：每一步操作可能出什么错？出错了又该如何应对？虽然前面没细说，但这套机制让整个脚本变得异常可靠。面对源文件里的小疏漏，不再崩溃退出，而是给出清晰友好的提示信息。既防得了手抖，也扛得住意外。这种对错误的优雅处理，本身就是一种极佳的技术文档实践。
当然，最大的回报，还是爬上了 Rust 学习曲线的一小段陡坡。而这趟攀登之所以可行，离不开 crates.io 和 Cargo 的鼎力支持。只需几条简单命令，就能引入高手们精心打磨的开源库。站在巨人的肩膀上，即便是初学者，也能搭出实用且高效的工具。如果你对这类使用Rust等现代技术栈解决实际问题的实战项目感兴趣，欢迎到云栈社区与其他开发者交流探讨。
参考链接: https://patshaughnessy.net/2019/9/4/using-rust-to-build-a-blog-site
发表于 昨天 04:44
|
查看: 10|
回复: 0
