Optimization Mode
Zig has four optimization modes:
To add standard build options to a build.zig file:
const std = @import("std");
pub fn build(b: *std.Build) void {
const optimize = b.standardOptimizeOption(.{});
const exe = b.addExecutable(.{
.name = "example",
.root_module = b.createModule(.{
.root_source_file = b.path("example.zig"),
.optimize = optimize,
}),
});
b.default_step.dependOn(&exe.step);
}This causes these options to be available:
- -Doptimize=debug
- Optimizations off and safety on (default)
- -Doptimize=safe
- Optimizations on and safety on
- -Doptimize=fast
- Optimizations on and safety off
- -Doptimize=small
- Size optimizations on and safety off
debug
$ zig build-exe example.zig
- Fast compilation speed
- Safety checks enabled
- Slow runtime performance
- Large binary size
- No reproducible build requirement
fast
$ zig build-exe example.zig -Ofast
- Fast runtime performance
- Safety checks disabled
- Slow compilation speed
- Large binary size
- Reproducible build
safe
$ zig build-exe example.zig -Osafe
- Medium runtime performance
- Safety checks enabled
- Slow compilation speed
- Large binary size
- Reproducible build
small
$ zig build-exe example.zig -Osmall
- Medium runtime performance
- Safety checks disabled
- Slow compilation speed
- Small binary size
- Reproducible build
See also: