跳到主要内容 Meson：现代 C/C++ 构建系统详解 | 极客日志
C++
Meson：现代 C/C++ 构建系统详解 本文介绍了 Meson 构建系统，它是专为 C/C++ 等编译型语言设计的现代化开源工具。相比 CMake 和 Autotools，Meson 采用 Python 风格声明式语法，默认使用 Ninja 后端以实现极速构建。文章涵盖了 Meson 的发展历史、核心设计哲学（如声明式优于命令式、错误友好）、功能特性（依赖管理、跨平台支持、模块化）、安装配置及完整工作流程。通过对比 CMake 和 Autotools，展示了 Meson 在语法简洁性、构建速度和错误提示上的优势。此外，还提供了实际案例（GTK、Systemd 迁移）和最佳实践建议，包括项目结构组织、依赖管理策略及 IDE 集成方案。对于追求高效开发体验的 C/C++ 开发者，Meson 是一个值得尝试的选择。
随缘 发布于 2026/3/29 更新于 2026/4/14 Meson：现代 C/C++ 构建系统的革新者
引言：C/C++ 构建的痛点与革新
想象一下，你正在开始一个新的 C++ 项目。你面临的选择是：
复杂的 CMake 语法，学习曲线陡峭
过时的 Autotools，难以维护
平台差异，需要为每个系统编写不同的构建逻辑
这时，一个名为Meson 的构建系统出现了，它承诺：简单、快速、用户友好 。Meson 不仅仅是一个工具，更是对传统构建系统哲学的彻底反思。
什么是 Meson？
Meson 是一个开源的、现代化的构建系统 ，专门为 C、C++、Fortran 等编译型语言设计。它的核心设计理念是：
声明式语法 ：Python 风格的配置语言，直观易懂极速构建 ：默认使用 Ninja 作为后端跨平台 ：真正的"一次编写，处处构建"用户友好 ：清晰的错误信息，智能的默认值
Meson 的定位 传统方式：源代码 → Makefile → 可执行文件
Meson 方式：源代码 → meson.build（声明式） → Ninja → 可执行文件
关键洞察 ：Meson 不直接执行构建，而是生成 Ninja 构建文件，利用 Ninja 的极致速度。
Meson 的发展历史：从不满到创新
2013 年：酝酿期
Jussi Pakkanen（Meson 创始人）对现有构建系统不满
CMake 语法复杂，Autotools 过时，SCons 缓慢
大型项目（如 GNOME）的构建配置难以维护
2014 年：诞生与发布 2014 年 1 月 ：Meson 0.1.0 首次发布
初始目标：为 GNOME 项目创建更好的构建系统
早期采用者：GNOME Maps、GNOME Music 等
配置语言必须是简单、易读的
构建速度必须尽可能快
跨平台支持必须一流
依赖管理必须现代化
2015-2017 年：快速发展期
2015 年 ：支持 Windows 原生构建2016 年 ：成为 GNOME 官方推荐的构建系统2017 年 ：支持跨平台依赖管理（WrapDB）版本 1.0 ：API 稳定，生产就绪
GTK+、GLib 等核心 GNOME 库迁移到 Meson
其他项目如 Systemd、QEMU 开始尝试
2018 年至今：成熟与普及
版本 1.2+ ：功能丰富，稳定可靠广泛采用 ：数千个项目使用，包括：
GNOME 桌面环境
Systemd 初始化系统
QEMU 虚拟机
Mesa 3D 图形库
Xiph.org 多媒体库
活跃的社区维护
丰富的文档和示例
与主流 IDE 集成
Meson 的核心设计哲学
1. 声明式优于命令式
add_executable(myapp)
target_sources(myapp PRIVATE main.cpp)
target_include_directories(myapp PRIVATE include)
target_link_libraries(myapp PRIVATE mylib)
executable('myapp' , 'main.cpp' , include_directories: 'include' , dependencies: mylib_dep)
2. 合理的默认值
3. 错误友好
CMake Error at CMakeLists.txt:10 (target_link_libraries): Cannot specify link libraries for target "myapp" which is not built by this project.
meson.build:10 :0 : ERROR: Tried to link target 'myapp' to non-existent target 'mylib'
4. 速度优先
$ meson setup builddir
$ ninja -C builddir
Meson 的功能特性详解
1. 优雅的构建描述语言
基本语法
project('myapp' , 'cpp' , version: '1.0.0' , default_options: ['cpp_std=c++17' ])
executable('myapp' , 'src/main.cpp' , 'src/utils.cpp' , include_directories: 'include' , dependencies: [thread_dep, fmt_dep])
mylib = library('mylib' , 'src/lib.cpp' , version: '1.0.0' , soversion: '1' )
test('basic test' , myapp, args: ['--test' ], timeout: 60 )
变量和数据结构
project_name = 'myapp'
sources = ['main.cpp' , 'utils.cpp' ]
version_array = [1 , 0 , 0 ]
features = {'threading' : true, 'gui' : false}
if get_option('enable_gui' )
sources += ['gui.cpp' ]
endif
foreach file : sources
endforeach
2. 智能的依赖管理
系统依赖查找
thread_dep = dependency('threads' )
opengl_dep = dependency('gl' )
zlib_dep = dependency('zlib' )
boost_dep = dependency('boost' , version: '>=1.70' , modules: ['thread' , 'system' ])
gtk_dep = dependency('gtk4' , version: '>=4.0.0' , required: get_option('gtk4' ))
cairo_dep = dependency('cairo' , required: false, fallback: ['cairo' , 'cairo_dep' ])
子项目管理
spdlog_proj = subproject('spdlog' )
spdlog_dep = spdlog_proj.get_variable('spdlog_dep' )
[wrap-file]
directory = fmt-8.0 .1
source_url = https://github.com/fmtlib/fmt/archive/8.0 .1 .zip
3. 跨平台支持
平台检测
if host_machine.system() == 'windows'
sources += ['win32.cpp' ]
elif host_machine.system() == 'darwin'
sources += ['macos.cpp' ]
else
sources += ['linux.cpp' ]
endif
if host_machine.cpu_family() == 'x86_64'
add_project_arguments('-march=native' , language: 'cpp' )
endif
if meson.is_cross_build()
endif
编译器特性检测
if meson.get_compiler('cpp' ).has_function('std::make_unique' , prefix: '#include <memory>' )
add_project_arguments('-DHAVE_MAKE_UNIQUE' , language: 'cpp' )
endif
cpp = meson.get_compiler('cpp' )
if cpp.has_header('filesystem' )
elif cpp.has_header('experimental/filesystem' )
endif
4. 模块化设计
内置模块
gnome = import ('gnome' )
pkgconfig = import ('pkgconfig' )
gresource = gnome.compile_resources(
'myapp-resources' , 'data/myapp.gresource.xml' ,
source_dir: 'data' , c_name: 'myapp'
)
pkgconfig.generate(
libraries: mylib, version: '1.0' , name: 'mylib' , description: 'My awesome library'
)
自定义模块
mod = import ('my_module' )
result = mod.do_something()
def do_something ():
return 'result'
Meson 的完整用法指南
安装与配置
sudo apt install meson ninja-build
sudo dnf install meson ninja-build
brew install meson ninja
pip install meson ninja
pip install meson
基本工作流程
myproject/
├── meson.build
├── src/
│ ├── meson.build
│ └── main.cpp
└── include/
└── myproject.h
meson setup builddir
meson setup builddir --buildtype=debug
cd builddir && ninja
meson compile -C builddir
meson test -C builddir
meson install -C builddir
项目配置示例
简单 C++ 项目
project('myapp' , 'cpp' , version: '1.0.0' , default_options: [
'cpp_std=c++17' ,
'warning_level=3' ,
'werror=true'
])
subdir('src' )
install_data('README.md' , install_dir: 'share/doc/myapp' )
if get_option('tests' )
subdir('tests' )
endif
sources = [
'main.cpp' ,
'utils.cpp' ,
'parser.cpp'
]
incdir = include_directories('../include' )
thread_dep = dependency('threads' )
fmt_dep = dependency('fmt' )
executable('myapp' , sources, include_directories: incdir, dependencies: [thread_dep, fmt_dep], install: true)
库项目
project('mylib' , 'c' , 'cpp' , version: '1.2.3' , license: 'MIT' )
version_array = meson.project_version().split('.' )
version_major = version_array[0 ].to_int()
version_minor = version_array[1 ].to_int()
version_micro = version_array[2 ].to_int()
lib_sources = files(
'src/core.cpp' ,
'src/utils.cpp' ,
'src/api.cpp'
)
public_headers = files(
'include/mylib/core.h' ,
'include/mylib/utils.h'
)
mylib = library('mylib' , lib_sources, version: meson.project_version(), soversion: version_major, install: true, include_directories: include_directories('include' ), dependencies: [
dependency('threads' ),
dependency('zlib' )
])
install_headers(public_headers, subdir: 'mylib' )
import ('pkgconfig' ).generate(mylib, name: 'mylib' , description: 'My awesome library' , version: meson.project_version(), url: 'https://github.com/me/mylib' )
高级特性使用
交叉编译
[binaries]
c = '/usr/bin/arm-linux-gnueabihf-gcc'
cpp = '/usr/bin/arm-linux-gnueabihf-g++'
ar = '/usr/bin/arm-linux-gnueabihf-ar'
strip = '/usr/bin/arm-linux-gnueabihf-strip'
[host_machine]
system = 'linux'
cpu_family = 'arm'
cpu = 'armv7hl'
endian = 'little'
meson setup builddir --cross-file cross_file.txt
选项配置
option('buildtype' , type : 'combo' , choices: ['plain' , 'debug' , 'debugoptimized' , 'release' , 'minsize' ], value: 'debugoptimized' , description: 'Build type' )
option('warning_level' , type : 'combo' , choices: ['0' , '1' , '2' , '3' ], value: '3' , description: 'Warning level' )
option('enable_gui' , type : 'boolean' , value: true, description: 'Enable GUI support' )
option('optimization_level' , type : 'integer' , min : 0 , max : 3 , value: 2 , description: 'Optimization level' )
if get_option('enable_gui' )
gui_dep = dependency('gtk4' )
endif
自定义目标
custom_target('generate-docs' , input : 'README.md' , output: 'documentation.html' , command: [pandoc, '@INPUT@' , '-o' , '@OUTPUT@' ], install: true, install_dir: 'share/doc' )
run_command('generate-headers.py' , check: true)
configure_file(
input : 'config.h.in' ,
output: 'config.h' ,
configuration: {
'VERSION' : meson.project_version(),
'ENABLE_FEATURE' : get_option('enable_feature' )
}
)
测试与基准测试
test('basic functionality' , myapp, args: ['--test' ], timeout: 30 )
benchmark('performance test' , benchmark_exe, args: ['--bench' ], timeout: 120 , priority: -1 )
test_suite('all' , 'basic functionality' , 'edge cases' , 'performance test' , is_parallel: false)
Meson 与其他构建系统对比
Meson vs CMake 特性 Meson CMake 语法 声明式，Python 风格 命令式，自定义语言 学习曲线 平缓 陡峭 默认构建后端 Ninja（极快） Make（较慢） 错误信息 清晰，友好 经常晦涩 跨平台 优秀 优秀 依赖管理 WrapDB + pkg-config find_package + FetchContent 社区规模 成长中，活跃 庞大，成熟
Meson vs Autotools 特性 Meson Autotools 配置语言 Python 风格 M4 宏 + shell 构建速度 极快（Ninja 后端） 慢（shell 脚本） Windows 支持 原生支持 需要 Cygwin/MSYS 现代特性 有 无 维护难度 简单 复杂
实际性能对比
Meson 的最佳实践
1. 项目结构组织 myproject/
├── meson.build
├── meson_options.txt
├── include /
│ └── myproject/
│ ├── core.h
│ └── utils.h
├── src/
│ ├── meson.build
│ ├── core.cpp
│ └── utils.cpp
├── subprojects/
│ └── package.wrap
├── tests/
│ ├── meson.build
│ └── test_core.cpp
└── docs/
└── meson.build
2. 依赖管理策略
deps = []
system_dep = dependency('zlib' , required: false)
if system_dep.found()
deps += system_dep
else
zlib_proj = subproject('zlib' , default_options: ['default_library=static' ])
deps += zlib_proj.get_variable('zlib_dep' )
endif
dependency('fmt' , fallback: ['fmt' , 'fmt_dep' ], default_options: ['default_library=static' ])
3. 版本控制集成
r = run_command('git' , 'describe' , '--tags' , '--always' , check: false)
if r.returncode() == 0
version = r.stdout().strip()
else
version = meson.project_version()
endif
conf_data = configuration_data({
'VERSION' : version,
'GIT_COMMIT' : run_command('git' , 'rev-parse' , '--short' , 'HEAD' ).stdout().strip()
})
configure_file(
input : 'version.h.in' ,
output: 'version.h' ,
configuration: conf_data
)
4. 条件编译优化
platform_sources = []
if host_machine.system() == 'windows'
platform_sources += 'platform_win32.cpp'
elif host_machine.system() == 'darwin'
platform_sources += 'platform_macos.cpp'
else
platform_sources += 'platform_linux.cpp'
endif
executable('myapp' , 'main.cpp' , platform_sources,
dependencies: deps)
5. 性能优化技巧
sources = files(
'src/file1.cpp' ,
'src/file2.cpp' ,
'src/file3.cpp'
)
enable_gui = get_option('enable_gui' )
foreach source : sources
if enable_gui
endif
endforeach
Meson 的生态系统
1. WrapDB：在线依赖仓库
[wrap-file]
directory = fmt-8.0 .1
source_url = https://github.com/fmtlib/fmt/releases/download/8.0 .1 /fmt-8.0 .1 .zip
source_filename = fmt-8.0 .1 .zip
source_hash = 5 d98c504d0205c3101...
patch_url = https://wrapdb.mesonbuild.com/v2/fmt_8.0.1 -1 /get_patch
patch_filename = fmt-8.0 .1 -1 -wrap.zip
patch_hash = 1234567890 abcdef...
[provide]
dependency_names = fmt
2. IDE 集成
Visual Studio Code
{
"mesonbuild.buildFolder" : "${workspaceFolder}/build" ,
"mesonbuild.configureOnOpen" : true ,
"C_Cpp.default.configurationProvider" : "mesonbuild.mesonbuild"
}
CLion
原生支持 Meson 项目
自动检测 meson.build 文件
集成构建和调试
GNOME Builder
深度集成 Meson
可视化构建配置
一键运行和调试
3. 持续集成
name: Meson Build
on:
push:
pull_request:
jobs:
build:
strategy:
matrix:
os: [ubuntu-latest , macos-latest , windows-latest ]
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v3
- name: Install Meson
run: pip install meson ninja
- name: Configure
run: meson setup build
- name: Build
run: meson compile -C build
- name: Test
run: meson test -C build --verbose
实际案例研究
案例 1：GTK 迁移到 Meson
GTK 是 GNOME 的 UI 工具包
原使用 Autotools，构建复杂，Windows 支持差
2016 年开始迁移到 Meson
案例 2：Systemd 的构建现代化
复杂的构建逻辑
多平台支持
与 Linux 发行版集成
if get_option('networkd' )
subdir('src/network' )
endif
if get_option('timesyncd' )
subdir('src/timesync' )
endif
if host_machine.system() == 'linux'
elif host_machine.system() == 'freebsd'
endif
构建配置从混乱变得清晰
更好的交叉编译支持
更快的构建速度
Meson 的优缺点分析
优点
1. 卓越的开发体验
executable('myapp' , sources, dependencies: deps, install: true)
2. 极致的构建速度
$ time meson compile -C build
real 0m1.234s
3. 优秀的跨平台支持
真正的跨平台，无需特殊适配
统一的 Windows/Linux/macOS 体验
优秀的交叉编译支持
4. 现代化的依赖管理
WrapDB 提供预打包依赖
优雅的 fallback 机制
支持源码构建和系统包
5. 友好的错误信息
meson.build:42 :0 : ERROR: Unknown variable "my_sources" . Did you mean "sources" ?
缺点
1. 相对较新
生态系统不如 CMake 成熟
某些特殊场景支持不足
企业采用率还在增长中
2. 灵活性限制
3. Windows 上的 Python 依赖
需要 Python 环境
某些企业环境限制 Python 安装
4. 学习资源相对较少
相比 CMake，教程和文档较少
高级用例的示例不多
未来发展方向
1. 语言支持扩展
rust = import ('rust' )
rust_lib = rust.static_library('mylib' , 'src/lib.rs' )
2. 更好的 IDE 集成
3. 云端构建支持
meson setup --distributed-build
4. 包管理器集成
总结：构建系统的未来已来 Meson 代表了一种新的构建系统哲学：开发者体验至上 。它证明了：
构建系统可以是友好的 速度与易用性可以兼得 跨平台不必复杂 对于新项目，Meson 是一个极佳的选择。它的学习曲线平缓，生产力提升明显。即使对于现有项目，如果构建配置成为瓶颈，迁移到 Meson 也是值得考虑的。
pip install meson ninja
mkdir myproject && cd myproject
cat > meson.build <<EOF
project('myapp', 'cpp')
executable('myapp', 'main.cpp')
EOF
meson setup build
meson compile -C build
./build/myapp
在软件开发中，好的工具应该让人几乎感觉不到它的存在。Meson 正在向这个目标迈进——让开发者专注于代码，而不是构建系统的复杂性。
无论你是 C/C++ 新手还是经验丰富的开发者，Meson 都值得一试。它可能会改变你对构建系统的看法，甚至让你享受配置构建的过程。
微信扫一扫，关注极客日志 微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
相关免费在线工具 Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
Markdown 转 HTML 将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
HTML 转 Markdown 将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
JSON 压缩 通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
JSON美化和格式化 将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online
