第 2 章：Hello World

2.1 第一个程序

新建一个文件 main.zig，内容如下：

const std = @import("std");

pub fn main() void {

std.debug.print("Hello, {s}!\n", .{"World"});

}

然后在终端跑：

$ zig run main.zig

Hello, World!

恭喜，你已经成功运行了第一个 Zig 程序！

2.2 这段代码到底在说啥？

我们一行一行来看：

const std = @import("std");

const 是声明一个常量（constant），后面不能改。

std 是这个常量的名字，你可以起别的名字（比如 shabi），但大家都叫 std，所以你也叫 std 就行。

@import("std") 是一个内建函数（built-in function），名字前带 @ 的都是 Zig 自带的"魔法函数"。@import 的作用是导入一个文件或包，返回那个文件里所有 pub（公开）声明的"集合"（就是一个 struct）。

"std" 是一个特殊字符串，表示"导入标准库"

pub fn main() void {

pub 是 public（公开）的缩写。main 函数是程序的入口，必须是 pub（虽然在 main 函数自己这里不强制，但写上没坏处）。

fn 是 function（函数）的缩写。

main 是函数名，跟 C 一样，操作系统找 main 这个符号作为入口。

() 是参数列表，这里空着，表示 main 函数不接受任何命令行参数（严格说是不接受普通参数，要接受可以用 std.process.args()）。

void 是返回类型。void 在 Zig 里就是"没有值"的意思，C 里的 void 同样含义。

std.debug.print("Hello, {s}!\n", .{"World"});

std.debug.print 是标准库里的一个打印函数，把内容写到 stderr（标准错误）。

"Hello, {s}!\n" 是格式字符串，{s} 是占位符，会被后面的实参替换。\n 是换行符（跟 C 一样）。

.{"World"} 是一个匿名结构体字面量（anonymous struct literal），用来给格式化函数传多个参数。这里只有 "World" 一个字段（字段名是 "World" 字符串本身），会被填到 {s} 的位置。

每行结尾的 ; 是必须的，跟 C 一样。

2.3 几个细节

1. 为什么是 std.debug.print 而不是 std.print？

因为 Zig 的标准库设计原则是「没有隐藏的副作用」。std.debug.print 明确告诉你这个函数会写到 stderr，是调试用的。如果你要写到 stdout，得用 std.fs.File.stdout() 然后 .writer().print(...)，这样很明确。

2. 为什么输出到了 stderr？

原文说："Hello, World! will be written to stderr"。对，std.debug.print 是写到 stderr 的，2> /dev/null 可以看到效果：

$ zig run main.zig 2>/dev/null # 啥都看不到

$ zig run main.zig 1>/dev/null # 能看到 "Hello, World!"

3. 为什么要用 .{...} 这种奇怪的语法？

这是 Zig 独有的设计。当一个函数的参数都是「不同类型但可以由编译器推断」时，你不需要给每个参数加类型，直接 .{"World"} 就行。.{"World"} 实际上等价于：

.{ .a = "World" } // 但这里字段名其实就是 "World"

后续讲「匿名结构体」时会详细解释。

4. 文件编码必须是 UTF-8

如果你的编辑器默认是 GBK、UTF-16 之类的，Zig 编译器会拒绝。可以这样修：

zig fmt main.zig # 重新以 UTF-8 格式化

或者在编辑器里另存为 UTF-8。

2.4 编译不运行

只想编译，不想运行：

$ zig build-exe main.zig

$ ./main # 手动运行

$ ls

main main.zig

2.5 Zig 的注释

Zig 有两种注释，跟 C/C++/JavaScript 一样：

// 这是单行注释

/* 这是多行注释 */

Zig 也支持 /// 文档注释（doc comment），用 zig build-lib -femit-docs 生成文档时会被提取出来——详见第 54 章。文件级注释用 //!。