meson.build需严格遵循Python风格DSL语法：project()必须首行且显式声明语言如['cpp']，缩进、括号、函数名须准确；头文件路径用include_directories()并传入executable()的include_directories:参数；依赖须先定义后引用；调试用ninja -v查看完整命令。
meson.build 文件怎么写才不会被 ninja 报错
meson 不是 Makefile 的替代语法，它用 Python 风格 DSL 描述构建逻辑，但不执行 Python。写错缩进、漏掉括号、用错函数名，ninja 启动前就会失败——因为 meson 生成 ninja.build 是一步式的，出错不给你“部分构建”机会。
常见错误现象：ERROR: Unknown function "executable"（其实是拼成 executabe）、ERROR: Indentation error、ERROR: Expected string but got NoneType（比如 include_directories() 传了空列表没判空）。
-
project()必须是第一行，且语言要显式写['cpp']，只写'c++'或漏掉会默认为 C - 源文件路径是相对于
meson.build所在目录的，不是项目根目录；用files()包裹多个文件比手写字符串列表更安全 - 依赖项必须提前定义：先
lib = static_library(...)，后executable(..., dependencies: lib)，顺序反了会报Unknown variable "lib"
如何让 ninja 正确找到 C++ 头文件和链接库
meson 不自动继承系统头路径或 pkg-config 的 link flags，全靠你显式声明。ninja 构建时找不到 boost/asio.hpp 或链接 -lpthread，问题不在 ninja，而在 meson 没把路径/flag 传给编译器。
使用场景：项目依赖外部库（如 fmt、spdlog）、有自定义 include 目录（如 ./third_party/）、需要链接系统库（如 m、dl）。
立即学习“C++免费学习笔记（深入）”；
- 头文件路径用
include_directories('path/to/headers')，返回对象要传给executable()的include_directories:参数 - 链接库优先用
dependency('fmt')（自动查 pkg-config），fallback 到find_library('m')；硬写link_args: ['-lm']容易跨平台失效 - 若用
subproject()引入第三方，其declare_dependency()输出必须显式传入主项目 target，不能只靠subproject('foo').get_variable('dep')就完事
ninja 构建失败但没看到编译命令？怎么调试
meson 默认静默运行 ninja，出错只显示 ninja: build stopped: subcommand failed.，根本看不到 g++ 命令和具体报错。这不是 ninja 的锅，是 meson 把 stderr 给吞了。
性能影响：加调试参数不影响构建结果，但会显著减慢输出速度（尤其大项目），仅用于排错。
- 运行
ninja -v（在 build 目录下）直接看完整编译命令和错误行，这是最准的 - 想让 meson 生成时就带调试信息，用
meson setup builddir --buildtype=debugoptimized --warnlevel=2，但真正关键还是ninja -v - 如果报错是
undefined reference to `std::cout'，大概率是executable()没设cpp_std: 'c++17'，导致链接器用了旧 ABI
Windows 上用 MSVC 还是 MinGW？meson 怎么切换
meson 不区分“Windows 构建”，它只认工具链。选错会导致 cl.exe 找不到、或 g++.exe 报 unrecognized command line option '-std=c++17'。关键是 meson 能否探测到对应编译器，而不是你本地装了啥。
兼容性影响：MSVC 生成 PDB 和 COFF，MinGW 生成 DWARF 和 PE；混用会导致调试信息失效、链接失败。
- 用 MSVC：确保 cmd 中能直接运行
cl（即已运行 vcvarsall.bat），然后meson setup builddir --vs-ide=vs2022或不加参数让 meson 自动选 - 用 MinGW：必须指定
meson setup builddir --native-file mingw.ini，其中mingw.ini包含[binaries] c = 'x86_64-w64-mingw32-gcc'等字段 - 切工具链必须删掉整个 build 目录重建，meson 不允许在已有 build 中改编译器
最容易被忽略的是：meson 的 cpp_std 控制的是编译器 flag，但标准库实现（libstdc++ vs msvcprt）由工具链决定，两者不匹配时，std::string_view 这类类型会在链接期炸开，而 ninja 日志里只显示符号未定义，看不出根源。
