基于AScript的Lua脚本语言发布啦

AScript是一个开源的C#动态脚本解析执行引擎，支持扩展多种脚本语言，2026年8月12日正式发布了lua脚本语言AScript.Lang.Lua，快来试试吧！

一、介绍

支持 Lua 基础语法和数据类型，以及表、元表、面向对象、模块等功能。

二、安装

install-package AScript
install-package AScript.Lang.Lua

三、使用说明

• 命名空间：using AScript.Lang.Lua;
• 常用数据类型：
• nil: 空值
• boolean: 布尔值 (true, false)
• number: 数值 (整数和浮点数)
• string: 字符串
• table: 表 (数组)
• 运算符
• 算术运算符: +, -, *, /, %, ^ (幂), // (整数除法)
• 关系运算符: <, >, <=, >=, ==, ~=
• 逻辑运算符: and, or, not
• 连接运算符: .. (字符串连接), # (长度)
• 赋值运算符: =, +=, -=, *=, /=, %=, ^=, ..=
• 控制结构
• 条件语句: if ... then ... elseif ... then ... else ... end
• while循环: while ... do ... end
• repeat循环：repeat ... until ...
• 数值for循环: for i = start, end, step do ... end
• 泛型for循环: for v in expr do ... end
• 泛型for循环: for i,v in expr do ... end
• 函数定义: function name(args) ... end
• 匿名函数：local f = function(args) ... end
• 局部变量: local var = value
• 表构造器
• 数组风格: { value1, value2, value3 }
• 字典风格: { key1 = value1, key2 = value2 }
• 混合风格: { 1, 2, name = "test" }

1、注册语言

Script.Langs.Set("lua", LuaLang.Instance);
// 可全局设置为默认语言
// Script.Langs.Set("lua", LuaLang.Instance, setDefault: true);

2、字符串连接

两个字符串连接使用..操作符而不是+操作符。

var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual("hello123", script.Eval("'hello'..123"));

3、数据打包/解包

// 打包
string s = @"
local format='<i4i4fc10'
local hp=12500
local mp=8700
local atk=156.5
local name='john'
local data = string.pack(format, hp, mp, atk, name)
print(#data) -- 控制台输出data长度
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
script.Eval(s);
// 解包
script.Eval("local a,b,c,d=string.unpack(format, data)");
Assert.AreEqual(12500, script.Eval("a"));
Assert.AreEqual(8700, script.Eval("b"));
Assert.AreEqual(156.5, script.Eval("c"));
Assert.AreEqual("john", script.Eval("d"));

4、条件语句

string code = @"
local x = 10
if x >= 10 and x < 50 then
    local a = 5
    local b = 15
    x = a + b + 80
elseif x >= 50 and x < 100 then
    x = 200
else
    x = 300
end
x
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual(100L, script.Eval(code));

5、while循环

string code = @"
local i = 0
local sum = 0
while i < 5 do
    i = i + 1
    sum = sum + i
end
sum
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual(15L, script.Eval(code));

6、数值for循环

• 语法：for i=start,end[,step] do ... end，其中step默认为1
• 注：循环体内部改变循环变量i的值，不影响循环次数

string code = @"
local sum = 0
for i = 1, 5 do
    i = i + 10
    sum = sum + i
end
sum
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual(65L, script.Eval(code));

7、泛型for循环

string code = @"
local sum = 0
-- for v in ipairs({1, 2, 3, 4, 5}) do
for i, v in ipairs({1, 2, 3, 4, 5}) do
    sum = sum + v
end
sum
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual(15L, script.Eval(code));

8、函数

string code = @"
function factorial(n)
    if n <= 1 then
        return 1
    end
    return n * factorial(n - 1)
end
factorial(5)
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual(120L, script.Eval(code));

9、表（数组）

string code = @"
local arr = {10, 20, 30}
arr[1] + arr[2] + arr[3]
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual(60L, script.Eval(code));

10、表（字典）

string code = @"
local t = { x = 3, y = 5 }
t.sum = function(a,b) 
    print(a,b)
    return a+b 
end
t.sum(t.x,t.y)
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual(8L, script.Eval(code));

11、元表

string code = @"
local t = {}
local metatable = { __index = { name = 'tom' } }
setmetatable(t, metatable)
t.name
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual("tom", script.Eval(code));

12、面向对象(OOP)

string code = @"
-- 定义动物类（Animal）
Animal = {name = 'Unknown'}

-- Animal 类的构造函数
function Animal:new(name)
  local o = {}
  setmetatable(o, self)  -- 设置元表，使其继承 Animal 的方法
  self.__index = self  -- 让对象可以访问 Animal 的方法
  o.name = name or 'Unknown'  -- 设置名称，默认为 'Unknown'
  return o
end

-- Animal 类的方法：叫声
function Animal:speak()
  return self.name .. ' makes a sound.'
end

-- 定义狗类（Dog），继承自 Animal
Dog = Animal:new()  -- Dog 继承 Animal 类

-- 重写狗类的构造函数
function Dog:new(name, breed)
  local o = {}
  setmetatable(o, self)  -- 设置元表，使其继承 Dog 和 Animal 的方法
  self.__index = self  -- 让对象可以访问 Dog 的方法
  o.name = name or 'Unknown'
  o.breed = breed or 'Unknown'
  return o
end

-- 重写狗类的叫声方法（重写 Animal 的 speak 方法）
function Dog:speak()
  return self.name .. ' barks.'
end

-- 创建 Animal 对象
local animal = Animal:new('Generic Animal')
local s1 = animal:speak()  -- 输出 'Generic Animal makes a sound.'

-- 创建 Dog 对象
local dog = Dog:new('Buddy', 'Golden Retriever')
local s2 = dog:speak()  -- 输出 'Buddy barks.'
s1 .. ';' .. s2
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual("Generic Animal makes a sound.;Buddy barks.", script.Eval(code));

13、模块

使用require引入模块，优先查找IScriptModule模块，再查找模块目录中的模块文件。

1）添加模块目录

LuaLang.Instance.Modules.AddDir("./lua/modules");

2）模块目录中添加Person.lua文件

Person = {name = '', age = 0}

function Person:new(name, age)
    local obj = {}  -- 创建一个新的表作为对象
    setmetatable(obj, self)  -- 设置元表，使其成为 Person 的实例
    self.__index = self  -- 设置索引元方法，指向 Person
    obj.name = name
    obj.age = age
    return obj
end

function Person:introduce()
    return 'My name is ' .. self.name .. ' and I am ' .. self.age .. ' years old.'
end

return Person

3）引入并使用模块

string code = @"
require 'Person'
local person1 = Person:new('Alice', 30)
person1:introduce()
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual("My name is Alice and I am 30 years old.", script.Eval(code));

14、io模块

文件操作，服务端请谨慎使用，避免脚本恶意修改、删除文件。

1）安装模块

install-package AScript.Lang.Lua.io

2）注册io模块

LuaLang.Instance.Modules.Add("io", new AScript.Lang.Lua.io.LuaIOModule());

3）使用io

string code = @"
require 'io'
local f = io.open(file, 'w')
f:write('hello')
f:close()
local f = io.open(file, 'r')
local content = f:read()
f:close()
content
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
script.Context.SetVar("file", "./test.txt");
Assert.AreEqual("hello", script.Eval(code));

四、与宿主程序交互

1、脚本调用C#函数

var code = @"
local a = 10
local b = 20
sum(a, b)
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
// 注入函数
script.Context.AddFunc<long, long, long>("sum", (x, y) => x + y);
Assert.AreEqual(30L, script.Eval(code));

2、C#调用脚本中的函数

var code = @"
function sum(x,y)
    return x+y
end
local a = 10
local b = 20
sum(a, b)
";
var script = new Script();
script.Context.Langs = new[] { "lua" };
Assert.AreEqual(30L, script.Eval(code));
// 获取脚本中的函数
var sum = script.Context.GetFunc<long, long, long>("sum");
Assert.AreEqual(80L, sum(30, 50));

五、结束语

更多语法、功能请参考Lua 教程 | 菜鸟教程。

AScript开源地址：https://gitee.com/rockey627/AScript