Zig Cross

mohitmishra786/low-level-dev-skills/skills/zig/zig-cross

作者 mohitmishra786bdc58472fa9f无许可证253 个星标收录于 2026年10月9日更新于 2026年10月9日仓库3个月前更新

Zig cross-compilation skill. Use when cross-compiling Zig programs to different targets, using Zig's built-in cross-compilation for embedded, WASM, Windows, ARM, or using zig cc to cross-compile C code without a system cross-toolchain. Activates on queries about Zig cross-compilation, zig target triples, zig cc cross-compile, Zig embedded targets, or Zig WASM.

仅含说明Software Development

AI 生成的概览

指导 Zig 交叉编译：目标三元组、CPU 特性、用 zig cc 编译 C、嵌入式与 WASM 目标。

功能: 该技能提供使用 Zig 内置交叉编译功能交叉编译 Zig 程序和 C 代码的说明，无需系统交叉工具链。内容涵盖目标三元组选择、CPU 特性定位、用 zig cc 交叉编译 C 项目、裸机嵌入式目标以及 WebAssembly 输出。还展示了用于一次构建多个目标的 build.zig 配置。附带一份关于目标三元组和嵌入式链接脚本设置的参考文档。
适用场景: 适用于将 Zig 程序交叉编译到其他操作系统或架构（如 ARM、Windows 或 macOS）时。也适用于关于 Zig 目标三元组、用 zig cc 交叉编译 C 代码、嵌入式裸机目标或 WebAssembly 输出的问题。
运行要求: 需要 Zig 工具链；部分命令使用 python3 解析 zig targets 输出，WASI 和 WASM 体积优化可选使用 wasmtime 和 wasm-opt 等工具。macOS 目标需要 macOS SDK。不附带脚本，仅包含说明和一份参考文档。

Zig Cross-Compilation

Purpose

Guide agents through Zig's built-in cross-compilation: target triple selection, CPU feature targeting, zig cc for cross-compiling C projects, embedded bare-metal targets, and WASM output — all without requiring a system cross-toolchain.

Triggers

"How do I cross-compile a Zig program for ARM?"
"How do I build Zig for a different OS?"
"How do I use Zig to cross-compile C code for another platform?"
"How do I build Zig for embedded/bare-metal?"
"How do I target WebAssembly with Zig?"
"What Zig target triple do I use for Raspberry Pi?"

Workflow

1. Zig's native cross-compilation

Zig has cross-compilation built in — no cross-toolchain, no Docker, no sysroot needed for pure Zig code:

bash

# List all supported targetszig targets | python3 -c "import sys,json; d=json.load(sys.stdin); [print(t) for t in d['libc']]"
# Build for a specific targetzig build-exe src/main.zig -target aarch64-linux-gnu -O ReleaseFast
# With build system (pass target as option)zig build -Dtarget=aarch64-linux-gnu -Doptimize=ReleaseFast
# Cross-compile for Windows from Linux/macOSzig build-exe src/main.zig -target x86_64-windows-gnu
# Cross-compile for macOS from Linux (requires macOS SDK)zig build-exe src/main.zig -target aarch64-macos-none

# List all supported targetszig targets | python3 -c "import sys,json; d=json.load(sys.stdin); [print(t) for t in d['libc']]"
# Build for a specific targetzig build-exe src/main.zig -target aarch64-linux-gnu -O ReleaseFast
# With build system (pass target as option)zig build -Dtarget=aarch64-linux-gnu -Doptimize=ReleaseFast
# Cross-compile for Windows from Linux/macOSzig build-exe src/main.zig -target x86_64-windows-gnu
# Cross-compile for macOS from Linux (requires macOS SDK)zig build-exe src/main.zig -target aarch64-macos-none

2. Common target triples

Target triple	Platform
`x86_64-linux-gnu`	Linux x86-64 (glibc)
`x86_64-linux-musl`	Linux x86-64 (musl, static)
`aarch64-linux-gnu`	ARM64 Linux (Pi 4, AWS Graviton)
`aarch64-linux-musl`	ARM64 Linux static
`armv7-linux-gnueabihf`	ARM 32-bit Linux (Pi 2/3)
`x86_64-windows-gnu`	Windows x86-64
`aarch64-macos-none`	macOS Apple Silicon
`x86_64-macos-none`	macOS Intel
`wasm32-freestanding`	WASM (browser, no OS)
`wasm32-wasi`	WASM with WASI
`thumbv7m-freestanding-eabi`	Cortex-M3 bare metal
`thumbv7em-freestanding-eabihf`	Cortex-M4/M7 with FPU
`riscv32-freestanding`	RISC-V 32-bit bare metal

3. CPU feature targeting

bash

# Native CPU (auto-detect, only for native builds)zig build-exe src/main.zig -mcpu native
# Baseline for architecture (most compatible)zig build-exe src/main.zig -target x86_64-linux-gnu -mcpu baseline
# x86-64 with AVX2zig build-exe src/main.zig -target x86_64-linux-gnu -mcpu x86_64+avx2+bmi2
# Raspberry Pi 4 (Cortex-A72)zig build-exe src/main.zig -target aarch64-linux-gnu -mcpu cortex_a72
# Cortex-M4 with FPUzig build-exe src/main.zig \    -target thumbv7em-freestanding-eabihf \    -mcpu cortex_m4+vfp4
# List CPU features for a targetzig targets | python3 -c "import sys,jsond=json.load(sys.stdin)for c in d['cpus']:    if 'cortex' in c['name']:        print(c['name'])"

# Native CPU (auto-detect, only for native builds)zig build-exe src/main.zig -mcpu native
# Baseline for architecture (most compatible)zig build-exe src/main.zig -target x86_64-linux-gnu -mcpu baseline
# x86-64 with AVX2zig build-exe src/main.zig -target x86_64-linux-gnu -mcpu x86_64+avx2+bmi2
# Raspberry Pi 4 (Cortex-A72)zig build-exe src/main.zig -target aarch64-linux-gnu -mcpu cortex_a72
# Cortex-M4 with FPUzig build-exe src/main.zig \    -target thumbv7em-freestanding-eabihf \    -mcpu cortex_m4+vfp4
# List CPU features for a targetzig targets | python3 -c "import sys,jsond=json.load(sys.stdin)for c in d['cpus']:    if 'cortex' in c['name']:        print(c['name'])"

4. zig cc for C cross-compilation

zig cc cross-compiles C without a system cross-toolchain:

bash

# Cross-compile C for ARM64 Linuxzig cc -target aarch64-linux-gnu -O2 -o myapp-arm64 main.c
# Cross-compile C for Windowszig cc -target x86_64-windows-gnu main.c -o myapp.exe
# Cross-compile C with static musl linkingzig cc -target x86_64-linux-musl -static main.c -o myapp-static
# Use in Makefile for all platformsCC_LINUX_AMD64 = zig cc -target x86_64-linux-gnuCC_LINUX_ARM64 = zig cc -target aarch64-linux-gnuCC_WINDOWS     = zig cc -target x86_64-windows-gnu

# Cross-compile C for ARM64 Linuxzig cc -target aarch64-linux-gnu -O2 -o myapp-arm64 main.c
# Cross-compile C for Windowszig cc -target x86_64-windows-gnu main.c -o myapp.exe
# Cross-compile C with static musl linkingzig cc -target x86_64-linux-musl -static main.c -o myapp-static
# Use in Makefile for all platformsCC_LINUX_AMD64 = zig cc -target x86_64-linux-gnuCC_LINUX_ARM64 = zig cc -target aarch64-linux-gnuCC_WINDOWS     = zig cc -target x86_64-windows-gnu

5. Build system cross-compilation

zig

// build.zig — cross-build all targetspub fn build(b: *std.Build) void {    const targets = [_]std.Target.Query{        .{ .cpu_arch = .x86_64, .os_tag = .linux, .abi = .gnu },        .{ .cpu_arch = .aarch64, .os_tag = .linux, .abi = .gnu },        .{ .cpu_arch = .x86_64, .os_tag = .windows, .abi = .gnu },        .{ .cpu_arch = .aarch64, .os_tag = .macos },    };
    for (targets) |t| {        const target = b.resolveTargetQuery(t);        const exe = b.addExecutable(.{            .name = b.fmt("myapp-{s}", .{@tagName(t.cpu_arch.?)}),            .root_source_file = b.path("src/main.zig"),            .target = target,            .optimize = .ReleaseFast,        });        b.installArtifact(exe);    }}

// build.zig — cross-build all targetspub fn build(b: *std.Build) void {    const targets = [_]std.Target.Query{        .{ .cpu_arch = .x86_64, .os_tag = .linux, .abi = .gnu },        .{ .cpu_arch = .aarch64, .os_tag = .linux, .abi = .gnu },        .{ .cpu_arch = .x86_64, .os_tag = .windows, .abi = .gnu },        .{ .cpu_arch = .aarch64, .os_tag = .macos },    };
    for (targets) |t| {        const target = b.resolveTargetQuery(t);        const exe = b.addExecutable(.{            .name = b.fmt("myapp-{s}", .{@tagName(t.cpu_arch.?)}),            .root_source_file = b.path("src/main.zig"),            .target = target,            .optimize = .ReleaseFast,        });        b.installArtifact(exe);    }}

bash

# Build all targetszig build# Creates: zig-out/bin/myapp-x86_64, myapp-aarch64, myapp-x86_64.exe, myapp-aarch64

# Build all targetszig build# Creates: zig-out/bin/myapp-x86_64, myapp-aarch64, myapp-x86_64.exe, myapp-aarch64

6. Embedded (bare-metal) targets

bash

# Cortex-M4 with FPU (STM32F4xx)zig build-exe src/main.zig \    -target thumbv7em-freestanding-eabihf \    -mcpu cortex_m4+vfp4 \    -O ReleaseSmall \    --script linker.ld

# Cortex-M4 with FPU (STM32F4xx)zig build-exe src/main.zig \    -target thumbv7em-freestanding-eabihf \    -mcpu cortex_m4+vfp4 \    -O ReleaseSmall \    --script linker.ld

zig

// src/main.zig — bare metal entry pointconst std = @import("std");
// Custom panic handler for embedded (no OS)pub fn panic(msg: []const u8, _: ?*std.builtin.StackTrace, _: ?usize) noreturn {    // Toggle LED or halt    while (true) {}}
// Entry point (matches linker script)export fn _start() void {    main() catch |err| {        _ = err;        while (true) {}    };}
fn main() !void {    // Hardware initialization...}

// src/main.zig — bare metal entry pointconst std = @import("std");
// Custom panic handler for embedded (no OS)pub fn panic(msg: []const u8, _: ?*std.builtin.StackTrace, _: ?usize) noreturn {    // Toggle LED or halt    while (true) {}}
// Entry point (matches linker script)export fn _start() void {    main() catch |err| {        _ = err;        while (true) {}    };}
fn main() !void {    // Hardware initialization...}

7. WebAssembly

bash

# WASM freestanding (browser)zig build-exe src/main.zig \    -target wasm32-freestanding \    -O ReleaseSmall \    --export=init \    --export=update \    -fno-entry
# WASM WASI (wasmtime, wasmer)zig build-exe src/main.zig \    -target wasm32-wasi \    -O ReleaseSafewasmtime myapp.wasm
# Optimize WASM sizewasm-opt -Oz myapp.wasm -o myapp.opt.wasm

# WASM freestanding (browser)zig build-exe src/main.zig \    -target wasm32-freestanding \    -O ReleaseSmall \    --export=init \    --export=update \    -fno-entry
# WASM WASI (wasmtime, wasmer)zig build-exe src/main.zig \    -target wasm32-wasi \    -O ReleaseSafewasmtime myapp.wasm
# Optimize WASM sizewasm-opt -Oz myapp.wasm -o myapp.opt.wasm

For target triple reference and embedded linker script setup, see references/zig-target-triples.md [blocked].

Related skills

Use skills/zig/zig-compiler for single-file compilation flags
Use skills/zig/zig-build-system for multi-target build.zig configuration
Use skills/compilers/cross-gcc for system cross-toolchain setup when needed
Use skills/rust/rust-cross for Rust's cross-compilation approach comparison

来源与署名

来源：mohitmishra786/low-level-dev-skills位于skills/zig/zig-cross提交bdc5847

许可证：无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

Zig Cross

Zig Cross-Compilation

Purpose

Triggers

Workflow

1. Zig's native cross-compilation

2. Common target triples

3. CPU feature targeting

4. zig cc for C cross-compilation

5. Build system cross-compilation

6. Embedded (bare-metal) targets

7. WebAssembly

Related skills

来源与署名

更多来自 mohitmishra786/low-level-dev-skills 的技能

Zig Debugging

Simd Intrinsics

Rustc Basics

Zig Cinterop

Zig Build System

Memory Model

更多Software Development技能

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices