跳转到主要内容
AutoScript 使用 Lua 5.4 作为脚本语言。本页介绍编写 AutoScript 所需的 Lua 基础语法。

​
注释

使用 -- 开头编写单行注释： 
-- 这是一条注释
RESERVE_DATE = dateadd(datenow(), 1)  -- 这也是一条行内注释
AutoScript 仅支持单行注释（--），不支持 Lua 的多行注释（--[[ ]]）。

​
变量赋值

使用 = 进行变量赋值。可操作的目标变量请参见变量参考。 
USERNAME = "alice"
USER_ENABLE = true
RESERVE_DATE = date(2025, 10, 30)
RESERVE_BEGIN_TIME = time(9, 0)
RESERVE_END_TIME = time(21, 30)
赋值必须保持变量原有的类型。例如，不能将字符串赋值给日期类型的变量，也不能将布尔值赋值给整数类型。类型错误会在脚本执行时报错。

​
算术运算

支持基本的算术运算，可用于数值和日期/时间变量的计算： 
-- 数值运算
RESERVE_BEGIN_TIME = RESERVE_BEGIN_TIME + 60      -- 开始时间推迟 60 分钟
RESERVE_END_TIME = RESERVE_END_TIME - 30          -- 结束时间提前 30 分钟

-- 日期运算（使用工具函数）
RESERVE_DATE = dateadd(RESERVE_DATE, 1)           -- 日期延后 1 天
RESERVE_DATE = dateadd(RESERVE_DATE, -3)          -- 日期提前 3 天
对于日期和时间的加减，推荐使用 dateadd() 和 timeadd() 函数。直接使用 + - 进行日期运算可能导致结果含义不明确。

​
条件判断

使用 if / elseif / else 结构进行条件判断。每个 if 块必须以 end 结尾： 
if USER_ENABLE then
    -- 用户启用时执行
    RESERVE_DATE = dateadd(datenow(), 1)
end

if RESERVE_BEGIN_TIME < time(8, 0) then
    RESERVE_BEGIN_TIME = time(8, 0)
else
    RESERVE_BEGIN_TIME = time(9, 0)
end
多条件判断： 
if RESERVE_BEGIN_TIME < time(8, 0) then
    RESERVE_BEGIN_TIME = time(8, 0)
elseif RESERVE_BEGIN_TIME > time(22, 0) then
    RESERVE_BEGIN_TIME = time(22, 0)
else
    RESERVE_BEGIN_TIME = RESERVE_BEGIN_TIME
end

​
比较运算符

运算符说明示例
==等于USERNAME == "alice"
~=不等于USER_ENABLE ~= false
>大于RESERVE_BEGIN_TIME > time(9, 0)
<小于RESERVE_END_TIME < time(22, 0)
>=大于等于RESERVE_BEGIN_TIME >= time(7, 30)
<=小于等于RESERVE_END_TIME <= time(23, 0)

​
逻辑运算符

运算符说明示例
and逻辑与USER_ENABLE and RESERVE_BEGIN_TIME < time(12, 0)
or逻辑或USERNAME == "alice" or USERNAME == "bob"
not逻辑非not USER_ENABLE

​
布尔变量判断

对于布尔类型的变量（如 USER_ENABLE），可以直接作为条件使用，无需显式比较： 
-- 推荐写法
if USER_ENABLE then
    ...
end

-- 等价但不推荐
if USER_ENABLE == true then
    ...
end

​
字符串

字符串使用双引号包裹： 
USERNAME = "20250101001"
AutoScript 不支持字符串拼接（.. 运算符）。字符串变量只能通过直接赋值修改。

​
关键字

以下是 AutoScript 中可用的 Lua 关键字： if elseif else then end and or not true false 以下 Lua 标准功能出于安全考虑不可用：
  • 文件 I/O（io 模块）
  • 模块加载（require、dofile、loadfile）
  • 系统命令执行（os.execute、os.exit）
  • 调试功能（debug 模块）
  • 循环语句（for、while）
出于安全沙箱限制，AutoScript 不支持循环语句。如果你需要为多个用户设置不同参数，建议使用用户分组功能，配合条件判断实现差异化配置。