第一章
命令

Zig 命令

现在,我们已经安装了 zig ,接下来就了解一下基本的 zig 命令。

它囊括了项目建立、构建、测试、运行,甚至你可以用它来部署你的项目,也可以用来给 C/C++ 作为编译或者依赖管理工具,非常的全面,这一切都是得益于 zig 本身的编译期。

以下仅列出常用的命令!

zig build

构建项目,会自动搜索当前目录及父目录的 build.zig 进行构建。

zig build-obj

编译一个 Zig 源文件为一个对象文件(.o 文件)。

zig build-test

编译并执行 Zig 文件中的所有测试用例。

zig init

这个命令用于初始化项目,在当前路径下创建 src/main.zig、build.zig 和 src/lib.zig 三个文件。

关于 build.zig 这个文件的内容涉及到了 zig 的构建系统,我们将会单独讲述。

.
├── build.zig
└── src
    └── main.zig
    └── lib.zig

zig ast-check

对指定文件进行AST语法检查,支持指定文件和标准输入。

zig fmt

用于格式化代码源文件,支持stdin和指定路径。

zig test

对指定的源文件运行test,适用于单元测试。

zig run

编译并立即运行一个 Zig 程序。这对于快速测试片段代码非常有用。

zig cc

使用 Zig 的内置 C 编译器来编译 C 代码。

zig c++

使用 Zig 的内置 C++ 编译器来编译 C++ 代码。

zig translate-c

将 C 代码转换为 Zig 代码。这是 Zig 提供的一个强大功能,可以帮助你将现有的 C 代码库迁移到 Zig。

zig targets

显示 Zig 编译器支持的所有目标架构、操作系统和 ABI。

zig version

显示当前安装的 Zig 编译器版本。

zig zen

输出 Zig 的设计哲学。

zig fetch

该命令用于获取包的 hash 或者添加包到 build.zig.zon 中!