Recent discussions in zigcc/forum

✨Zig文件是一个`struct`

2025-10-06T11:17:38+00:00

奇怪的语法

为什么Zig要采用这种看起来十分奇怪的包导入语法？

const std = @import("std");

Zig的设计

深入研究了我发现，Zig的文件就是一个struct，所以，以下代码在Zig中是合法的

const std = @import("std");

hello: [14:0]u8 = "Hello, world!\n".*, // What?

fn print(self: @This()) void {
    std.debug.print("{s}", .{self.hello});
}

pub fn main() void {
    const this = @This(){};
    this.print();
}

这段代码为当前文件所代表的struct定义了一个名为hello的字段，并成功地实例化了自己。

这就说的通了，包导入不是在导包，而是在定义一个类型，可以近似理解成：

const std = struct {
    @cInclude("std.zig")
};

不过Zig没有预处理器，不允许文件直接包含的这种写法

所以

Zig并不存在实质上的包导入语法，而是创造了一个由外部文件定义的类型

zoop: 一个 Zig 的 OOP 方案

2024-08-08T13:03:10+00:00

github: https://github.com/zhuyadong/zoop

闲聊一个关于 zig 语法的问题

2025-02-12T03:05:59+00:00

参考下面这段伪代码:

const TaggedMyStruct = typedef(MyStruct, .Tag{.keyvalue=.{"key","myvalue"}});

const TagPayloads = struct{
    const tag1 : TypedefConfig.Tag = .Tag{.keyvaluearr=.{.{"key","myvalue"}, .{"otherkey","othervalue"}}});
}
const SecondTaggedMyStruct = typedef(MyStruct, TagPayloads.tag1);

大家不觉得这一行里面的 n 个 . 号看起来很丑陋吗:

const tag1 : TypedefConfig.Tag = .Tag{.keyvaluearr=.{.{"key","myvalue"}, .{"otherkey","othervalue"}}});

微信群

2024-07-14T01:41:59+00:00

如二维码过期，请在此留言，我们会及时更新，谢谢！同时也可以加入我们的电报群：http://ask.ziglang.cc/telegram

更多群聊方式见：https://ziglang.cc/

使用zig实现了一个类似ls的工具

2026-02-27T12:29:06+00:00

这是我第一个zig项目，主要是拿来学习用的，如果有什么问题欢迎留言

仓库地址: https://github.com/here-Leslie-Lau/zlist

Zig构建时使用ReleaseFast卡住

2026-02-13T04:06:19+00:00

环境

MacOSX 15.3.1
Apple M2 Max

最小化复现文件: https://gist.github.com/KarryCharon/6cb0c87e11f77476d5322df35815268f#file-llvm_slow_repro-zig
构建指令: zig build-exe llvm_slow_repro.zig -OReleaseFast

Note

仅Release时会卡住, 使用Debug则没问题.
更改文件中 const REGISTER_COUNT: usize = 128; 可以通过

进一步研究结果:

把144行

    var regs: [REGISTER_COUNT]Value = @splat(Value.nil());

换成

    var regs: [REGISTER_COUNT]Value = undefined;
    @memset(regs[0..], Value.nil());

可以解决

关于zig “.”点操作符的一些疑惑

2026-02-04T02:21:45+00:00

pub fn reader(file: File, buffer: []u8) Reader { return .init(file, buffer); }
大佬们有能解答的么“.”这个点操作符是在哪个命名空间中找的？
怎么会调用Reader的.init？reader不是在File里面吗？官方文件有木有说明在哪？

感觉zig的defer没有c++的raii和rust的drop好用

2025-12-06T05:33:19+00:00

该问题主要存在于泛型类中。

例如容器在deinit的时候没法把保存在容器中的元素也deinit。ArrayList(ArrayList(i32))在defer的时候得手动先把内部deinit再把外部deinit。
虽然可以通过反射判断元素是否存在deinit函数，来选择性deinit元素，但依然存在两个问题：

没有任何语言上的强制性要求，让元素的析构函数名称必须叫deinit。
deinit可能需要传参，常见情况是传递一个allocator，但也有可能存在其他传参。

msys2安装的zig不使用msys2

2025-12-17T04:39:56+00:00

运行zig libc显示

$ zig libc
# The directory that contains `stdlib.h`.
# On POSIX-like systems, include directories be found with: `cc -E -Wp,-v -xc /dev/null`
include_dir=D:\Windows Kits\10\Include\10.0.26100.0\ucrt

# The system-specific include directory. May be the same as `include_dir`.
# On Windows it's the directory that includes `vcruntime.h`.
# On POSIX it's the directory that includes `sys/errno.h`.
sys_include_dir=D:\Program Files\Microsoft Visual Studio\18\Community\VC\Tools\MSVC\14.50.35717\incl
ude

# The directory that contains `crt1.o` or `crt2.o`.
# On POSIX, can be found with `cc -print-file-name=crt1.o`.
# Not needed when targeting MacOS.
crt_dir=D:\Windows Kits\10\Lib\10.0.26100.0\ucrt\x64

# The directory that contains `vcruntime.lib`.
# Only needed when targeting MSVC on Windows.
msvc_lib_dir=D:\Program Files\Microsoft Visual Studio\18\Community\VC\Tools\MSVC\14.50.35717\Lib\x64

# The directory that contains `kernel32.lib`.
# Only needed when targeting MSVC on Windows.
kernel32_lib_dir=D:\Windows Kits\10\Lib\10.0.26100.0\um\x64

# The directory that contains `crtbeginS.o` and `crtendS.o`
# Only needed when targeting Haiku.
gcc_dir=

预期应该是使用msys2的头文件和库的目录

我尝试 zig libc -target x86_64-windows-gnu

$ zig libc -target x86_64-windows-gnu
error: unable to detect libc for non-native target
error: the following build command failed with exit code 1:
C:\Users\heloonihao\AppData\Local\zig\o\a1c86a5b85607a86e1df5ddacc7d4773\libc.exe D:\msys64\clang64\
lib\zig -target x86_64-windows-gnu

zig build -Dtarget=x86_64-windows-gnu也不起作用

...

2026-01-09T11:29:40+00:00

pub const AllocateVirtualMemoryError = error{
    AccessDenied,
    NoMemory,
    InvalidHandle,
    Unexpected,
};

pub fn VirtualAllocEx(
    h_process: HANDLE,
    address: ?*anyopaque,
    size: usize,
    alloc_type: u32,
    protect: u32,
) AllocateVirtualMemoryError!*anyopaque {
    var base_addr: ?*anyopaque = address;
    var region_size: usize = size;

    const status = ntdll.NtAllocateVirtualMemory(
        h_process,
        &base_addr,
        0,
        &region_size,
        alloc_type,
        protect,
    );

    if (status != .SUCCESS) {
        return switch (status) {
            .ACCESS_DENIED => error.AccessDenied,
            .NO_MEMORY, .CONFLICTING_ADDRESSES => error.NoMemory,
            .INVALID_HANDLE => error.InvalidHandle,
            else => error.Unexpected,
        };
    }

    if (base_addr) |addr| {
        return addr;
    }

    return error.Unexpected;
}

类似这样的内容直接放在kernel32.zig吗

有没有人想移植 rustproject 到 zig 里面来？

2025-12-11T01:25:54+00:00

https://rustprojectprimer.com/

很不错的项目，对工程开发很有用。

使用 Zig 实现的 tree 命令

2023-03-18T05:19:06+00:00

const std = @import("std");
const process = std.process;
const fs = std.fs;
const mem = std.mem;

const VisitedEntry = struct {
    name: []const u8,
    level: usize,
};

const VisitedList = std.ArrayList(VisitedEntry);

pub fn main() anyerror!void {
    var arena = std.heap.ArenaAllocator.init(std.heap.page_allocator);
    defer arena.deinit();
    const allocator = arena.allocator();

    const args = try process.argsAlloc(allocator);
    defer process.argsFree(allocator, args);

    const root_dir = if (args.len > 1)
        args[1]
    else
        ".";

    var visited = VisitedList.init(allocator);
    try visited.append(.{ .name = root_dir, .level = 0 });

    var iter_dir =
        try fs.cwd().openIterableDir(root_dir, .{});
    defer iter_dir.close();

    try walk(allocator, &iter_dir, &visited, 1);

    var writer = std.io.bufferedWriter(std.io.getStdOut().writer());
    for (visited.items) |entry| {
        _ = try writer.write(try makePrefix(allocator, entry.level));
        _ = try writer.write(entry.name);
        _ = try writer.write("\n");
    }
    try writer.flush();
}

fn makePrefix(allocator: std.mem.Allocator, level: usize) ![]const u8 {
    const prefix = "|  ";
    const base = "|--";
    return switch (level) {
        0 => return "",
        1 => return base,
        else => {
            var out = try allocator.alloc(u8, (level - 1) * prefix.len + base.len);
            for (0..level - 1) |i| {
                mem.copy(u8, out[i * prefix.len .. (i + 1) * prefix.len], prefix);
            }
            mem.copy(u8, out[(level - 1) * prefix.len .. level * prefix.len], base);

            return out;
        },
    };
}

fn walk(
    allocator: mem.Allocator,
    iter_dir: *fs.IterableDir,
    visited: *VisitedList,
    level: usize,
) !void {
    var it = iter_dir.iterate();
    while (try it.next()) |entry| {
        const dupe_name = try allocator.dupe(u8, entry.name);
        switch (entry.kind) {
            .Directory => {
                try visited.append(.{ .name = dupe_name, .level = level });
                var sub_iter_dir = try iter_dir.dir.openIterableDir(entry.name, .{});
                defer sub_iter_dir.close();

                try walk(
                    allocator,
                    &sub_iter_dir,
                    visited,
                    level + 1,
                );
            },
            else => {
                try visited.append(.{ .name = dupe_name, .level = level });
            },
        }
    }
}

使用示例：

./zig-out/bin/tree zig-cache/
zig-cache/
|--z
|  |--6c2830de7eff2e6c29a466f3dae29f56
|  |--a2d9c9576a2de120dc2fe54d26e22b56
|--o
|  |--31a508b05079f502e9de10cf725ab900
|  |  |--tree
|  |  |--tree.o
|  |--c3a7328c0b6d9e4ac745e62c729ae197
|  |  |--build.o
|  |  |--build
|  |--d4336c38182f8d4321b881a61531ae3c
|  |  |--builtin.zig
|  |--d7233815bac1be707323362604efcc18
|  |  |--dependencies.zig
|  |--d4ac96c2b77544f5a6d309f1f10d02bd
|  |  |--builtin.zig
|--h
|  |--ef8df946ad597ff441d79907e875840e.txt
|  |--acd9b03fd406a6d60e3dbfb18849aace.txt
|  |--timestamp
|--tmp

zdocs: zig 文档工具

2025-07-08T05:45:24+00:00

zig 自带的文档工具一般好用，zdocs 尝试优化查看zig文档的体验。
使用起来跟zig官方在线std文档很像，可以在tt1.hon.sh直接体验。

跟zig官方std文档的区别是，上面体验地址是服务端渲染的，在手机、w3m上使用体验会更好。
文档首次展示时间会快很多。

欢迎试用&反馈 🤝

之前在社区微信群发了，感觉在那边持续迭代发消息有些打扰，就来这儿发一发，后续在这儿发布更新～

Writer 和 Reader 接口写太棒了

2025-07-01T16:12:32+00:00

var archiver = std.tar.writer(response.writer());
一行代码然后源文件一路看下去，把我这个新手人都看麻了

通过编译时字符串，调用到某实例的方法

2025-07-25T01:22:24+00:00

const std = @import("std");

const MyStruct = struct {
    value: i32,

    pub fn print(self: *const MyStruct) void {
        std.debug.print("Value: {}\n", .{self.value});
    }
};

fn callMethod(comptime T: type, comptime method_name: []const u8, obj: T, args: anytype) void {
    if (!@hasDecl(T, method_name)) {
        @compileError("Method '" ++ method_name ++ "' not found");
    }

    const method = @field(T, method_name);
    @call(.auto, method, .{&obj} ++ args);
}

pub fn main() !void {
    const my_obj = MyStruct{ .value = 10 };

    // 通过字符串调用方法
    callMethod(MyStruct, "print", my_obj, .{});
}

https://codapi.org/embed/?sandbox=zig&code=data%3A%3Bbase64%2CXVHLSsNAFN3PVxxnoYmG1MdGEgpd6NKVxY1KyWPSTklmQjIplBIQXPgDPsAPEBcKohtd%2BTM%2B6l%2FIZFqtZpNk5p7XPZEUpUKpYrTR4VkuC2XRUsXU9gmJmsu98b4qqkihjdJ8TAgAjIK0Yh741qZDmoO8CpEI5AUXyipZmnhY%2FUthYyR5PMPrp1SxG7Ow6rsGRQ8M6aQ%2BEtSBO9E0bqNU234Dq0ntE5IIREGa7jE1kLEVySxXPGPoelDjnDn4OcmaiZ4IMubh8Nj4qbYdyHDooesgKPqlh0CMNfCPQZ7AWuoMgnKHRanVdRa5bHshRUer8ZTtFoUsLGpMYYVibW0Ro3%2FpCoRUSGQlmh2bRM3LWDPzuo2EszT%2BL2sQHZ3dcoNKyfm1XtayDIe1VtGZbJ%2FUhMw6yQIuLBtLC%2BlmcuOeDIdo%2F1Q0gVk32thYh161Hm618HVyPX09e7%2B%2F%2Bry7eXt%2BnD6cfp7ffly%2BfDxdGL7fOuZcDmhTK3VmOtqk7rH%2BBg%3D%3D

你们好，初次接触zig，对于它的协程实现有一些疑问

2025-06-16T09:03:42+00:00

我看到zig的协程力图实现“非染色”的协程，因此比较感兴趣，进而简单地了解了一下这个语言。看起来这个语言是偏向于底层，追求0成本抽象和极致显式的哲学，因此我对于它的协程的逻辑上的约定实现细节比较好奇：
zig的协程的变量是什么时候出现在堆上的？对于0成本抽象与非染色的协程，我的理解是“一个返回future的函数”，如果是这样的解释的话，协程中创建的变量应该约定为在首次await之前都在栈上，而在首次await的时候将所有变量转移到堆中的函数帧上，我的理解正确吗？

zig无锁数据结构个人探索

2025-09-25T07:31:37+00:00

zig标准库里无锁实现好像不多。个人项目用到了，然后参照着disruptor之类的实现挠着头做了一版，项目里用着没啥问题，就大致拷贝出来写了些实现思路。

分享一个 paseto 库: zig-paseto

2025-09-23T11:09:49+00:00

项目地址： https://github.com/deatil/zig-paseto

paseto 是一个试图替代 JWT 的新的无状态机制的项目，宗旨在于规避 JWT 会出现的一些不可控问题。
其他语言也有了实现， zig 也不能落后，就有了该库。

当前库实现了 V3 和 V4 两个协议。

anyzig的网络下载问题

2025-07-14T06:03:09+00:00

我想使用anyzig，但是发现anyzig不论在windows还是linux，下载某个版本zig编译器时就会卡住，似乎下载不下来。这种情况怎么处理？需要设置镜像么？

.......

2025-07-09T11:49:59+00:00

这里更新polystate 的开发进展。

编译时export C-ABI weak函数问题

2025-07-07T06:51:03+00:00

使用zig版本0.14.1。

在处理单片机中断处理函数时，参考c的处理方式，想将所有中断处理函数先进行weak定义，并与Default_Handler同地址，实际使用时再通过strong函数覆盖。

在实际zig中，我想使用中断ID枚举的位域来在编译时生成语句进行多个中断函数导出。

pub const IRQn = enum(i32) {
    Reset = -15,
    NMI = -14,
    HardFault = -13,
    _,
};

fn Default_Handler() callconv(.c) void {
    while (true) {}
}

comptime {
    @export(&memoryInit, .{ .name = "memoryInit", .linkage = .weak });
    @export(&systemInit, .{ .name = "systemInit", .linkage = .weak });
    @export(&Reset_Handler, .{ .name = "Reset_Handler", .linkage = .weak });

    const fields = @typeInfo(IRQn).@"enum".fields;
    for (fields[1..]) |field| {
        @export(&Default_Handler, .{ .name = field.name ++ "_Handler", .linkage = .weak });
    }
}

结果通过readelf发现只有第一个位域被导出为weak函数。

    35: 00000559     4 FUNC    WEAK   DEFAULT    3 NMI_Handler
    36: 00000000  1024 OBJECT  GLOBAL DEFAULT    1 vector
    37: 20000000     0 NOTYPE  GLOBAL DEFAULT  ABS _estack
    38: 00000400    16 OBJECT  GLOBAL DEFAULT    2 flashconfig
    39: 00000559     4 FUNC    GLOBAL DEFAULT    3 HardFault_Handler

想了解一下原因。

zig 的 leaked 问题，好些带 gc 的语言可以实现的，到 zig 就得绕一圈才行

2025-06-06T08:12:23+00:00

最近解决 totp 的 leaked 问题，用之前逻辑好些完全行不通，只能放弃一些逻辑写法

使用 `@setFloatMode` 后依然比等价的 C 代码慢很多？

2025-05-25T15:57:23+00:00

代码是从 CLBG 改编来的，主要测试浮点运算性能。

C 源码：https://0x0.st/8xMC.c
Zig 源码：https://0x0.st/8xui.c

用下面的命令可以快速运行：

# C
curl https://0x0.st/8xMC.c | gcc -x c -lm -march=native -Ofast -o a.out - && time ./a.out
# Zig
tmp=$(mktemp -t tmp.XXXXXX.zig); curl https://0x0.st/8xui.c -o "$tmp" && zig build-exe -O ReleaseFast -femit-bin=a.out "$tmp" && time ./a.out

我这里的测试结果是：

C (-Ofast): 0.296s
C (-O3 -ffast-math): 0.600s
C (-O3): 0.732s
Zig: 1.195s
Zig（去掉 @setFloatMode(.optimized)）：1.192s

如上，加不加 @setFloatMode(.optimized) 好像都没有区别，相比 C（-Ofast）要慢至 4 倍。但根据文档里说的，该命令等价于 -ffast-math，而 C 加上 -ffast-math 会加速很多。

是我哪里没考虑到吗？

CPU: AMD Ryzen 7 8845HS
GCC: 15.1.1 20250425
Zig: 0.14.1

朋友们,有人了解微软的dynamic debugging吗,我感觉这在计算密集的开发中会很有用

2025-05-25T14:21:56+00:00

如题,debug调试起来在这块效率太低了

Zig 支持用户自定义 "注解" 吗

2025-02-08T03:34:22+00:00

萌新，有 java，go，rust，typescript 的背景。

昨天才刚翻完 Zig 圣经，第一眼对 zig 还是比较喜欢的。

手撸框架比较多，所以对于一个一门语言是否原生支持 “注解”(Java 的叫法, typescript 里面叫装饰器）非常关心。

因为这个特性对于写框架来说，太实用了。

举例来说(Java)，你要写一个 “表单类”，有注解支持的情况下，表单字段的验证就很容易实现：

class UserForm {
    @NotNull
    Long id;
    @Size(min = 3, max = 8)
    String name;
    @Email
    String email;
}

搜了一下 zig github 上面的 issues，没有发现有专门的信息说是支持注解的。

所以想在这里问问：zig 目前支持 “注解”吗？尤其是用户自定义注解！

或者有计划支持吗？