Pebble

这是什么#

Pebble 是一门我用 Rust 从零写出来的小型脚本语言，也是一份 “用一个真实项目把 Rust 学完” 的教材底稿。它不是单文件 demo：整套东西拆成了一个 Cargo 工作区，每个 crate 都负责让 Rust 的某一个角落真正干活。

语言本身支持：let 绑定、fn 与闭包、if/while/for、return/break/continue、整数与浮点、字符串、列表 [...]、映射 #{...}、索引与赋值、以及一组内建函数（print、len、range、push 等）。

从零学 Rust 系列#

我把这个项目拆成了 15 篇边写边学的教程：从一个空目录和 cargo new 开始，一章一个 crate，把 Pebble 重新搭一遍。每一章都有可以对照的检查点，读者不需要去别处查资料。

• 从第 1 篇开始：第一个 crate：从 cargo new 到 Span
• 全部 15 篇：见 系列页

两个后端#

同一个前端，两套执行引擎：

• 树遍历解释器：直接走 AST，用 Rc<RefCell<..>> 组成作用域链。写起来最直观，也最能暴露引用计数的循环引用问题。
• 字节码 VM：把 AST 编译成指令流，在栈式虚拟机上执行，运行时对象全部落在手写的标记清除垃圾回收器上。递归闭包形成的环因此可以被回收。

两个后端并不完全一致：块内的 let 在树遍历解释器里有自己的作用域，在 VM 里每次调用只有一个环境；嵌套的 for 在 VM 里还有已知的问题。第 10 篇和第 12 篇会把这些差异摆出来。仓库里的差分测试（#[differential]）只收录两边确实一致的程序。

工作区结构#

怎么跑#

1
nix develop          # 或系统 Rust >= 1.88
2
cargo build --workspace
3

4
cargo run -p pebble-cli -- run examples/fib.pebble
5
cargo run -p pebble-cli -- run --vm examples/fib.pebble
6
cargo run -p pebble-cli -- check examples/fib.pebble examples/hello.pebble
7
cargo run -p pebble-cli -- repl