XMake vs CMake：C++构建工具对比解析

xmake 不是 CMake 的平替，而是以更少配置、更直觉的方式解决 C++ 构建高频痛点的工具，适合中小型项目、快速原型、跨平台 CLI 工具及需灵活定制的场景。

直接说结论：xmake 不是 CMake 的“平替”，而是用更少配置、更贴近直觉的方式解决 C++ 项目构建中高频痛点的工具——尤其适合中小型项目、快速原型、跨平台命令行工具和需要灵活自定义构建逻辑的场景。

为什么 xmake 能绕过 CMake 的典型卡点？

CMake 的 CMakeLists.txt 是声明式 + 过程式混合体，语法松散、变量作用域模糊、错误提示常指向“某行附近”，新手常卡在 find_package 找不到库、target_link_libraries 顺序错、set(CMAKE_CXX_STANDARD 17) 不生效等问题上。

xmake 默认采用 Lua 脚本描述构建逻辑，语法清晰、作用域明确、错误堆栈可读性强。更重要的是：它把“常用操作”封装成开箱即用的接口，比如：

• add_requires("fmt 10.2.1", "openssl 3.2") 自动拉取、编译、缓存依赖（无需手动写 find_package 或维护 vcpkg.json）
• add_rules("mode.debug", "mode.release") 一键切换构建模式，无需手写 if(CMAKE_BUILD_TYPE STREQUAL "Debug")
• xmake run 直接运行目标，不用先 cd build && make && ./main

一个真实可用的 xmake.lua 示例（含依赖、多目标、条件编译）

假设你有一个带 fmt 和 jsoncpp 依赖的 CLI 工具，需在 Linux/macOS/Windows 上构建，并支持启用/禁用日志功能：

add_rules("mode.debug", "mode.release", "mode.releasedbg")

add_requires("fmt >=10.2.1", "jsoncpp >=1.9.5")

target("mytool")
    set_kind("binary")
    add_files("src/*.cpp")
    add_packages("fmt", "jsoncpp")
    add_defines_if(is_mode("debug"), "DEBUG_LOG=1")
    add_cxflags("-Wall", "-Wextra")
    if is_plat("windows") then
        add_cxflags("/std:c++17")
    else
        add_cxflags("-std=c++17")
    end

target("test")
    set_kind("binary")
    set_symbols("debug")
    add_files("test/*.cpp")
    add_packages("fmt", "jsoncpp")
    add_deps("mytool")

注意：add_requires 下载的包默认缓存在 ~/.xmake/cache，重复构建不重复下载；add_deps("mytool") 表示 test 依赖 mytool 的链接产物，xmake 会自动处理头文件路径和链接顺序。

和 CMake 混用不是必须，但可以很轻量

如果你已有成熟 CMake 项目，不想重写全部，xmake 提供了 xmake service cmake 插件，能解析 CMakeLists.txt 并生成 xmake 构建方案（仅限基础语法，不支持复杂宏展开或自定义命令）。但更实用的做法是「渐进替换」：

• 保留原有 CMake 构建流程，用 xmake project -k cmake 生成 build/CMakeLists.txt 供 CI 使用（例如 GitHub Actions 仍跑 cmake .. && make）
• 开发者本地用 xmake 快速迭代，CI 中仍走 CMake 流水线，二者输出一致
• 关键点：xmake 默认生成的二进制路径为 build/linux/x86_64/release/mytool，而 CMake 是 build/mytool，路径差异需在脚本中对齐

容易被忽略的细节：交叉编译与插件生态

xmake 的交叉编译配置比 CMake 更直接——不需要写 toolchain 文件，只需：

$ xmake f -p android -a arm64-v8a -m release --ndk=/path/to/ndk
$ xmake

它会自动识别 NDK 版本、设置 STL、链接器路径。但要注意：add_requires 中的包必须有对应平台预编译版本（如 fmt 支持 Android，boost 则部分模块不支持），否则 fallback 到源码编译，可能失败。

插件方面，xmake plugin list 可查内置插件，常用如：

• xmake plugin install luajit：加速 Lua 脚本执行（对超大项目有意义）
• xmake plugin install vscode：生成 .vscode/c_cpp_properties.json，VS Code 自动识别 include 路径
• xmake plugin install package：导出为 deb/rpm/tar.gz 包，CMake 需额外写 CPack 配置

真正麻烦的从来不是“会不会写构建脚本”，而是“改一行配置后，要等多久才能看到结果、出错了到底哪一行没对齐”。xmake 在这里减掉了大量心智负担，但它的生态广度仍不如 CMake —— 尤其在大型工业项目、深度集成 IDE（如 Qt Creator 原生只认 CMake）或需要对接特定构建中间件时，CMake 仍是事实标准。