环境搭建与基础配置

本章完成开发环境的全链路搭建，包括操作系统与编译器选型、CMake 构建系统的初始化配置，以及 SQLite3 依赖库的引入与验证。环境是后续所有缓存层实验的基础底盘，配置的规范性直接影响调试效率和运行时稳定性。

2.1 开发环境准备

本课程以跨平台为目标，核心依赖仅需操作系统原生支持 POSIX 接口或 Win32 API 即可。下表列出经过验证的环境组合：

💡 推荐使用 Ubuntu 22.04 + GCC 13 + CMake 3.28 的组合，与 CI 环境一致，可复现所有章节的实验结果。

安装基础工具链（以 Ubuntu 为例）：

sudo apt-get update
sudo apt-get install -y build-essential cmake git libsqlite3-dev
gcc --version
cmake --version
sqlite3 --version

macOS 用户使用 Homebrew：

brew install cmake sqlite3 gcc
gcc-13 --version
cmake --version
sqlite3 --version

Windows 用户推荐通过 vcpkg 管理依赖：

git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg && .\bootstrap-vcpkg.bat
.\vcpkg install sqlite3:x64-windows
cmake -B build -DCMAKE_TOOLCHAIN_FILE=path\to\vcpkg\scripts\buildsystems\vcpkg.cmake

上图展现了从开发环境到最终数据库文件的完整依赖链路。构建环境层通过 CMake 与编译器协同，将 SQLite3 依赖解析并链接至缓存应用，运行期应用直接读写本地 .db 文件。

2.2 编译器与构建工具

编译器须支持 C++17 标准（std::filesystem、std::optional 等特性被缓存层广泛使用）。CMake 最低版本 3.16 以保证 FindSQLite3 模块可用。

• GCC：9 以上，推荐 13（完整支持 C++17/20 且 std::filesystem 无需额外链接 stdc++fs）
• Clang：12 以上，推荐 16（LLVM 工具链对 macOS 更友好）
• MSVC：2019 16.8 以上，推荐 2022（Windows 下与 vcpkg 集成最佳）
• CMake：3.16 以上，推荐 3.28（提供更精确的依赖传播控制）

2.3 CMakeLists.txt 配置

以下是一个最小化但完整的 CMake 配置，覆盖项目声明、语言标准、依赖查找与目标链接：

cmake_minimum_required(VERSION 3.16)

project(LocalCache
  VERSION 1.0.0
  DESCRIPTION "本地数据库作为缓存层实战"
  LANGUAGES CXX
)

# ── C++ 标准 ──
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

# ── 查找 SQLite3 依赖 ──
find_package(SQLite3 REQUIRED)

# ── 可执行目标 ──
add_executable(cache_app
  src/main.cpp
  src/cache_engine.cpp
  src/db_adapter.cpp
)

# ── 链接 SQLite3 ──
target_link_libraries(cache_app PRIVATE SQLite::SQLite3)

# ── 传递包含目录 ──
target_include_directories(cache_app PRIVATE
  ${CMAKE_SOURCE_DIR}/include
)

2.4 数据库依赖引入

find_package(SQLite3 REQUIRED) 是引入 SQLite3 的标准方式。CMake 内置 FindSQLite3 模块，支持系统路径和自定义路径两种模式。

方式一：系统包管理器安装（推荐初学者）

sudo apt-get install libsqlite3-dev          # Ubuntu
brew install sqlite3                          # macOS
vcpkg install sqlite3:x64-windows            # Windows

CMake 将自动在 /usr/include、/usr/local/include 等系统路径下查找。

方式二：指定自定义安装路径

当 SQLite3 安装在非标准位置时，通过 CMAKE_PREFIX_PATH 指定搜索根：

cmake -B build \
  -DCMAKE_PREFIX_PATH=/opt/sqlite3 \
  -DCMAKE_BUILD_TYPE=Release

方式三：使用 FetchContent 自动下载（无系统依赖）

include(FetchContent)
FetchContent_Declare(
  sqlite3
  GIT_REPOSITORY https://github.com/sqlite/sqlite.git
  GIT_TAG        version-3.45.0
)
FetchContent_MakeAvailable(sqlite3)

# 此时无需 find_package，直接链接 sqlite3 目标
target_link_libraries(cache_app PRIVATE sqlite3)

2.5 验证构建

执行以下命令验证环境配置是否正确：

# 配置阶段
cmake -B build -DCMAKE_BUILD_TYPE=Release

# 构建阶段
cmake --build build -j$(nproc)

# 快速验证可执行文件生成
ls -lh build/cache_app

# 测试 SQLite3 链接是否正常
./build/cache_app --version

若输出类似 LocalCache v1.0.0 | SQLite3 3.45.0 的信息，则环境搭建成功。

预期构建日志片段（正常）：

-- Detecting CXX compiler ABI info - done
-- Found SQLite3: /usr/lib/x86_64-linux-gnu/libsqlite3.so (found version 3.45.0)
-- Configuring done (0.8s)
-- Generating done (0.1s)
-- Build files have been written to: build/
[ 25%] Building CXX object CMakeFiles/cache_app.dir/src/main.cpp.o
[ 50%] Building CXX object CMakeFiles/cache_app.dir/src/cache_engine.cpp.o
[ 75%] Building CXX object CMakeFiles/cache_app.dir/src/db_adapter.cpp.o
[100%] Linking CXX executable cache_app

2.6 常见错误与排查