# Sflang 专区

> Sflang 是一门用 Rust 实现的轻量级、高速度脚本语言（字节码 VM 架构，语法接近高级语言）。
> 本专区是它的完整学习资源：快速上手、语言指南、参考文档、可直接运行的例子。
> 所有文档均为 UTF-8 纯文本 Markdown，可直接抓取阅读。

## 快速上手

- [快速上手](https://magicdo.top/sf/exam/quickstart.md)：安装、REPL、运行脚本、语法速览，10 分钟入门

## 指南

- [语言指南](https://magicdo.top/sf/exam/guide.md)：24 章完整语言参考——类型系统、运算符、字符串/数组/Object/Map、轻量 OOP、函数、控制流、异常、并发、文件 IO、打印格式化、正则、编码哈希、JSON、datetime、系统与环境、预定义全局变量、help 自省系统

## 参考文档

- [内置函数参考](https://magicdo.top/sf/exam/reference-builtins.md)：732 个内置函数，每个含签名、参数说明、返回值、示例、常见错误（与运行时 help("函数名") 同源，由 cargo run -p sflang --example dump_builtins 自动生成）
- [语言指南](https://magicdo.top/sf/exam/guide.md) 同时是语法参考

## 例子

- [示例索引](https://magicdo.top/sf/exam/examples/README.md)：27 个示例（打印、变量、类型、控制流、函数、异常、并发等）
- 任意示例一条命令运行：`sf --exam examples/<文件名>`（如 `sf --exam examples/sample01_001_hello.sf`）
- 专区根下还有完整程序：[editor.sf](https://magicdo.top/sf/exam/editor.sf)（GUI 代码编辑器，`sf --exam editor.sf`）、[hello.sf](https://magicdo.top/sf/exam/hello.sf)

## 在线 Playground

- [在线 Playground](https://magicdo.top/sf/exam/playground/)：浏览器里直接运行 Sflang（WASM 版，免安装），27 个示例一键载入

## 给 AI agent 的使用要点

- 写 Sflang 脚本前，先查 `reference-builtins.md` 确认函数签名与参数顺序；每个函数都带"常见错误"提示（如参数顺序陷阱）
- 函数文档与运行时的 `help("函数名")` 完全一致，脚本里也可随时自省
- 语言特性优先查 `guide.md` 的对应章节（并发见第 13 章，异常见第 12 章）
- 学习路径：quickstart.md → guide.md 通读 → 用示例验证（examples/ 可直接运行观察输出）
- 官网与本专区同源更新；Sflang 仓库：https://github.com/topxeq/sflang