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 上构建，并支持启用/禁用日志功能：
立即学习“C++免费学习笔记（深入）”；
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 仍是事实标准。
