mingtaiiii/rucbase-dev repository overview

⁠RucBase 开发环境

本镜像提供了一个开箱即用的 Ubuntu 22.04 开发环境，专门用于编译和运行 C++17 数据库教学项目：rucbase-lab⁠。

⁠镜像包含内容

• 操作系统: Ubuntu 22.04 LTS
• 核心依赖: GCC (11.x 完美支持 C++17标准), CMake, GDB, Git
• 项目特定依赖: flex, bison, libreadline-dev
• 预置的代码库: 包含完整的 rucbase-lab 代码仓库（含所有子模块），位于 /workspace/rucbase-lab
• 预编译的 GoogleTest: googletest 测试框架已在容器内完成编译和全局安装，开箱即用。

⁠快速开始

无需在本地配置任何 C++ 或依赖环境，仅需一条命令即可获取一个加载好代码的交互式开发终端：

docker run -it --rm mingtaiiii/rucbase-dev:latest

进入容器后，你将默认处于代码仓库的根目录 /workspace/rucbase-lab 下。

⁠如何构建和测试 RucBase

在容器终端中，你可以直接构建数据库服务端并运行各个模块的测试代码：

# 1. 编译系统服务端
mkdir -p build && cd build
cmake ..
make rmdb -j4

# 2. 运行系统服务端
./bin/rmdb test_db

# 3. 或者，直接编译并执行单元测试（以 LRU 缓存替换策略为例）
make lru_replacer_test -j4
./bin/lru_replacer_test

⁠配合 VS Code 进行开发 (推荐)

为了获得最佳的开发体验，强烈建议使用 VS Code 的 Dev Containers (开发容器) 扩展。 你可以直接将 VS Code 连接 (Attach) 到正在运行的此容器中，从而获得包含代码高亮、自动补全和断点调试等完整的 IDE 体验，且无需污染宿主机环境。