从源代码构建 DuckDB – DuckDB 数据库

搜索快捷键 cmd + k | ctrl + k

文档 / 开发 / 构建 DuckDB

从源代码构建 DuckDB

何时应该构建 DuckDB？

DuckDB 的二进制文件可在安装页面获取，包括稳定版和预览版。在大多数情况下，建议使用这些二进制文件。当您在实验性平台（例如Raspberry Pi）上运行，或者您想为未合并的拉取请求构建项目时，可以基于duckdb/duckdb GitHub 仓库从源代码构建 DuckDB。本页面解释了构建 DuckDB 的步骤。

先决条件

DuckDB 需要 CMake 和一个符合 C++11 标准的编译器（例如 GCC、Apple-Clang、MSVC）。此外，我们建议使用Ninja 构建系统，它能自动并行化构建过程。

入门

一个 Makefile 封装了构建过程。有关目标和配置标志，请参阅构建配置。

make
make release # same as plain make
make debug
GEN=ninja make # for use with Ninja
BUILD_BENCHMARK=1 make # Build with benchmarks

平台

完全支持的平台

DuckDB 完全支持 Linux、macOS 和 Windows。这些平台都提供 x86_64 (amd64) 和 AArch64 (arm64) 版本的构建，并且几乎所有扩展都在这些平台上分发。

平台名称	描述
`linux_amd64`	Linux x86_64 (amd64) 与 glibc
`linux_arm64`	Linux AArch64 (arm64) 与 glibc
`osx_amd64`	macOS 12+ amd64 (Intel CPU)
`osx_arm64`	macOS 12+ arm64 (Apple Silicon CPU)
`windows_amd64`	Windows 10+ x86_64 (amd64)
`windows_arm64`	Windows 10+ AArch64 (arm64)

对于这些平台，可以获取最新稳定版本和预览版本（夜间构建）的构建。在某些情况下，您可能仍希望从源代码构建 DuckDB，例如测试一个未合并的拉取请求。有关这些平台的构建说明，请参阅

部分支持的平台

有几个部分支持的平台。对于某些平台，DuckDB 二进制文件和扩展（或一部分扩展）已分发。对于其他平台，可以从源代码构建。

平台名称	描述
`linux_amd64_musl`	Linux x86_64 (amd64) 与 musl libc，例如 Alpine Linux
`linux_arm64_musl`	Linux AArch64 (arm64) 与 musl libc，例如 Alpine Linux
`linux_arm64_android`	Android AArch64 (arm64)
`wasm_eh`	WebAssembly 异常处理

下面，我们提供了一些平台的详细构建说明

尽力支持的平台

平台名称	描述
`freebsd_amd64`	FreeBSD x86_64 (amd64)
`freebsd_arm64`	FreeBSD AArch64 (arm64)
`wasm_mvp`	WebAssembly 最低可行产品
`windows_amd64_mingw`	Windows 10+ x86_64 (amd64) 与 MinGW
`windows_arm64_mingw`	Windows 10+ AArch64 (arm64) 与 MinGW

这些平台不属于 DuckDB 社区支持的范围。有关商业支持的详细信息，请参阅支持策略页面。

另请参阅“非官方和不受支持的平台”页面了解详情。

已过时平台

某些平台在旧版 DuckDB 中受支持，但现在已不再受支持。

平台名称	描述
`linux_amd64_gcc4`	Linux AMDM64 (x86_64) 与 GCC 4，例如 CentOS 7
`linux_arm64_gcc4`	Linux AArch64 (arm64) 与 GCC 4，例如 CentOS 7
`windows_amd64_rtools`	Windows 10+ x86_64 (amd64) 适用于 RTools

DuckDB 也可以使用为 macOS 和 Linux 提供的说明，为生命周期结束的平台（例如macOS 11和CentOS 7/8）构建。

整合构建

DuckDB 可以构建为单个 C++ 头文件和源文件对（duckdb.hpp 和 duckdb.cpp），代码量约为 50 万行。要生成此文件，请运行

python scripts/amalgamation.py

请注意，整合构建是尽力提供的，并非官方支持。

限制

目前，DuckDB 存在以下限制

DuckDB 代码库与 C++23 不兼容。因此，尝试使用 -std=c++23 编译 DuckDB 将会失败。
-march=native 构建标志（即使用本地机器的本地指令集编译 DuckDB）不受支持。

故障排除指南

我们提供了构建 DuckDB 的故障排除指南