Wing 语言 while 循环实战:语法、break/continue 控制流与编译器实现
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 输出块):
i从 0 递增到 100,但在i == 20时被break提前终止,因此最大输出到 19;- 每次迭代先执行
i = i + 1,因此进入输出判断时i已经加 1; - 当
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()));
}
从源码可以提炼出两个关键语义:
- 条件类型强制为
bool:validate_type(cond_type, self.types.bool(), condition)意味着如果写成while i(数值)或while "x"(字符串)等非布尔条件,编译期就会报类型错误。Wing 没有“真值/假值(truthy/falsy)”隐式转换,这是与 JavaScript 的重要差异。 - 循环体拥有独立作用域:循环体会创建一个以当前环境为父环境的新
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 循环的处理分为四步,构成完整的编译流水线:
- 词法/语法解析:parser.rs 的
build_while_statement读取条件表达式并构建循环体作用域,产出StmtKind::While { condition, statements };同时为break/continue提供合法性上下文。语法节点定义见 ast.rs。 - 类型检查:type_check.rs 将
StmtKind::While分发到type_check_while,强制条件为bool并建立循环体作用域环境。 - AST 遍历:visit.rs 定义
While节点的访问逻辑(访问条件表达式与循环体),供各类分析器复用。 - JavaScript 代码生成:jsify.rs 将
StmtKind::While翻译为等价的 JavaScriptwhile (...) { ... },将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。