环境与工具
本页集中列出安装和构建所需工具。平台安装脚本会检测已有工具并补齐可自动安装的系统组件。
工具下载入口
以下链接均指向工具或数据库的官方网站。推荐下载当前仍受维护、并满足本文最低版本要求的稳定版本；不要从不明镜像下载带有可执行文件的安装包。
| 工具 | 用途 | 官方下载或项目地址 | 安装方式 |
|---|---|---|---|
| KBEngine Nex | 引擎源码 | GitHub 仓库 · Releases | Git clone 或下载源码压缩包 |
| Git | 克隆引擎、vcpkg 和依赖源码 | Git 官方安装页 · Git for Windows | Windows 手动安装；Linux/macOS 可使用系统包管理器 |
| Visual Studio | Windows MSVC、Windows SDK 和 Developer PowerShell | Visual Studio 下载 · Visual Studio 2022 及旧版本 | Windows 手动安装 |
| CMake | 配置和生成跨平台工程 | CMake 官方下载 | Windows 手动安装；Linux/macOS 可由脚本或包管理器安装 |
| Ninja | CMake Multi-Config 构建后端 | Ninja Releases · Ninja 官网 | Windows 手动安装；Linux/macOS 可由脚本或包管理器安装 |
| vcpkg | 恢复 C/C++ 与 Python 运行时依赖 | Microsoft vcpkg | 安装脚本自动克隆到 kbe/vcpkg |
| Python 3.12 | 创建 VENV、安装逻辑层依赖和运行 Python 管理工具 | Python 官方下载 | 按需手动安装 Python 3.12 |
| Xcode Command Line Tools | macOS Clang、SDK 和系统构建工具 | Apple Command Line Tools · 安装说明 | macOS 手动安装 |
| Homebrew | macOS 构建依赖包管理器 | Homebrew 官网 · 安装说明 | macOS 手动安装 |
| MySQL Community Server | MySQL 持久化后端 | MySQL Community Server · Windows Installer | 按数据库部署平台安装 |
| MongoDB Community Server | MongoDB 持久化后端 | MongoDB Community Server | 按数据库部署平台安装 |
| PostgreSQL | PostgreSQL 持久化后端 | PostgreSQL 下载 | 选择对应操作系统的软件包或安装器 |
Linux/macOS 安装脚本还会使用以下宿主工具和开发库。表中的链接用于查看项目、版本和官方文档；实际安装应优先交给 install_linux.sh、install_macos.sh 及系统包管理器，不要逐个下载源码后混装到系统目录。
| 工具或开发库 | 用途 | 官方项目地址 |
|---|---|---|
| GCC / G++ | Linux C/C++ 编译器 | GCC |
| GNU Make | 部分 vcpkg port 的构建工具 | GNU Make |
| Autoconf | 生成 Unix configure 脚本 | GNU Autoconf |
| Autoconf Archive | vcpkg port 使用的 Autoconf 宏集合 | GNU Autoconf Archive |
| Automake | 生成 Makefile 模板 | GNU Automake |
| Libtool | 跨平台库构建辅助工具 | GNU Libtool |
| pkg-config / pkgconf | 查找系统开发库 | pkg-config · pkgconf |
| cURL | 下载依赖和构建网络库 | curl |
| ZIP / UnZip | vcpkg 归档处理 | Info-ZIP |
| GNU Tar | 源码归档解包 | GNU Tar |
| Patch | 应用 vcpkg port 补丁 | GNU Patch |
| file | 识别下载文件和二进制格式 | file |
| GNU M4 | Autotools 宏处理器 | GNU M4 |
| Bison | 语法分析器生成工具 | GNU Bison |
| Flex | 词法分析器生成工具 | Flex |
| Perl | 部分第三方依赖的配置脚本运行时 | Perl |
| libtirpc | Unix RPC 开发库，sigar 构建依赖 | libtirpc |
| libffi | Python 和第三方库的 FFI 支持 | libffi |
| util-linux / libuuid | UUID 开发库 | util-linux |
| BZip2 | 压缩库开发文件 | BZip2 |
| Zlib | 压缩库开发文件 | Zlib |
Linux 发行版的软件包入口由系统自带的 apt-get、dnf、yum、zypper、pacman 或 apk 提供；macOS 使用 Homebrew formula。安装脚本会检测已经安装的实现，只补齐缺失项。
网络要求
vcpkg 会克隆 port 仓库并下载第三方源码。首次构建需要稳定访问 GitHub 或项目配置的镜像。不要在下载不完整后反复复用损坏的 buildtrees 或缓存目录。