3、构建系统选型:Makefile、CMake、Bazel、Meson对比,如何根据项目规模选择

说实话,构建系统这个话题,我见过太多团队栽跟头了。

有人觉得「不就是编译代码吗,Makefile 一把梭」,结果项目一膨胀,改个依赖能改到怀疑人生。也有人一上来就上 Bazel,结果配置写了三周,编译时间倒是没降多少。

我个人习惯是:先看项目规模,再选工具。别让构建系统成为你的瓶颈,也别让它成为你的负担。

3.1 四大构建系统速览

先简单过一遍这四位选手的背景和定位。你心里有个数,后面才好选。

构建系统 诞生年份 核心语言 设计哲学 典型项目规模
Makefile 1976 Shell + Make 语法 简单直接,一切皆文件 小到中型(< 10万行)
CMake 2000 CMake 语言 生成式构建,跨平台 中到大型(10万~100万行)
Bazel 2015 Starlark(Python 子集) 增量构建,沙箱隔离,多语言 超大型(> 100万行,多仓库)
Meson 2013 Meson 语法 + Ninja 后端 快,简洁,用户友好 中到大型(10万~50万行)

嗯,这张表你大概扫一眼就行。真正关键的是下面这些实战经验。

3.2 Makefile:小项目的「老朋友」

Makefile 我用了快十年。说实话,它就像一把瑞士军刀——小巧、灵活,但用不好容易割手。

什么时候选它?

  • 项目代码量在 5 万行以内
  • 只有一两个开发者
  • 不需要跨平台(比如只在 Linux 上跑)
  • 依赖关系简单,没有复杂的第三方库

举个例子,我早期写的一个日志库,总共就 20 个源文件。一个 Makefile 搞定:

CC = g++
CFLAGS = -Wall -O2 -std=c++17
SRCS = $(wildcard src/*.cpp)
OBJS = $(SRCS:.cpp=.o)
TARGET = liblog.a

$(TARGET): $(OBJS)
    ar rcs $@ $^

%.o: %.cpp
    $(CC) $(CFLAGS) -c $< -o $@

clean:
    rm -f $(OBJS) $(TARGET)

你看,十几行就搞定了。但问题也来了——一旦项目变大,Makefile 的维护成本会指数级上升。

避坑指南:我曾经在一个 30 万行的项目中接手过一份 800 行的 Makefile。里面各种 ifeq、foreach、shell 调用,改一个编译选项要翻半天。最后我花了整整一周把它迁移到了 CMake。所以我的建议是:项目超过 10 万行,就别硬撑 Makefile 了。

3.3 CMake:中大型项目的「工业标准」

CMake 是我目前最常用的构建系统。为什么?因为它平衡了「功能」和「易用性」。

它的核心优势:

  • 跨平台:一套 CMakeLists.txt,Windows/Linux/macOS 都能编译
  • 生态成熟:几乎所有 C++ 库都提供 CMake 支持(FindPackage 太香了)
  • 模块化:add_subdirectory、target_link_libraries 让依赖管理清晰
  • 生成器架构:后端可以选 Make、Ninja、Visual Studio 等

我个人习惯是:项目一超过 5 万行,或者需要跨平台,我直接上 CMake。别犹豫,犹豫就会败北。

来看一个实际项目的 CMakeLists.txt 片段:

cmake_minimum_required(VERSION 3.16)
project(MyEngine VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 查找第三方库
find_package(OpenGL REQUIRED)
find_package(GLEW REQUIRED)
find_package(GLFW3 REQUIRED)

# 添加子模块
add_subdirectory(core)
add_subdirectory(renderer)
add_subdirectory(utils)

# 主可执行文件
add_executable(my_engine main.cpp)
target_link_libraries(my_engine
    PRIVATE
        core_lib
        renderer_lib
        utils_lib
        OpenGL::GL
        GLEW::GLEW
        glfw
)

你看,依赖关系一目了然。而且 CMake 的 target_include_directories 和 target_link_libraries 的 PUBLIC/PRIVATE/INTERFACE 机制,能很好地控制符号可见性——这在大型项目中太重要了。

我的一个小技巧:在 CMake 中尽量用 target_* 命令,而不是全局的 include_directories 或 link_directories。前者是「现代 CMake」的推荐做法,能避免很多莫名其妙的编译冲突。

3.4 Bazel:超大型项目的「重型武器」

Bazel 是 Google 内部工具 Blaze 的开源版本。说实话,它很强,但也很「重」。

什么时候该考虑 Bazel?

  • 项目超过 100 万行代码
  • 多语言混合(C++、Java、Python、Go 等)
  • 需要精确的增量构建和缓存
  • 团队规模大(20 人以上)
  • 有严格的 CI/CD 要求

我记得有一次帮一个客户做构建优化。他们的项目有 200 多个子模块,用 CMake 编译一次要 40 分钟。迁移到 Bazel 后,增量编译只需要 5 分钟。为什么?因为 Bazel 的沙箱机制和精确的依赖追踪,能确保「只编译真正改变的部分」。

Bazel 的 BUILD 文件长这样:

load("@rules_cc//cc:defs.bzl", "cc_library", "cc_binary")

cc_library(
    name = "core",
    srcs = glob(["core/**/*.cpp"]),
    hdrs = glob(["core/**/*.h"]),
    deps = [
        "//third_party:spdlog",
        "//third_party:fmt",
    ],
    visibility = ["//visibility:public"],
)

cc_binary(
    name = "my_app",
    srcs = ["main.cpp"],
    deps = [
        ":core",
        "//renderer",
    ],
)
注意:Bazel 的学习曲线比较陡。我建议你先用一个小项目试水,别一上来就全量迁移。另外,Bazel 对 Windows 的支持不如 CMake 成熟,如果你的团队主要用 Windows,要慎重。

3.5 Meson:CMake 的「挑战者」

Meson 是相对年轻的一个构建系统。它的口号是「快、简单、用户友好」。我个人觉得,它在某些方面确实比 CMake 做得更好。

Meson 的亮点:

  • 语法简洁:比 CMake 的语法更干净,更像 Python
  • 速度快:后端默认用 Ninja,编译速度比 Make 快不少
  • 内置好用的功能:比如 subproject、wrap 依赖管理
  • 错误信息友好:配置出错时,提示信息比 CMake 清晰得多

来看一个 Meson 的 meson.build 文件:

project('my_project', 'cpp',
    version : '1.0.0',
    default_options : ['cpp_std=c++17'])

# 查找依赖
gl_dep = dependency('gl')
glew_dep = dependency('glew')

# 子目录
subdir('core')
subdir('renderer')

# 可执行文件
executable('my_app',
    'main.cpp',
    dependencies : [gl_dep, glew_dep],
    link_with : [core_lib, renderer_lib])

是不是比 CMake 清爽很多?

不过 Meson 也有短板:生态不如 CMake 成熟。很多第三方库没有直接提供 Meson 支持,需要自己写 wrap 文件。另外,大型 IDE(如 Visual Studio)对 Meson 的支持也一般。

我的建议:如果你是新项目,团队规模不大(10 人以内),而且主要用 Linux 或 macOS 开发,可以试试 Meson。它的开发体验确实比 CMake 好。但如果你需要和大量第三方库集成,或者团队里有人习惯用 Visual Studio,那还是 CMake 更稳妥。

3.6 如何根据项目规模选择?

好了,说了这么多,到底怎么选?我整理了一个决策流程,你照着走就行:

  1. 项目 < 5 万行,单平台,1-2 人开发 → Makefile。别折腾,简单够用。
  2. 5 万 ~ 50 万行,需要跨平台,3-10 人 → CMake。这是最稳妥的选择。
  3. 10 万 ~ 50 万行,追求开发体验,Linux/macOS 为主 → Meson。值得一试。
  4. > 100 万行,多语言,大团队,需要精确增量构建 → Bazel。虽然重,但值得。

你可能会问:「那 50 万到 100 万行之间呢?」

嗯,这个区间其实比较模糊。我个人习惯是:如果项目依赖复杂、第三方库多,选 CMake;如果项目内部模块多、需要频繁增量编译,选 Bazel。

核心原则:构建系统是为项目服务的,不是反过来。别为了用某个工具而用某个工具。我见过太多团队,明明一个 CMake 就能搞定,非要上 Bazel,结果配置写了两个月,开发效率反而下降了。

3.7 我的最终建议

如果你现在还在犹豫,我直接给你一个「安全牌」:

  • 新项目,不确定未来规模:用 CMake。它是最通用的选择,进可攻退可守。
  • 已有项目,正在重构构建系统:评估一下项目规模和团队能力。如果团队里没人用过 Bazel,别硬上。
  • 个人项目或小团队:Makefile 或 Meson 都行,怎么舒服怎么来。

最后说一句:构建系统选型没有银弹。每个工具都有它的适用场景。我的经验是,花一周时间做选型调研,比花一个月时间踩坑要划算得多。

好了,这一章就到这里。下一章我们聊聊「依赖管理」——说实话,这比构建系统本身更容易让人头疼。