# 玄铁语言参考手册

> **对标版本**：XTC v1.0-rc（版本变更记录见根目录 [versionLog.md](../versionLog.md)，手册内不再逐条标注新增版本）

欢迎来到玄铁的官方文档。**玄铁是一门全中文关键字、编译到原生机器码的系统级编程语言**：自举编译器（编译器本身由玄铁写成）、静态类型、ARC 内存管理，并附带桌面 2D 渲染与声明式 UI 官方库。

本介绍页仅为您提供一份玄铁的模糊画像和文档地图；每个特性与功能的细节都放在独立的章节里，可按需点入。

示例：
```xuantie
设 问候 = "你好，世界"
示(问候)

函 斐波(n) {
    若 n < 2 { 返 n }
    返 斐波(n - 1) + 斐波(n - 2)
}
示("斐波(20) = " & 字(斐波(20)))
```
代码实际输出：
```bash
你好，世界
斐波(20) = 6765
```

## 设计理念

-   **全中文语法**：关键字即自然语言词汇；返回布尔的函数可以以 `?` 结尾（`文件.存在?`），代码读起来像提问。
-   **宁可报错，也不静默**：明确的编程错误，编译期能拦则拦；运行期拦不住就带定位信息退出，绝不静默跳过。
-   **错误处理显式化**：可能失败的操作返回 `结果` 容器，`?` 后缀把错误向上冒泡，控制流一眼可见。
-   **一个源文件到一个原生 exe**：无虚拟机、无外部运行时依赖，拷走即跑。

## 文档的结构
  
-   **手册章节**（速查参考，可按任意顺序翻阅）：
    [1 词法与基础语法](手册/01_词法与基础语法.md) ·
    [2 类型系统现状](手册/02_类型系统现状.md) ·
    [3 控制流体系](手册/03_控制流体系.md) ·
    [4 面向对象与类系统](手册/04_面向对象与类系统.md) ·
    [5 模块系统](手册/05_模块系统.md) ·
    [6 标准库与 Runtime API](手册/06_标准库与RuntimeAPI.md) ·
    [7 类型系统哲学设计](手册/07_类型系统哲学设计.md) ·
    [8 网络与并发](手册/08_网络与并发.md) ·
    [9 渲染库](手册/09_渲染库.md) ·
    [10 声明式 UI 库](手册/10_声明式UI库.md)
-   **编程指南**（专题教程，讲透一个主题）：
    [01 结果类型与错误处理](01_结果类型与错误处理.md) ·
    [02 类型系统哲学设计](02_类型系统哲学设计.md) ·
    [03 泛型](03_泛型编程指南.md) ·
    [04 弱引用](04_弱引用编程指南.md) ·
    [05 模块系统](05_模块系统.md) ·
    [06 数组](06_数组编程指南.md) ·
    [07 铁铺包管理](07_铁铺使用指南.md) ·
    [08 网络与并发](08_网络与并发编程指南.md) ·
    [09 渲染库](09_渲染库编程指南.md) ·
    [10 运算符重载](10_运算符重载编程指南.md) ·
    [11 多线程](11_多线程开发深度教程.md) ·
    [12 UI 库](12_UI库编程指南.md)
-   **关键字速查**：
       直接去[手册第 1 章](手册/01_词法与基础语法.md)的关键字清单逐个点入。

## 从哪开始

若您是个小白，可先扫一遍 [手册第 1 章](手册/01_词法与基础语法.md) 认识关键字的“脸”，再从 [01 结果类型与错误处理](01_结果类型与错误处理.md) 进入指南序列；想做桌面程序就直接去 [09 渲染库](09_渲染库编程指南.md) 与 [12 UI 库](12_UI库编程指南.md)。

想立刻看到效果，用 `xtc pao 你的文件.xt`（编译后立即运行，等价于 `go run`）。

手册面向语言使用者（语法层）；版本演进见 [更新日志](../versionLog.md)。