/tags/zig/Recent content in Zig on Xerxes II's BlogHugozh-cnMon, 06 Apr 2026 00:00:00 +0000/posts/cross-compile-rust-freebsd-zigbuild/Mon, 06 Apr 2026 00:00:00 +0000/posts/cross-compile-rust-freebsd-zigbuild/<p>记录一下在 Linux (x86_64) 上用 <code>cargo-zigbuild</code> 交叉编译 Rust 项目到 FreeBSD x86_64 的踩坑过程。项目是一个 Discord bot，依赖了 <code>sysinfo</code>、<code>tikv-jemallocator</code>、<code>sea-orm</code>(SQLite) 等 crate。</p> <h2 id="背景">背景</h2> <p>Zig 自带了多平台的 libc 和交叉编译工具链，<code>cargo-zigbuild</code> 利用 Zig 作为 linker 来实现 Rust 的交叉编译，通常比自己配置交叉工具链方便很多。但 FreeBSD 作为目标平台时会遇到一些特殊问题。</p> <h2 id="准备">准备</h2> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#75715e"># 安装 FreeBSD 目标</span> </span></span><span style="display:flex;"><span>rustup target add x86_64-unknown-freebsd </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># 安装 cargo-zigbuild（如果还没有）</span> </span></span><span style="display:flex;"><span>cargo install cargo-zigbuild </span></span></code></pre></div><h2 id="问题一缺少-freebsd-系统库">问题一：缺少 FreeBSD 系统库</h2> <p>编译本身顺利通过，但链接阶段报错：</p> <pre tabindex="0"><code>error: unable to find dynamic system library &#39;geom&#39; using strategy &#39;no_fallback&#39; </code></pre><p><code>sysinfo</code> crate 在 FreeBSD 上需要链接 <code>libkvm</code>、<code>libprocstat</code>、<code>libgeom</code>、<code>libdevstat</code> 等 FreeBSD base system 的库。Zig 的工具链只提供 libc，不包含这些系统库。</p>