Build for Linux, macOS, and Windows
One toolchain, many platforms.
Build for Linux, macOS, and Windows is a free Zig Academy lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Zig Academy learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
One Toolchain, Many Platforms
From a single machine you can produce binaries for every major OS. Zig treats cross-builds as first-class, not an afterthought.
Build for Linux
Target Linux by naming its triple. The musl ABI gives you a clean, portable Linux executable from any host.
zig build-exe main.zig -target x86_64-linux-muslBuild for macOS
Target Apple Silicon with the macos OS field. The output is a real Mach-O binary that runs on arm64 Macs.
zig build-exe main.zig -target aarch64-macosBuild for Windows
Target Windows and Zig emits a .exe automatically. The windows OS field switches on the right object format for you.
zig build-exe main.zig -target x86_64-windowsSame Source, Different Output
Your Zig code does not change between targets. Only the -target flag changes, and the compiler does the rest of the work.
Set the Target in build.zig
In a project, the build script reads a target instead. standardTargetOptions exposes -target through zig build.
const target = b.standardTargetOptions(.{});Attach the Target to the Exe
Pass that resolved target into your executable so the whole build graph knows which platform it is producing.
const exe = b.addExecutable(.{ .name = "app", .target = target });Override on the Command Line
With standardTargetOptions in place, users pass -Dtarget to zig build and choose any platform without editing code.
zig build -Dtarget=x86_64-windowsNo External SDKs Needed
Zig bundles the headers and start files for each OS, so you skip installing a Windows SDK or macOS toolchain separately.
Test Each Build
You can compile every target on one host, then copy each binary to the matching machine to verify it runs as expected.
Build All Three at Once
Cross-builds make release scripts simple. A short loop over three triples produces Linux, macOS, and Windows binaries in one pass.
Quick Check
Think about how you pick a platform inside a Zig project build.
Recap
You learned to build Linux, macOS, and Windows binaries from one host using -target or -Dtarget, with no extra SDKs. 🛠️
Frequently asked questions
Is the “Build for Linux, macOS, and Windows” lesson free?
Yes — the full text of “Build for Linux, macOS, and Windows” is free to read here on the web, and the Zig Academy course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Zig Academy course, upgrade to CoddyKit PRO.
What will I learn in “Build for Linux, macOS, and Windows”?
One toolchain, many platforms. You practise Zig Academy with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Zig Academy?
No prior experience is required. Zig Academy on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Build for Linux, macOS, and Windows” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Zig Academy lesson?
Yes. Every Zig Academy lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Targets and the -target Triple
- Build for Linux, macOS, and Windows
- Cross-Compiling C with zig cc
- Static Binaries and musl