Wing 语言 while 循环实战:语法、break/continue 控制流与编译器实现

原创2026-10-12 23:41:051,963 阅读
文章标签:编程语言编译器云原生语言运行时

Wing 语言 while 循环实战:语法、break/continue 控制流与编译器实现

导读

Wing 是一种面向云的原生编程语言,将基础设施定义与运行时逻辑统一到同一门语言中。while 循环是 Wing 控制流的重要组成部分,用于反复检查条件并执行循环体,直到条件变为 false。本文以官方 by-example 文档 07-while.md 为骨架,结合编译器源码(packages/@winglang/wingc)与测试用例,系统讲解 while 循环的语法、break/continue 控制流、类型检查规则、与 for..in 的差异,以及在 preflight/inflight 两种阶段中的使用方式。读完本文,你将能够熟练编写基于 while 的迭代逻辑,并理解 Wing 编译器从解析到 JavaScript 代码生成的全链路行为。

while 循环的基本语法

Wing 的 while 循环与主流 C 系语言风格一致:先求值条件表达式,若结果为 true 则执行循环体,循环体执行完毕后再次检查条件,直到条件为 false 或循环被 break 中断。

官方示例 main.w 展示了最典型的用法:

let var i = 0;

while i < 100 {
  i = i + 1;
  if i == 20 {
    // although the while loop goes to 100, we break it at 20
    break;
  }
  if i % 2 == 0 {
    // continue for even numbers
    continue;
  }
  log("{i}");
}

要点拆解:

  • 循环条件:i < 100 是一个布尔表达式,写在 while 关键字之后、{ 之前,不需要括号包裹(当然也可以使用 (i < 100))。
  • 可变计数器:循环变量 i 使用 let var 声明为可重新赋值变量,并在循环体内通过 i = i + 1 推进。Wing 默认变量不可重新赋值,因此凡是需要修改的循环计数变量都必须带 var 关键字。
  • 字符串插值:log("{i}") 使用 {} 语法将数值 i 插值到字符串中输出,等价于其它语言中的模板字符串。
  • 循环体:用 { } 包裹的语句块,可包含 if、break、continue 以及任意合法语句。

从语法树定义看,Wing 的 while 语句由三部分构成:while 关键字、condition 表达式字段和 block 语句块字段,定义在 tree-sitter 语法文件 grammar.js 中:

while_statement: ($) =>
  seq("while", field("condition", $.expression), field("block", $.block)),

运行方式与输出结果

该文档中的示例可以在本地直接运行。将上述代码保存为 main.w,然后使用 Wing CLI 的本地模拟运行命令:

wing it

wing it 会启动 Wing Console(本地模拟环境),以模拟器(simulator)方式运行 main.w。示例运行的实际输出如下:

1
3
5
7
9
11
13
15
17
19

输出结果解读(对应 07-while.md 的 console 输出块):

  1. i 从 0 递增到 100,但在 i == 20 时被 break 提前终止,因此最大输出到 19;
  2. 每次迭代先执行 i = i + 1,因此进入输出判断时 i 已经加 1;
  3. 当 i % 2 == 0(偶数)时执行 continue,跳过本次剩余语句,因此日志中只出现奇数 1、3、5、…、19。

也就是说,该程序最终打印了区间 (0, 20) 内的全部奇数。若没有 break 和 continue,while i < 100 会一直运行到 i 达到 100,输出区间 (0, 100) 内的所有奇数。

break:提前终止循环

break 用于立即结束当前循环的执行,跳转到循环之后的代码。在示例中,虽然循环条件写的是 i < 100,但当 i 递增到 20 时 break 生效,循环实际在 20 处终止。

语言参考文档 docs/api/05-language-reference.md 明确说明:break 语句可用于结束循环的执行,适用于 for 和 while 循环。

编译器对 break 的使用位置有严格校验。在解析器 parser.rs 中,build_break_statement 会检查当前是否处于循环上下文:

fn build_break_statement(&self, statement_node: &Node) -> DiagnosticResult<StmtKind> {
    if !*self.is_in_loop.borrow() {
        return self.with_error::<StmtKind>(
            "Expected break statement to be inside of a loop (while/for)",
            statement_node,
        );
    }
    Ok(StmtKind::Break)
}

即:如果在循环体外使用 break,编译期会直接报错(错误信息为 "Expected break statement to be inside of a loop (while/for)")。这一合法性检查依赖 build_in_loop_scope(parser.rs)在解析 while/for 循环体期间临时置位 is_in_loop 标志,无需回溯遍历 AST。

continue:跳过本次迭代

continue 用于跳过当前迭代中剩余的语句,直接进入下一轮条件判断。示例中偶数的 i 不会打印,正是 continue 的效果。

语言参考文档 docs/api/05-language-reference.md 说明:continue 语句允许跳到循环的下一次迭代,目前适用于 for 和 while 循环。

与 break 一样,continue 也必须是循环体内的语句,否则解析器会给出类似的编译错误(见 parser.rs 中的 build_continue_statement 对 is_in_loop 的检查)。

条件必须是布尔表达式:类型检查规则

Wing 是强类型语言,编译器要求 while 的条件表达式类型必须为 bool。在类型检查器 type_check.rs 中:

fn type_check_while(&mut self, condition: &Expr, statements: &Scope, env: &mut SymbolEnv) {
    let (cond_type, _) = self.type_check_exp(condition, env);
    self.validate_type(cond_type, self.types.bool(), condition);

    let scope_env = self.types.add_symbol_env(SymbolEnv::new(
        Some(env.get_ref()),
        SymbolEnvKind::Scope,
        env.phase,
        ...
    ));
    self.types.set_scope_env(statements, scope_env);
    self.inner_scopes.push((statements, self.ctx.clone()));
}

从源码可以提炼出两个关键语义:

  1. 条件类型强制为 bool:validate_type(cond_type, self.types.bool(), condition) 意味着如果写成 while i(数值)或 while "x"(字符串)等非布尔条件,编译期就会报类型错误。Wing 没有“真值/假值(truthy/falsy)”隐式转换,这是与 JavaScript 的重要差异。
  2. 循环体拥有独立作用域:循环体会创建一个以当前环境为父环境的新 SymbolEnv,因此循环体内声明的局部变量不会泄漏到循环外,这也与大多数现代语言一致。

while 与 for..in 的对比与选择

Wing 提供两种循环结构:

  • while 循环:以条件表达式驱动,适合“不确定迭代次数、由运行期状态决定何时结束”的场景,例如轮询、计数器、条件收敛等。
  • for..in 循环:以可迭代集合(数组、集合、范围)驱动,适合遍历已有数据,语法与示例详见 05-for.md,例如 for item in 1..3 { ... } 或 for item in arr { ... }。

两者共同支持 break 和 continue,但语义不同:for..in 的循环变量由迭代器提供且不可修改,而 while 通常需要显式维护可变计数器(let var)。

在 inflight 阶段使用 while:循环条件可以是任意表达式

Wing 将代码分为 preflight(部署期)与 inflight(运行期)两个阶段。while 循环在这两个阶段均可使用,且循环条件并不局限于简单的比较表达式——它可以是任意布尔表达式,包括对 inflight 闭包的调用。

测试文件 while_loop_await.test.w 演示了这一能力:

bring cloud;

let queue = new cloud.Queue();

let handler = inflight (body: str): void => {
    let i = 0;
    let iterator = inflight (j: num): num => {
        return j+1;
    };
    while iterator(i) < 3 {
        log("{i}");
    }
};

queue.setConsumer(handler);

这里 while 的条件是 iterator(i) < 3,其中 iterator 是一个 inflight 闭包,每次循环都会调用它来推进计数。这证明 Wing 的 while 条件求值发生在 inflight 运行时,可用于编写云函数内的事件轮询、重试等逻辑。

从源码看 while 的完整编译链路

Wing 编译器(wingc,Rust 实现)对 while 循环的处理分为四步,构成完整的编译流水线:

  1. 词法/语法解析:parser.rs 的 build_while_statement 读取条件表达式并构建循环体作用域,产出 StmtKind::While { condition, statements };同时为 break/continue 提供合法性上下文。语法节点定义见 ast.rs。
  2. 类型检查:type_check.rs 将 StmtKind::While 分发到 type_check_while,强制条件为 bool 并建立循环体作用域环境。
  3. AST 遍历:visit.rs 定义 While 节点的访问逻辑(访问条件表达式与循环体),供各类分析器复用。
  4. JavaScript 代码生成:jsify.rs 将 StmtKind::While 翻译为等价的 JavaScript while (...) { ... },将 break/continue 翻译为 break;/continue;:
StmtKind::While { condition, statements } => {
    code.open(new_code!(
        &condition.span,
        "while (",
        self.jsify_expression(condition, ctx),
        ") {"
    ));
    code.add_code(self.jsify_scope_body(statements, ctx));
    code.close("}");
}
StmtKind::Break => code.line("break;"),
StmtKind::Continue => code.line("continue;"),

此外,is_valid_module_statement(parser.rs)将 While 排除在模块顶层语句之外——也就是说,while 只能出现在函数、方法或类等语句块内部,不能出现在文件顶层直接书写。

测试用例验证

仓库中的测试用例覆盖了 while 循环的各类边界场景,可作为行为契约参考:

  • while.test.w 覆盖了多种形态:
    • while false { ... }(条件恒为 false,循环体不执行);
    • while true { z = z + 1; if (z > 2) { break; } } 配合 assert(z == 3) 验证 break 语义;
    • while true { break; }(空循环体 + 立即中断);
    • while i < 10 中配合 continue 只累加奇数计数,assert(i == 10); assert(v == 5) 验证 continue 语义。
  • while_loop_await.test.w 验证 inflight 闭包作为循环条件的用法(见上一节)。

这些断言表明:Wing 编译器对 while 的编译结果在运行时严格遵循“条件为 true 才进入循环体”“break 立即退出”“continue 跳转到下一轮条件判断”的标准语义。

小结

  • 语法:while <bool 条件> { ... },条件无需括号;循环体为独立作用域。
  • 控制流:break 提前终止整个循环;continue 跳过当前迭代进入下一轮;两者都只能在循环体内使用,否则编译报错。
  • 类型:条件必须是 bool,不存在 truthy/falsy 隐式转换;循环计数变量需用 let var 声明。
  • 适用场景:不确定迭代次数、依赖运行期状态(含 inflight 闭包调用)的循环用 while;遍历集合/范围用 for..in。
  • 实现:从语法树(tree-sitter)、解析、类型检查到 JS 生成的完整链路见 grammar.js、parser.rs、type_check.rs、jsify.rs,测试契约见 while.test.w。
登录后查看全文
wing