PowerShell中`:Label foreach`语法的文档及用法咨询

基本概念 #

带标签的 foreach 是 PowerShell 标签化循环的一种实现，核心就是给循环起个自定义名称（标签），方便在嵌套循环或复杂逻辑里精准控制外层循环的流程，而不是只能操作当前所在的内层循环。语法就是在 foreach 前加 :标签名，比如你看到的 :tokenLoop foreach ($token in $tokens) {}。

具体用法 #

1. 定义带标签的循环 #

格式很简单：

:自定义标签名 foreach ($元素 in 集合) {
    # 循环逻辑
}

示例里的 tokenLoop 就是给这个遍历 token 的 foreach 循环起的标签名。

2. 通过标签控制循环 #

主要用 break 和 continue 配合标签来实现精准控制：

• break 标签名：直接跳出标签对应的外层循环，不管当前在嵌套的哪一层
• continue 标签名：跳过标签循环的当前迭代，直接进入下一次循环

看你提供的示例代码，最关键的用法就在内层的 do/until 循环里：

do {
    if (-not $foreach.MoveNext()) {
        break tokenLoop  # 直接跳出外层的 tokenLoop 循环，而非仅退出当前 do/until
    }
    $token = $foreach.Current
} until ($token.Kind -in @('Generic', 'Identifier'))

这里当 token 枚举器耗尽（MoveNext() 返回 false）时，用 break tokenLoop 直接终止整个外层的 token 遍历循环，不用再继续处理剩下的 token，这就是标签的核心价值——避免嵌套循环里只能逐层跳出的麻烦。

3. 注意点 #

• 标签名要符合 PowerShell 命名规则，别用空格或特殊字符，建议用驼峰式命名
• 标签只在当前代码块（比如函数、脚本块）内有效，跨作用域用不了
• 不止 foreach，do/while/for 循环都能加标签，用法完全一致

适用场景 #

当你写嵌套循环时，默认的 break 只能跳出当前最内层循环，如果需要直接终止外层循环，带标签的循环就是最简洁的解决方案。比如示例里解析脚本文件的 token 时，一旦枚举器用完，直接终止整个 token 遍历，省去多余的循环判断。

内容的提问来源于stack exchange，提问作者ev-dev