• CLI
• 开发工具

continue是 fish-shell 内置的循环控制命令，用于跳过当前内层循环（for或while）本次迭代中剩余的所有命令，直接进入下一次迭代。本文以 continue 官方文档 为主体，结合 fish 仓库源码中该内建命令的 实现、解析执行逻辑 与 自动化测试，系统讲解continue的语法、用法、边界行为与底层原理，帮助读者在脚本中精准控制循环流程。

命令语法（Synopsis）

LOOP_CONSTRUCT; [COMMANDS ...;] continue; [COMMANDS ...;] end

其中LOOP_CONSTRUCT可以是for循环或while循环。continue本身不接收任何参数，它只需要出现在循环体内即可生效。

功能描述（Description）

continue会跳过当前内层循环当前迭代的剩余部分。所谓"当前内层循环"，指的是词法上包裹continue的最内层for或while循环；与之相对，break 命令用于直接终止当前内层循环。

在 fish 中，continue通常不是孤立使用的，而是被放在条件结构内部，例如 if 语句或 switch 语句中，以便在满足特定条件时跳过本轮迭代的其余逻辑：

for i in *.tmp if grep smurf $i continue end # 如果执行了 continue，下面的 "rm" 会被跳过 rm $i # 这个 "echo" 同样会被跳过 echo $i end

上面这段来自官方文档的示例，其作用是删除所有不包含单词smurf的.tmp文件：当grep smurf $i匹配成功（即文件包含smurf）时，continue使本次迭代跳过rm $i和echo $i，直接进入下一个文件；只有不包含smurf的临时文件才会被删除。

帮助选项

与其他 fish 内建命令一致，continue支持以下帮助选项：

• -h或--help：显示关于该命令的使用帮助。

continue --help

调用帮助选项时，fish 会输出continue的命令帮助文档并以成功状态退出。

使用要点与边界行为

只能在循环体内部使用

continue在语法上要求必须位于循环体内。如果它在循环之外被调用，fish 会报错并返回非零退出状态：

$ continue continue: Not inside of loop

这一检查不仅是语法层面的，运行层面同样会二次校验（详见下文源码剖析），即使通过eval continue或通过变量动态调用（如set c continue; $c）绕过静态检查，也会得到相同的报错。

与 break 的分工

continue与break是一对互补的循环控制命令：

• continue：跳过本次迭代的剩余命令，继续下一次迭代；
• break：跳出整个循环，停止循环执行。

以 测试用例 中的对照示例为例：

# continue：a、b 两次迭代被跳过，只输出一次 Ping for i in a b c if not contains $i c ; continue ; end echo Ping end # 输出：Ping # break：第一次迭代就跳出循环，Pong 一次也不会输出 for i in a b c if not contains $i c ; break ; end echo Pong end

再对比while循环中的行为（同样出自测试文件）：

set i a a a while contains $i a set -e i[-1] echo Foop continue echo Boop # 永远执行不到 end # 输出三行 Foop，Boop 不出现 set i a a a while contains $i a set -e i[-1] echo Doop break echo Darp # 永远执行不到 end # 只输出一次 Doop

与 switch 搭配

continue也常被用在switch结构中，用于在命中某个case后跳过本轮循环的后续代码。来自 basic.fish 测试 的示例：

for i in Test for continue break and switch builtins problems switch $i case Test printf "%s " $i case "for" printf "%s " 3b case "c*" echo pass case break continue # 命中后跳过本轮剩余代码，不再匹配后续 case echo fail # 不会执行 case and break echo fail case "*" echo fail end end

动态调用

由于continue是一个内建命令而非保留字，它可以被存进变量后动态执行（fish 语法层面允许）：

set dyn_continue continue for foo in 1 2 3 $dyn_continue echo "I should be unreachable" end

但要注意，这种动态调用同样受"必须位于循环内"的约束，测试用例 明确验证了在循环外执行$dyn_continue或eval continue会输出continue: Not inside of loop错误。

源码级原理剖析

内建命令入口

continue与break共享同一套底层实现。各自的入口文件 src/builtins/continue.rs 与 src/builtins/break.rs 都只是简单地委托给公共函数builtin_break_continue：

pub fn r#continue( parser: &mut Parser, streams: &mut IoStreams, argv: &mut [&wstr], ) -> BuiltinResult { builtin_break_continue(parser, streams, argv) }

公共实现位于 src/builtins/shared/misc.rs#L931-L978，核心逻辑如下：

1. 解析帮助选项：通过HelpOnlyCmdOpts::parse处理-h/--help，命中则打印帮助并成功返回；
2. 拒绝多余参数：argc != 1时报unknown option错误（STATUS_INVALID_ARGS）。例如continue foo会输出continue: foo: unknown option，这一点也有测试覆盖（basic.fish#L454-L457）；
3. 二次确认处于循环内：代码注释明确指出——虽然 AST 语法检查已经保证continue出现在循环块内，但用户仍可能通过eval continue等途径在运行时动态触发它，因此需要遍历解析器当前的块栈（parser.blocks_iter_rev()），查找是否存在WhileBlock或ForBlock；一旦遇到函数调用块（is_function_call()）就停止向上查找，因为跨函数调用continue是不被允许的。若未找到循环块，则报错Not inside of loop并返回STATUS_CMD_ERROR；
4. 设置循环状态：将解析器的loop_status置为LoopStatus::Continues（continue）或LoopStatus::Breaks（break），然后正常返回。

循环状态机

loop_status字段定义在 src/parser.rs#L1481-L1491，是一个三态枚举：

pub enum LoopStatus { /// 当前循环块正常执行 #[default] Normals, /// 当前循环块应被移除（break） Breaks, /// 当前循环块应被跳过（continue） Continues, }

循环执行器如何消费该状态

continue/break本身不做实际的"跳转"，它只是写入状态；真正消费该状态的是循环执行逻辑 src/parse_execution.rs。

对于for循环（src/parse_execution.rs#L960-L1005），每次迭代都会先把loop_status重置为Normals，然后执行循环体；当检测到EndExecutionReason::ControlFlow（即循环体内执行过continue或break）时：

let do_break = ctx.parser().libdata().loop_status == LoopStatus::Breaks; ctx.parser().libdata_mut().loop_status = LoopStatus::Normals; if do_break { break; // break：跳出 for 循环 } // 否则（Continues）不 break，for 循环自然进入下一次迭代

对于while循环（src/parse_execution.rs#L1240-L1289）逻辑对称：若状态为Breaks则break跳出循环，若为Continues则continue重新评估循环条件后进入下一次迭代。

从源码结构可以推断，这种"内建命令写状态 + 循环执行器读状态"的间接设计，使得continue/break与具体的循环类型解耦，同时也能统一处理eval、变量动态调用等绕过静态语法检查的运行时场景。

与相关命令的关系

总结

continue是 fish 脚本中实现"过滤式迭代"的基础工具，常与if、switch组合，在for/while循环内跳过不符合条件的迭代。使用时只需记住三条规则：不带参数、只能出现在循环体内（且不能跨函数调用）、与break分别负责"跳过本轮"和"跳出循环"。其底层的LoopStatus状态机设计与循环执行器的协作方式，也可作为理解 fish 其他控制流内建命令（如return、exit）的参照。

• CLI
• 开发工具