# Sflang 快速上手

> 10 分钟跑起来，然后按需要深入：[语言指南](guide.md) · [内置函数参考](reference-builtins.md) · [示例索引](examples/README.md)

## 1. 安装

**Windows（PowerShell）：**

```powershell
irm https://magicdo.top/install/sf.ps1 | iex
```

**Linux / macOS：**

```bash
curl -fsSL https://magicdo.top/install/sf.sh | bash
```

也可以从[仙缘渡官网](https://magicdo.top/)手动下载对应平台的二进制。主程序名 `sf`（Windows 下 `sf.exe`），单文件、无依赖。

## 2. 第一个程序

交互式 REPL（不带参数启动）：

```text
$ sf
sf> println("Hello, Sflang!")
Hello, Sflang!
sf> 1 + 2 * 3
7
sf> help("strSplit")     // 查任意内置函数的文档
sf> exit
```

执行脚本文件：

```bash
sf hello.sf              # 脚本参数从 argsG 读取
sf -e 'pln(1 + 2)'       # 直接执行一行代码
```

跑专区示例（无需下载，自动从本专区获取）：

```bash
sf --exam hello.sf                                  # 专区根下的脚本
sf --exam examples/sample01_001_hello.sf            # 子目录里的示例
```

## 3. 语法速览

```sflang
// 变量与类型（动态类型，23 种类型）
var name = "Sflang"          // var 声明局部变量；:= 声明全局变量
var n = 42
pln("你好，${name}！${n + 1}") // 字符串插值

// 分支与循环
if n > 10 {
    pln("big")
} elif n > 0 {
    pln("small")
} else {
    pln("non-positive")
}

for i in range(5) { pln(i) }        // 0..4
for i, v in ["a", "b"] { pln(i, v) }

// 函数（支持默认参数、可变参数、闭包）
func add(a, b = 1) { return a + b }
pln(add(41))                        // 42

// 集合
var arr = [1, 2, 3]
var obj = {name: "sf", ver: 1}      // object：可挂方法做轻量 OOP
var m = map{k: 1, j: 2}             // 有序 map

// 错误处理（返回错误对象为主，也可用 try/catch）
var r = parseInt("abc")
if isErr(r) { pln("出错了：", r) }

// 并发（goroutine 式）
run func() { pln("后台任务") }
```

## 4. 下一步

- [语言指南](guide.md)：24 章完整语言参考（类型、OOP、并发、文件 IO、JSON……）
- [内置函数参考](reference-builtins.md)：732 个内置函数，含签名、参数、示例、常见错误
- [示例索引](examples/README.md)：27 个可运行示例，`sf --exam examples/<名>` 直接跑
- AI 集成：[llms.txt](llms.txt) 是面向 AI agent 的专区导航