如何在Zig程序中导入C库？以libsecp256k1为例

问题场景 #

运行依赖共享库libsecp256k1的main.zig时，执行zig run main.zig遇到两个连续错误：

• 初始错误：找不到secp256k1.h头文件，且提示未链接libc
• 修改头文件为绝对路径后：链接阶段找不到secp256k1相关函数符号

代码示例 #

const c = @cImport(@cInclude("secp256k1.h"));
const std = @import("std");

const FLAGS_TYPE_CONTEXT = 1 << 0;
const FLAGS_BIT_CONTEXT_SIGN = 1 << 9;
const FLAGS_TYPE_COMPRESSION = 1 << 1;
const FLAGS_BIT_COMPRESSION = 1 << 8;
const CONTEXT_SIGN = (FLAGS_TYPE_CONTEXT | FLAGS_BIT_CONTEXT_SIGN);
const EC_COMPRESSED = (FLAGS_TYPE_COMPRESSION | FLAGS_BIT_COMPRESSION);

pub fn main() !void {
    var sk: [32]u8 = undefined;

    var c_pk: c.secp256k1_pubkey = undefined;
    var ctx = c.secp256k1_context_create(CONTEXT_SIGN);
    if (c.secp256k1_ec_pubkey_create(ctx, &c_pk, &sk) == 0) {
        std.debug.print("error creating pubkey\n", .{});
        return;
    }

    var size: usize = 33;
    var pk: [33]u8 = undefined;
    if (c.secp256k1_ec_pubkey_serialize(ctx, &pk, &size, &c_pk, EC_COMPRESSED) == 0) {
        std.debug.print("error serializing pubkey\n", .{});
        return;
    }
    std.debug.print("public key ({d}): {s}\n", .{ size, std.fmt.fmtSliceHexLower(&pk) });
}

首次错误信息 #

main.zig:1:11: error: C import failed
const c = @cImport(@cInclude("secp256k1.h"));
          ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
main.zig:1:11: note: libc headers not available; compilation does not link against libc
referenced by:
    main: main.zig:14:15
    callMain: /usr/lib/zig/std/start.zig:574:32
    remaining reference traces hidden; use '-freference-trace' to see all reference traces
/home/fiatjaf/.cache/zig/o/47ca5f5e5b1a72513af35a101803ad7d/cimport.h:1:10: error: 'secp256k1.h' file not found
#include <secp256k1.h>

修改头文件路径后的错误信息 #

error: ld.lld: undefined symbol: secp256k1_context_create
    note: referenced by main.zig:15
    note:               /home/fiatjaf/.cache/zig/o/53d7067ceb3c7b7714a3622f5a802012/main.o:(main.main)
error: ld.lld: undefined symbol: secp256k1_ec_pubkey_create
    note: referenced by main.zig:16
    note:               /home/fiatjaf/.cache/zig/o/53d7067ceb3c7b7714a3622f5a802012/main.o:(main.main)
error: ld.lld: undefined symbol: secp256k1_ec_pubkey_serialize
    note: referenced by main.zig:23
    note:               /home/fiatjaf/.cache/zig/o/53d7067ceb3c7b7714a3622f5a802012/main.o:(main.main)

解决方法 #

1. 解决头文件与libc依赖问题 #

Zig默认不自动链接libc，而@cImport依赖libc环境，因此必须添加-lc参数启用libc链接。如果secp256k1.h不在系统默认头文件目录（如/usr/include），需要用-I参数指定头文件所在路径，例如：

# 假设头文件在/usr/local/include
zig run main.zig -lc -I/usr/local/include

2. 解决链接符号缺失问题 #

链接阶段需要显式指定链接libsecp256k1库，使用-lsecp256k1参数。如果库文件不在系统默认库目录（如/usr/lib），还需要用-L参数指定库路径，例如：

# 假设库文件在/usr/local/lib
zig run main.zig -lc -I/usr/local/include -L/usr/local/lib -lsecp256k1

完整命令示例 #

如果libsecp256k1安装在系统默认路径（如通过包管理器安装），直接运行：

zig run main.zig -lc -lsecp256k1

此时代码里的@cInclude("secp256k1.h")可以正常工作，无需修改为绝对路径。

内容的提问来源于stack exchange，提问作者fiatjaf