安装工具链
seekdb 使用 Bazel、Rust 以及仓库管理的编译器和依赖集合。先安装 Rust 和少量宿主机工具，再由 ./build.py init 将固定版本的 C/C++ 构建依赖准备到 deps/3rd。
Rust
通过 rustup 安装 Rust。在 Linux、macOS 或 WSL 上，执行官方安装脚本，并让 Cargo 环境在当前 shell 中生效：
中国大陆网络： 如果官方源下载缓慢，可以在当前终端使用清华大学 TUNA rustup 镜像，然后执行安装命令：
export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
export RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"
上述环境变量也会让同一终端中后续的 rustup 工具链下载使用 TUNA 镜像。
在 Windows 上，从 Rust 官方安装页面 下载并运行 rustup-init.exe，然后重新打开 PowerShell，使 %USERPROFILE%\.cargo\bin 出现在 PATH 中。
仓库通过 rust/rust-toolchain.toml 固定使用 Rust 1.98.1。本机构建会调用 rustup 定位该版本；缺失时，rustup 默认自动安装（除非设置了 RUSTUP_AUTO_INSTALL=0），无需先手动执行安装命令。
该配置文件还为 Rust 检查和交叉编译声明了 clippy 组件及以下目标；普通本机构建不需要全部安装：
x86_64-unknown-linux-gnu
x86_64-pc-windows-gnu
aarch64-linux-android
aarch64-apple-ios
aarch64-apple-ios-sim
如需提前安装配置文件声明的工具链、组件和目标，可在 rust/ 目录执行 rustup toolchain install --no-self-update。这是可选的预安装步骤；--no-self-update 仅禁止更新 rustup 自身。
构建脚本统一通过 RsProxy 稀疏源下载锁定的 Cargo 依赖，在这一步覆盖用户的 crates.io 源选择，无需修改全局镜像配置；下载仍复用原有 Cargo 缓存（$CARGO_HOME，默认 ~/.cargo）。
宿主机检测与架构
当前依赖初始化脚本可以识别以下宿主机系列。能够选择依赖配置不代表该平台生成的所有软件包都已通过生产认证。
| 架构 | 可识别的 Linux 系列 |
|---|---|
| x86_64 | RHEL、CentOS、AlmaLinux、Rocky Linux、Alibaba Cloud Linux/AliOS、Anolis OS、TencentOS、Ubuntu、Debian、Fedora、Kylin、openEuler、openSUSE Leap、SLES 和 UOS |
| aarch64 | RHEL、CentOS、AlmaLinux、Rocky Linux、Alibaba Cloud Linux/AliOS、Anolis OS、Ubuntu、Debian、Kylin 和 openEuler |
不能根据 x86_64 列表推断 Fedora、openSUSE/SLES、UOS 或 TencentOS 的 aarch64 支持；当前 aarch64 依赖分支不会选择这些宿主机。
兼容构建还可以识别 macOS 13 或更高版本的 arm64 和 x86_64。Apple Silicon 是主要测试的开发平台；构建脚本接受 Intel 主机并不等同于生产支持承诺。
Windows 11 x64 使用 python build.py，init 会选择 Windows 依赖清单。
Linux 宿主机依赖
RHEL 兼容系统
sudo yum install git wget curl rpm-build rpm2cpio cpio make glibc-devel glibc-headers binutils m4 libtool libaio python3
Debian 兼容系统
sudo apt-get update
sudo apt-get install git wget curl rpm rpm2cpio cpio make build-essential binutils m4 file python3
Ubuntu 24.04 和 Debian 13 使用 time64 版本的 libaio：
SUSE 兼容系统
macOS 宿主机依赖
brew install git pkg-config openssl@3 ncurses googletest
brew install zstd lz4 utf8proc thrift re2 brotli
需要使用镜像时，参见 Homebrew 优化配置。
Windows 宿主机依赖
安装 Python 3、Visual Studio 2022 Build Tools（选择 使用 C++ 的桌面开发 工作负载）。LLVM 18.1.8 随项目依赖 SDK 安装，无需单独安装 LLVM。
在仓库根目录打开 x64 Native Tools Command Prompt for VS 2022，初始化解析器工具和依赖 SDK：
build.py 固定选择 deps\3rd\tools\llvm18 中的 clang-cl，产物是 build\bin\src\observer\seekdb\seekdb.exe。构建沿用原有的 _ALLOW_COMPILER_AND_STL_VERSION_MISMATCH，跳过新版 MSVC 标准库的编译器版本检查；该选项同时用于项目 C++ 和 Cargo 的 C++ 桥接代码。
可执行文件需要的 DLL（包括 MSVC 运行库）一起输出到同一目录。打包直接使用这份构建产物，无需再扫描依赖 SDK 查找服务端 DLL。
.NET 8 和 WiX v4 是可选依赖，仅配置器和 MSI 打包流程需要。
验证环境
回到仓库根目录执行：
然后继续阅读获取代码、编译并运行 seekdb。