# Lua 2.5 分支移植评估（ADAPTATION.md）

> 本分支已 vendor Lua 2.5 官方源码到 `lib/lua/`（src/ + include/）。
> **桥接层尚未适配，且不建议移植。**

## 结论：不建议移植

Lua 2.5（1996）与 Lua 3.2 同属"前 lua_State 时代"，且比 3.2 更原始：

1. **全局单例状态机** —— `lua_open(void)` 无参数无句柄，与本项目多 runner 实例抽象根本冲突
2. **fallback 机制而非 metatable** —— 面向对象模型完全不同
3. **无独立编译** —— `lua_dofile(char*)` 一步式，管道模式的块压栈不可实现
4. **upvalue 语义缺失** —— 闭包模型尚未引入（3.1 才有 upvalue）
5. 1996 年代码，现代编译器需多处修正才能通过（K&R C 残留）

若确需支持历史脚本，建议直接用 Lua 5.1 的兼容模式跑（语法子集大部分兼容），
或参考 lua_3.2 分支的评估做极简 doString-only 桥接。

本分支仅作为源码存档。