BusTub开发环境搭建：Ubuntu与macOS平台配置指南

🚀 想要快速上手CMU数据库课程明星项目BusTub吗？这份终极配置指南将带你从零开始，在Ubuntu和macOS平台上完成完整的开发环境搭建。BusTub是一个教育用关系型数据库管理系统，支持基本SQL和交互式shell，是学习数据库系统原理的完美工具。

📋 环境要求与准备工作

BusTub开发环境支持以下平台：

• Ubuntu 24.04 (推荐用于测试和评分)
• macOS 13 Ventura (M1/M2/Intel芯片，仅用于开发)

⚠️ 重要提示：不支持WSL和其他Linux发行版，请确保使用推荐环境以避免兼容性问题。

🔧 Ubuntu平台完整配置步骤

系统依赖包安装

首先确保系统包管理器是最新的：

sudo build_support/packages.sh

这个脚本会自动安装所有必要的开发工具，包括：

• 构建工具：build-essential, cmake, pkg-config
• 编译器：clang-15, clang-format-15, clang-tidy-15
• 开发库：zlib1g-dev, libelf-dev, libdwarf-dev

项目构建与编译

创建构建目录并编译项目：

mkdir build
cd build
cmake ..
make -j$(nproc)

🍎 macOS平台配置指南

Homebrew环境配置

如果尚未安装Homebrew，首先安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)

依赖包安装

运行安装脚本：

build_support/packages.sh

脚本会自动通过Homebrew安装：

• cmake - 跨平台构建系统
• llvm@15 - LLVM编译器工具链
• libelf - ELF文件格式库

项目编译

使用相同的构建流程：

mkdir build
cd build
cmake ..
make -j$(sysctl -n hw.ncpu)

⚙️ 高级配置选项

调试模式编译

为了更好的调试体验，可以使用调试模式：

cmake -DCMAKE_BUILD_TYPE=Debug ..
make -j$(nproc)

调试模式默认启用AddressSanitizer，帮助检测内存错误。

其他Sanitizer支持

如果需要线程安全检查：

cmake -DCMAKE_BUILD_TYPE=Debug -DBUSTUB_SANITIZER=thread ..

🎯 验证安装成功

编译完成后，可以通过以下方式验证安装：

1. 运行测试套件：

make check-tests

2. 启动交互式Shell：

./bin/bustub-shell

3. 执行示例SQL：

create table test (id int, name varchar(10));
insert into test values (1, 'hello');
select * from test;

🚨 常见问题与解决方案

编译错误处理

• 缺失依赖：确保运行了packages.sh脚本
• 权限问题：在Linux上使用sudo运行安装脚本
• 版本冲突：确保使用推荐的编译器版本

平台差异说明

macOS和Linux在互斥锁行为等方面存在差异，可能导致测试结果不同。建议使用Linux虚拟机进行最终测试。

💡 最佳实践建议

1. 使用版本控制：建议在私有仓库中维护代码
2. 分支管理：为每个项目创建独立分支
3. 定期更新：从上游仓库同步最新更改

🎉 恭喜！现在你已经成功搭建了BusTub开发环境，可以开始探索数据库系统的奥秘了。无论是学习SQL执行原理，还是实现自己的数据库组件，BusTub都为你提供了完美的学习平台。

记住，BusTub是为教育目的设计的，不建议在生产环境中使用。祝你在数据库学习的道路上取得成功！