zz

chai2010 · chai2010 · commit 88b62d244bc4 · 2025-06-05T11:25:40.000+08:00
diff --git a/SUMMARY.md b/SUMMARY.md
@@ -43,7 +43,7 @@
   - [非空接口](chs/8.接口/8.2.非空接口.md)
   - [类型断言总结](chs/8.接口/8.3.类型断言总结.md)
   - [接口的其它特性](chs/8.接口/8.4.接口的其它特性.md)
-* [与宿主环境交互](chs/9.接口/readme.md)
+* [与宿主环境交互](chs/9.与宿主环境交互/readme.md)
 * [附录](chs/10.附录/readme.md)
   - [语言规范](chs/10.附录/a-spec.md)
   - [标准库](chs/10.附录/b-std.md)
diff --git a/chs/2.安装及入门/2.1.安装凹语言.md b/chs/2.安装及入门/2.1.安装凹语言.md
@@ -1,8 +1,8 @@
-## 1.1. 安装凹语言
+## 2.1. 安装凹语言
 
 除了访问在线的凹语言 Playground，也可以在本地安装凹语言。
 
-### 1.1.1 二进制安装
+### 2.1.1 二进制安装
 
 从 Github 下载最新的二进制文件：[https://github.com/wa-lang/wa/releases](https://github.com/wa-lang/wa/releases) 。需要确保和本地平台对应，比如 v0.8.1 对应 macOS/amd64 平台下载的是 [wa_0.8.1_darwin_amd64.tar.gz](https://github.com/wa-lang/wa/releases/download/v0.8.1/wa_0.8.1_darwin_amd64.tar.gz)。
 
@@ -30,7 +30,7 @@ Wa version v0.8.1
 
 到此安装工作完成。
 
-### 1.1.2 从源码安装
+### 2.1.2 从源码安装
 
 本地要求安装 Go1.17+ 版本，然后执行以下命令安装最新的 `wa` 命令：
 
@@ -45,15 +45,15 @@ go install wa-lang.org/wa
 
 到此安装工作完成。
 
-### 1.1.3 Homebrew (MacOS & Linux)
+### 2.1.3 Homebrew (MacOS & Linux)
 
 对于 macOS 和 Linux 系统也可以通过 Homebrew 安装：
 
 ```
 brew install wa-lang/tap/wa
 ```
 
-### 1.1.4 Scoop (Windows)
+### 2.1.4 Scoop (Windows)
 
 对于 Windows 系统也可以通过 Scoop 安装：
 
@@ -62,7 +62,7 @@ scoop bucket add wa-lang https://github.com/wa-lang/scoop-bucket.git
 scoop install wa-lang/wa
 ```
 
-### 1.1.5 本地 Playground
+### 2.1.5 本地 Playground
 
 安装成功之后，在命令行输入 `wa play` 可以打开本地 Playground。程序会默认打开浏览器页面，也可以输入 [http://localhost:2023/](http://localhost:2023/) 地址访问。效果如下：
 
diff --git a/chs/2.安装及入门/2.2.你好凹语言.md b/chs/2.安装及入门/2.2.你好凹语言.md
@@ -1,8 +1,8 @@
-## 1.2. 你好，凹语言
+## 2.2. 你好，凹语言
 
 打印“hello world”是C语言之后的惯用案例，凹语言例子打印的是中文“你好，凹语言！”。
 
-### 1.2.1 你好，凹语言！
+### 2.2.1 你好，凹语言！
 
 创建 hello.wa 文件，内容如下：
 
@@ -37,7 +37,7 @@ $ wa run hello.wa
 1+1 = 2
 ```
 
-### 1.2.2 在线的 Playground
+### 2.2.2 在线的 Playground
 
 凹语言是面向 WebAssembly 设计的通用编程语言，从诞生起就将浏览器作为第一支持目标。可以通过 [https://wa-lang.org/playground](https://wa-lang.org/playground) 访问 Playground，界面如下：
 
diff --git a/chs/2.安装及入门/2.3.命令行功能.md b/chs/2.安装及入门/2.3.命令行功能.md
@@ -1,8 +1,8 @@
-## 1.3. 命令行功能
+## 2.3. 命令行功能
 
 本节介绍 `wa` 命令主要功能。
 
-### 1.3.1. 帮助信息
+### 2.3.1. 帮助信息
 
 输入 `wa` 命令或 `wa -h` 可查看命令行帮助信息，如下：
 
@@ -52,7 +52,7 @@ See "https://wa-lang.org" for more information.
 
 其中 build 命令在 1.1.1 节展示过，play 命令已经在 1.2.5 节展示过，本节简要介绍之外的子命令。
 
-### 1.3.2 初始化工程
+### 2.3.2 初始化工程
 
 在 1.1.1 节已经展示过 `wa run hello.wa` 执行一个独立文件的凹语言程序。但是单文件的凹语言程序有一个巨大的限制——它只有一个文件且不能引用非标准库的代码。对于更大的凹程序推荐用凹工程的方式组织。
 
@@ -99,7 +99,7 @@ hello
 
 工程的结构在 1.4 节介绍。
 
-### 1.3.3 编译和执行
+### 2.3.3 编译和执行
 
 命令行环境进入 hello 目录，输入 `wa build` 将在 output 目录构建出 wasm 模块：
 
@@ -124,7 +124,7 @@ $ wa run ./output/hello.wasm
 
 如果不带参数执行 `wa run` 命令，表示编译并执行当前凹语言工程，会先构建出 `output/hello.wasm` 然后再执行。
 
-### 1.3.4 格式化代码
+### 2.3.4 格式化代码
 
 `wa fmt` 命令用于格式化代码，其命令行帮助信息如下：
 
@@ -148,7 +148,7 @@ OPTIONS:
 
 如果不指定参数，则默认格式化当前目录下全部的凹语言文件。如果当前目录属于凹语言工程中，则默认格式化全部子目录的凹语言文件。
 
-### 1.3.5 单元测试
+### 2.3.5 单元测试
 
 默认生成的工程会有一个 `src/zz_test.wa` 测试文件，内容如下：
 
@@ -174,10 +174,10 @@ $ wa test
 ok   myapp 104ms
 ```
 
-### 1.3.6 凹语言版本的 yacc
+### 2.3.6 凹语言版本的 yacc
 
 yacc 是用于生成语法解析器的程序，是编译器爱好者的工具。凹语言的 yacc 从 goyacc 移植而来，详细的用法可以参考凹语言官网碎碎念部分的 [相关文章](https://wa-lang.org/smalltalk/st0021.html)。
 
-### 1.3.7 打印 Logo
+### 2.3.7 打印 Logo
 
 `wa logo` 可以输出一些文本格式的 Logo 图案，读者可以通过 `wa logo -h` 命令帮助自行探索。
diff --git a/chs/2.安装及入门/2.4.工程目录结构.md b/chs/2.安装及入门/2.4.工程目录结构.md
@@ -1,8 +1,8 @@
-## 1.4. 工程目录结构
+## 2.4. 工程目录结构
 
 工程目录结构是整个外围工具工作的基础，比如 init 根据该结构生成工程、包管理工具则依次管理依赖关系。
 
-### 1.4.1 工程目录结构简介
+### 2.4.1 工程目录结构简介
 
 凹语言程序以包来组织代码，包可以是一个单文件，包也可以是一个目录。凹语言自带的 `waroot/examples/hello` 案例的是一个更为完整的工程，其目录结构如下：
 
@@ -33,7 +33,7 @@ version = "0.0.1"
 
 其中 pkgpath 表示当前包的路径，从而可以推导出 mymath 子目录对应的包路径为 `"myapp/mymath"`。vendor 目录是依赖的第三方代码，其中 `vendor/3rdparty/pkg` 对应的包路径为 `"3rdparty/pkg"`。
 
-### 1.4.2 包管理工具
+### 2.4.2 包管理工具
 
 凹语言目前还没有包管理工具，如果依赖第三方包则需要手工同步 vendor 目录。开发组希望在 MVP 版本后启动包管理工具开放工作。
 
diff --git a/chs/2.安装及入门/2.5.IDE插件.md b/chs/2.安装及入门/2.5.IDE插件.md
@@ -1,24 +1,24 @@
-## 1.5. IDE插件
+## 2.5. IDE插件
 
 现代化的编程语言一般都会为各种IDE和编辑器提供扩展，以提高编程的体验。凹语言为 VS Code、Fleet 和 Vim 提供了基本插件支持。
 
-### 1.5.1 VS Code 插件
+### 2.5.1 VS Code 插件
 
 在 VS Code 扩展商店检索 “wa” 即可以查到凹语言插件。安装之后会有基本的语法高亮等功能。
 
 VS Code 效果如下：
 
 ![](./images/vscode.png)
 
-### 1.5.2 Fleet 插件
+### 2.5.2 Fleet 插件
 
 Fleet 插件仓库：[https://github.com/wa-lang/fleet-wa](https://github.com/wa-lang/fleet-wa)
 
 根据仓库提示安装，效果如下：
 
 ![](./images/fleet-wa-screenshot.png)
 
-### 1.5.3 Vim 插件
+### 2.5.3 Vim 插件
 
 Vim 插件仓库：[https://github.com/wa-lang/vim-wa](https://github.com/wa-lang/vim-wa)
 
@@ -28,6 +28,6 @@ Vim 插件仓库：[https://github.com/wa-lang/vim-wa](https://github.com/wa-lan
 
 > 在编写文档过程中突然得知 Vim 的作者 Bram Moolenaar 去世，谨以此插件祝愿 Vim 永垂不朽！
 
-### 1.5.4 其他编辑器
+### 2.5.4 其他编辑器
 
 MVP 之后凹语言的语法已经基本固定，希望社区可以参与其他编辑器支持共建。
diff --git a/chs/2.安装及入门/readme.md b/chs/2.安装及入门/readme.md
@@ -1,3 +1,3 @@
-# 1. 安装及入门
+# 2. 安装及入门
 
 本章讲述了最简单的凹语言例子、如何安装凹语言程序、凹语言IDE插件、凹语言工程目录结构和命令行功能等内容。
diff --git a/chs/3.程序结构/3.1.全局声明.md b/chs/3.程序结构/3.1.全局声明.md
@@ -1,4 +1,4 @@
-## 2.1. 全局声明
+## 3.1. 全局声明
 
 一个典型的 凹语言 程序源码如下例所示：
 
diff --git a/chs/3.程序结构/3.2.全局变量声明.md b/chs/3.程序结构/3.2.全局变量声明.md
@@ -1,4 +1,4 @@
-## 2.2. 全局变量声明
+## 3.2. 全局变量声明
 
 全局变量声明以关键字 `global` 开始，一般语法如下：
 
diff --git a/chs/3.程序结构/3.3.函数声明.md b/chs/3.程序结构/3.3.函数声明.md
@@ -1,4 +1,4 @@
-## 2.3. 函数声明
+## 3.3. 函数声明
 
 函数声明以关键字 `func` 开始，一般语法如下：
 
diff --git a/chs/3.程序结构/3.4.常量声明.md b/chs/3.程序结构/3.4.常量声明.md
@@ -1,4 +1,4 @@
-## 2.4. 常量声明
+## 3.4. 常量声明
 
 常量声明以关键字 `const` 开始，一般语法如下：
 
diff --git a/chs/3.程序结构/3.5.导入声明.md b/chs/3.程序结构/3.5.导入声明.md
@@ -1,4 +1,4 @@
-## 2.5. 导入声明
+## 3.5. 导入声明
 
 导入声明以关键字 `import` 开始，一般语法如下：
 
diff --git a/chs/3.程序结构/readme.md b/chs/3.程序结构/readme.md
@@ -1,3 +1,3 @@
-# 2. 程序结构
+# 3. 程序结构
 
 凹语言和其他编程语言一样，一个大的程序是由很多小的部分组成的。本章介绍全局变量声明、函数声明、常量声明、导入声明和类型声明。
diff --git a/chs/4.基础数据类型/4.1.局部变量声明.md b/chs/4.基础数据类型/4.1.局部变量声明.md
@@ -1,4 +1,4 @@
-## 3.1. 局部变量声明
+## 4.1. 局部变量声明
 
 第2章介绍了全局变量和常量声明，同样常用的还有局部变量（函数内部定义的变量）声明，它的一般语法为：
 
diff --git a/chs/4.基础数据类型/4.2.整数.md b/chs/4.基础数据类型/4.2.整数.md
@@ -1,4 +1,4 @@
-## 3.2. 整数
+## 4.2. 整数
 
 凹语言目前支持以下几种整数类型：
 
diff --git a/chs/4.基础数据类型/4.3.浮点数.md b/chs/4.基础数据类型/4.3.浮点数.md
@@ -1,4 +1,4 @@
-## 3.3. 浮点数
+## 4.3. 浮点数
 
 凹语言目前支持以下两种浮点数（均为IEEE 754标准）：
 
diff --git a/chs/4.基础数据类型/4.4.字符串.md b/chs/4.基础数据类型/4.4.字符串.md
@@ -1,4 +1,4 @@
-## 3.4. 字符串
+## 4.4. 字符串
 
 字符串在凹语言中被视为基础数据类型，类型名称为：`string`，字符串字面常量通过双引号 `""` 括起定义，采用 UTF-8 编码，例如：
 
diff --git a/chs/4.基础数据类型/readme.md b/chs/4.基础数据类型/readme.md
@@ -1,3 +1,3 @@
-# 3. 基础数据类型
+# 4. 基础数据类型
 
 从底层而言，所有的数据都是由比特组成。对应的凹语言基础数据类型有整型数、浮点数、字符串等。本章介绍基本数据类型以及局部变量的使用。
diff --git a/chs/5.函数/5.1.函数调用.md b/chs/5.函数/5.1.函数调用.md
@@ -1,4 +1,4 @@
-## 4.1. 函数调用
+## 5.1. 函数调用
 
 我们在之前的章节中已接触过很多函数，比如常用的内置打印函数 `println`。函数调用的一般语法为：
 
diff --git a/chs/5.函数/5.2.函数值.md b/chs/5.函数/5.2.函数值.md
@@ -1,4 +1,4 @@
-## 4.2. 函数值
+## 5.2. 函数值
 
 在凹语言中，函数可以被当作一种特殊的值，例如：
 ```wa
diff --git a/chs/5.函数/5.3.匿名函数及闭包.md b/chs/5.函数/5.3.匿名函数及闭包.md
@@ -1,4 +1,4 @@
-## 4.3. 匿名函数及闭包
+## 5.3. 匿名函数及闭包
 
 上一节介绍了函数值的基本用法，既然函数可被视为值，那么，在凹语言函数内部，是否可以像声明基本类型字面量那样，声明函数字面量？答案是肯定的，例如：
 ```wa
diff --git a/chs/5.函数/5.4.条件语句.md b/chs/5.函数/5.4.条件语句.md
@@ -1,4 +1,4 @@
-## 4.4. 条件语句
+## 5.4. 条件语句
 
 条件语句的一般形式为：
 ```wa
diff --git a/chs/5.函数/5.5.循环语句.md b/chs/5.函数/5.5.循环语句.md
@@ -1,4 +1,4 @@
-## 4.5. 循环语句
+## 5.5. 循环语句
 
 循环语句有三种基本形式：
 ```wa
diff --git a/chs/5.函数/5.6.分支语句.md b/chs/5.函数/5.6.分支语句.md
@@ -1,4 +1,4 @@
-## 4.6. 分支语句
+## 5.6. 分支语句
 
 分支语句常用于替代多重条件语句，一般形式为：
 ```wa
diff --git a/chs/5.函数/readme.md b/chs/5.函数/readme.md
@@ -1,3 +1,3 @@
-# 4. 函数
+# 5. 函数
 
 函数是语句序列的打包，以便于被多次重复使用。本章介绍凹语言函数基本用法，以及函数值、匿名函数和闭包等特性。
diff --git a/chs/6.复合数据类型/6.1.引用.md b/chs/6.复合数据类型/6.1.引用.md
@@ -1,4 +1,4 @@
-## 5.1. 引用
+## 6.1. 引用
 
 在凹语言中，在一个变量前添加 `&` 符号被称为 **取引用** 操作，假设该变量的类型为 `T`，取引用操作返回值的类型为 `*T`，被称为 **T型引用**，例如：
 ```wa
diff --git a/chs/6.复合数据类型/6.2.数组.md b/chs/6.复合数据类型/6.2.数组.md
@@ -1,4 +1,4 @@
-## 5.2. 数组
+## 6.2. 数组
 
 数组类型的基本声明如下：
 ```wa
diff --git a/chs/6.复合数据类型/6.3.切片.md b/chs/6.复合数据类型/6.3.切片.md
@@ -1,4 +1,4 @@
-## 5.3. 切片
+## 6.3. 切片
 
 切片类型的基本声明如下，`T` 为元素类型：
 ```wa
diff --git a/chs/6.复合数据类型/readme.md b/chs/6.复合数据类型/readme.md
@@ -1,4 +1,4 @@
-# 5. 复合数据类型
+# 6. 复合数据类型
 
 复合数据类型是内置的复杂类型的基础。
 
diff --git a/chs/7.自定义类型/7.1.结构体.md b/chs/7.自定义类型/7.1.结构体.md
@@ -1,4 +1,4 @@
-## 6.1. 结构体
+## 7.1. 结构体
 
 凹语言中结构体声明的一般形式为：
 ```wa
diff --git a/chs/7.自定义类型/7.2.方法.md b/chs/7.自定义类型/7.2.方法.md
@@ -1,4 +1,4 @@
-## 6.2. 方法
+## 7.2. 方法
 
 自定义类型除了可以通过结构体达到对成员数据的封装外，最大的作用是它们可以拥有**方法**。在凹语言中，**方法**是一类特殊的、依附于特定类型的函数，见下例：
 ```wa
diff --git a/chs/7.自定义类型/7.3.方法值.md b/chs/7.自定义类型/7.3.方法值.md
@@ -1,4 +1,4 @@
-## 6.3. 方法值
+## 7.3. 方法值
 
 由于方法也是函数，因此可以仿照 4.2 节的模式使用它，例如：
 ```wa
diff --git a/chs/7.自定义类型/7.4.嵌入结构体.md b/chs/7.自定义类型/7.4.嵌入结构体.md
@@ -1,4 +1,4 @@
-## 6.4. 嵌入结构体
+## 7.4. 嵌入结构体
 
 在声明结构体类型时，如果某个成员的类型是结构体，但省略该成员的名称，这种用法被称为**嵌入结构体**，例如下面代码中，结构体 `Sc` 中嵌入了 `Sp` 成员：
 ```wa
diff --git a/chs/7.自定义类型/7.5.匿名结构体.md b/chs/7.自定义类型/7.5.匿名结构体.md
@@ -1,4 +1,4 @@
-## 6.5. 匿名结构体
+## 7.5. 匿名结构体
 
 在本章前几节中，我们使用到的结构体都是按以下形式声明的：
 ```wa
diff --git a/chs/7.自定义类型/readme.md b/chs/7.自定义类型/readme.md
@@ -1,3 +1,3 @@
-# 6. 自定义类型
+# 7. 自定义类型
 
 自定义类型包括结构体、以及围绕结构体方法产生的接口。
diff --git a/chs/8.接口/8.1.空接口-万能封包器.md b/chs/8.接口/8.1.空接口-万能封包器.md
@@ -1,4 +1,4 @@
-## 7.1. 空接口-万能封包器
+## 8.1. 空接口-万能封包器
 
 在凹语言中，最简单的接口是空接口，既 `interface {}`，声明接口类型变量的方法跟其它类型一致，例如下面的代码声明了一个名为 `i` 的空接口变量：
 ```wa
diff --git a/chs/8.接口/8.2.非空接口.md b/chs/8.接口/8.2.非空接口.md
@@ -1,4 +1,4 @@
-## 7.2. 非空接口
+## 8.2. 非空接口
 
 接口是方法的集合，接口声明的一般形式如下：
 ```wa
diff --git a/chs/8.接口/8.3.类型断言总结.md b/chs/8.接口/8.3.类型断言总结.md
@@ -1,4 +1,4 @@
-## 7.3. 类型断言总结
+## 8.3. 类型断言总结
 
 7.1节介绍了如何从类型为 `interface{}` 的接口值中通过类型断言获取它所包含的具体值，该用法对于非空接口值依然成立，例如：
 ```wa
diff --git a/chs/8.接口/8.4.接口的其它特性.md b/chs/8.接口/8.4.接口的其它特性.md
@@ -1,4 +1,4 @@
-## 7.4. 接口的其它特性
+## 8.4. 接口的其它特性
 
 在声明接口时，接口的方法集可以包含另一个接口，例如：
 ```wa
diff --git a/chs/8.接口/readme.md b/chs/8.接口/readme.md
@@ -1,4 +1,4 @@
-# 7. 接口
+# 8. 接口
 
 接口是凹语言抽象能力的灵魂。未使用接口的凹语言代码都是纯正的写实派，但是有了接口之后就可以通过鸭子类型的面向对象来达到抽象的目的。本章讲述接口的基本用法。
 
diff --git a/chs/9.接口/readme.md b/chs/9.接口/readme.md
