不该从零手写跨平台构建生成器，因99%项目无需重复造轮子，且极易在路径处理、Shell兼容性上失败；应借鉴Premake思路，用Lua+模板生成Ninja/Make/VS文件，专注逻辑表达与backend适配。
为什么不该从零手写跨平台构建生成器
直接写一个能替代 CMake 或 Premake 的构建生成器，99% 的项目不需要，而且大概率会卡在「路径处理」或「Shell 兼容性」上崩掉。CMake 用了二十多年才把 Windows cmd.exe、PowerShell、MSYS2 bash、macOS zsh、Linux dash/bash 的命令行语义差异收拢清楚；Premake 用 Lua 做抽象层也花了大量精力绕开 Makefile 的隐式规则歧义和 Ninja 的 pool 限制。你真正需要的，通常是「控制构建逻辑表达」+「按目标生成对应 backend 文件」，而不是重实现 Ninja 解析器或 MSBuild schema 验证器。
用 Lua + 模板生成 Ninja / Make / Visual Studio 文件最实际
Premake 本质就是这个路子：用 Lua 描述 project/target/dependency，再通过模板（premake5.lua 中的 buildcommands、filter 等）展开成具体 backend 文件。你自己做，可以更轻量：
- 核心只保留
project()、target()、files()、links()这几个函数，其余全靠 Lua 表驱动 - 为 Ninja 写一个纯文本模板（用
string.gsub填值），避免引入复杂模板引擎；Ninja 语法简单、无条件逻辑、易验证 - Windows 上生成
.vcxproj不必手写 XML，用io.write拼接即可——VS 只校验基本 schema，不深究 namespace 或 order - Makefile 模板里所有路径必须用
$(abspath ...)或$(shell cd ... && pwd)归一化，否则 macOS/Linux 的../展开行为不一致
路径与分隔符处理是跨平台第一道坎
用户写的 sources = { "src/main.cpp", "lib/utils.h" } 在 Windows 上可能被传进来的路径含反斜杠，而 Ninja 要求正斜杠，MSVC 却接受两者。硬统一成正斜杠最稳：
- 读入路径后立刻用
string.gsub(path, "\+", "/")归一化 - 拼接输出路径时，永远用
string.format("%s/%s", dir, file)，别用..操作符 - 调用系统命令（如
cl.exe或clang++）前，对参数中的路径再过一遍os.getenv("PWD")或io.popen("cd"):read()确保是绝对路径——尤其在 VS 的CustomBuildStep里，工作目录极不可靠 - Ninja 的
rspfile必须用 Unix 换行符（cl.exe @foo.rsp会读错行
不要碰 shell 命令拼接，改用内置规则或 wrapper 脚本
比如想加个自定义编译前步骤：run("python3 gen_bindings.py --out $OUT")，直接拼字符串会挂：
AI 领域系统学习体系。管理知识图谱、深度学习笔记、实战复盘和关联网络。触发场景：学习计划、知识图谱更新、深度研究某个 AI 主题、实战复盘总结、调研后沉淀知识、每周学习回顾。当用户说'学了什么'、'总结一下'、'沉淀知识'、'复盘'、'更新图谱'、'深入研究'、'写笔记'、'学习回顾'、'review what...
立即学习“C++免费学习笔记（深入）”；
- macOS 和 Linux 默认用
/bin/sh，不支持$OUT，得写成${OUT}；但 Windows 的cmd.exe又不认${} - 更糟的是，路径含空格时，
"C:/Program Files/..."在 Ninja 的command = python3 "$SCRIPT" --out "$OUT"里，双引号会被 Ninja 自己吃掉一层
解法很简单：所有命令走 wrapper 脚本。生成 gen_bindings.py.bat（Windows）和 gen_bindings.py.sh（Unix），并在 Ninja 中写 command = ./gen_bindings.py.sh $in $out。脚本内部用各自平台原生方式处理路径和变量，构建生成器只管调用固定名。
真正的难点不在语法，而在让用户写的 filter("config:Debug") 和生成的 cl.exe /MDd、gcc -D_DEBUG 之间保持可预测映射——这需要你明确定义配置维度（platform/config/arch/toolset），并拒绝支持模糊匹配。一旦开始做「自动推导」，就离 Premake 的 issue 列表不远了。
