命令行接口 (CLI)

Zig 命令行工具是与 Zig 编译器、构建系统和包管理器交互的主要方式。

核心命令

  • zig build: 调用 build.zig 文件来构建、测试和运行项目。
  • zig build-exe: 编译一个或多个 .zig 文件为可执行文件。
  • zig build-obj: 编译一个或多个 .zig 文件为目标文件(.o)。
  • zig build-lib: 编译一个或多个 .zig 文件为库文件(静态 .a 或动态 .so/.dll)。
  • zig test: 编译并运行指定文件中的所有 test 块。
  • zig run: 编译并直接运行一个 .zig 文件。
  • zig fmt: 格式化 .zig 文件以符合 Zig 风格指南。
  • zig translate-c: 将 C 代码翻译为 Zig 代码。
  • zig targets: 列出支持的编译目标。
  • zig version: 显示 Zig 编译器的版本。

全局选项

许多 Zig 命令都支持以下全局选项:

  • -Dtarget=<target>: 指定编译目标,例如 x86_64-linux-gnu
  • -Doptimize=<mode>: 指定优化模式,例如 Debug, ReleaseSafe, ReleaseFast, ReleaseSmall
  • --help: 显示帮助信息。

示例

  • 编译并运行一个简单的 Zig 文件:

    $ zig run hello.zig
  • 构建一个项目:

    $ zig build
  • 运行项目的测试:

    $ zig build test

另请参阅: