模块、注解与平台

一个 .kly 文件对应一个模块。模块名与路径对应：module math.vector; 通常位于 math/vector.kly。

module app.main;
import math.vector;

@main
pub fn main() -> i32 {
  return math.vector.answer();
}

声明默认只在本模块可见；pub 让其他模块可以使用。import 将公开名称带入当前模块，名称冲突时可使用完整限定名。

注解

注解以 @ 开头，可修饰声明或参数。例如 @main 指定入口，@virtual 标记虚方法，Shader 使用 @vertex 和 @fragment。用户也可以声明带参数的注解。

条件编译

@cfg 可在顶层按目标系统和架构选择模块或声明。

@cfg(os.Windows, arch.X86_64)
module app.windows;

条件在依赖加载和语义检查之前生效。跨目标链接仍需要相应平台工具链和库。平台 API 的示例见窗口与 UI。

os 与 arch 是 std.annotation 的枚举；只有一个条件时可直接写 @cfg(arch.X86_64)。两个枚举参数也可交换顺序，编译器按类型绑定。字符串条件不再接受。