Zinc（本项目）语法与约定

必须遵守

• •用 //! zinc / //! endzinc 包裹 Zinc 代码块。
• •禁用 ++/--；用 += 1 / -= 1。
• •禁用 break/continue；用 if 分支或布尔开关改写。
• •数组声明一律用 type name[];，不要写大小（例如 integer a[10] 是错的）。
• •返回类型用 -> type 写在参数列表后；无返回可省略。
• •局部变量统一在函数/匿名函数开头声明：先基础类型，后句柄类型。

匿名函数（无闭包）

• •匿名函数内不能直接访问外层局部变量；需要显式传参。
• •传参优先用结构体/库的 static 成员变量，并在回调结束后立刻清理为默认值（null/0/""）。
• •临时触发器回调用 CreateTrigger + TriggerAddCondition + TriggerEvaluate，随后 DestroyTrigger 并置 null。

句柄生命周期（资源释放）

• •创建出来的句柄资源（timer/trigger/group/effect/location/...）：按对应 Destroy* / Remove* API 释放，并在作用域末尾 = null。
• •结构体析构只写 method onDestroy()；不要自定义 destroy()。

结构体/方法写法

• •静态方法：static method foo(...) -> type { ... }
• •实例方法：method foo(...) -> type { ... }
• •纯静态“管理器”可用 struct X [] { ... }（避免 create/destroy）。

JASS -> Zinc 迁移要点

• •JASS 默认 public；Zinc 默认 private：需要对外可见的函数/全局变量要显式 public。
• •loop/exitwhen/endloop 优先改写为 Zinc 的范围 for (a <= i <= b) 或常规 for。
• •timer/trigger 的一次性逻辑优先改成匿名回调。

References（按需加载）

• •references/jass-to-zinc.md
• •references/anonymous-functions.md
• •references/callback-params.md
• •references/method-syntax.md