Zig 语言 #

文档结构 #

本指南按以下结构组织，适合初学者按顺序学习：

1. 基础入门 #

主题	描述	文档链接
Zig简介	Zig的发展历史、特点、应用领域	zig-intro.md
安装与运行	Windows/Mac/Linux安装，环境配置	zig-install.md
第一个Zig程序	Hello World，编译与运行	hello-world.md
基础语法	注释、标识符、关键字、代码规范	zig-syntax.md

2. 数据类型 #

主题	描述	文档链接
变量与常量	变量定义、const、var、comptime	variables.md
基本数据类型	整数、浮点数、布尔、字符	basic-types.md
复合类型	数组、切片、元组	compound-types.md
可选类型	?T、null、orelse、catch	optional.md
错误联合类型	!T、try、catch、errdefer	error-union.md

3. 控制流 #

主题	描述	文档链接
条件语句	if、if-else、if表达式	if-statement.md
switch语句	switch-case、switch表达式	switch-statement.md
循环语句	while、for、inline循环	loops.md
循环控制	break、continue、标签	loop-control.md

4. 函数 #

主题	描述	文档链接
函数基础	函数定义、参数、返回值	function-basics.md
错误处理函数	try、catch、错误传播	error-handling-func.md
泛型函数	comptime参数、泛型实现	generic-functions.md
函数指针	函数指针类型、回调函数	function-pointers.md

5. 指针 #

主题	描述	文档链接
指针基础	单指针、多指针、指针语法	pointer-basics.md
指针与切片	切片指针、指针运算	pointer-slice.md
指针安全	指针对齐、空指针检查	pointer-safety.md

6. 数组与字符串 #

主题	描述	文档链接
数组	数组声明、初始化、遍历	arrays.md
切片	切片创建、切片操作	slices.md
字符串	字符串定义、字符串操作	strings.md
字符串格式化	fmt包、格式化输出	string-format.md

7. 结构体 #

主题	描述	文档链接
结构体基础	结构体定义、初始化、访问	struct-basics.md
结构体方法	方法定义、self参数	struct-methods.md
结构体嵌套	嵌套结构体、匿名结构体	struct-nesting.md

8. 内存管理 #

主题	描述	文档链接
内存分配器	Allocator接口、常用分配器	allocator.md
内存布局	内存对齐、padding	memory-layout.md
自定义分配器	ArenaAllocator、GeneralPurposeAllocator	custom-allocator.md

9. 错误处理 #

主题	描述	文档链接
错误集	error定义、错误类型	error-set.md
错误传播	try、catch、errdefer	error-propagation.md
自定义错误	定义错误、错误处理模式	custom-errors.md

10. 泛型 #

主题	描述	文档链接
泛型基础	comptime、类型参数	generics-basics.md
泛型数据结构	泛型结构体、泛型函数	generic-struct.md

11. 并发编程 #

主题	描述	文档链接
异步基础	async/await、帧	async-basics.md
异步函数	async函数、suspend/resume	async-functions.md

12. 构建系统 #

主题	描述	文档链接
构建基础	build.zig、构建脚本	build-basics.md
构建步骤	编译、链接、运行	build-steps.md
包管理	依赖管理、zon文件	package-management.md

13. 测试 #

主题	描述	文档链接
单元测试	test块、测试运行	unit-testing.md
测试断言	try、expect、测试辅助	test-assertions.md

14. 高级特性 #

主题	描述	文档链接
编译时计算	comptime、编译时执行	comptime.md
内联汇编	asm表达式、内联汇编语法	inline-asm.md
与C交互	@cImport、C ABI兼容	c-interop.md
不安全操作	@ptrCast、@intCast等	unsafe-operations.md