Go flag.Func 回调返回错误后为什么程序会退出

Go 的 flag.Func 回调返回错误后，程序看起来像是“回调主动退出”，实际退出动作通常来自默认的 flag.CommandLine：它采用 ExitOnError，解析失败后会调用 os.Exit(2)。如果希望上层记录错误、打印自定义提示或继续处理，应创建 flag.NewFlagSet 并选择 ContinueOnError。

退出的根因在 FlagSet，而不在回调

flag.Func(name, usage, fn) 每次遇到对应参数时调用 fn(string) error。当回调返回非 nil 错误，FlagSet.Parse 会把它当作参数值解析失败。解析器随后如何处理，取决于这个 FlagSet 的 ErrorHandling 策略。

全局函数使用的是默认命令行集合。它的策略是 ExitOnError，所以这段写法会在解析失败后直接结束进程：

package main

import (
    "errors"
    "flag"
)

func main() {
    // 全局 CommandLine 默认采用 ExitOnError。
    flag.Func("config", "配置文件路径", func(value string) error {
        if value == "" {
            // 返回错误会被 flag 当成参数解析失败。
            return errors.New("配置文件路径不能为空")
        }
        return nil
    })
    // 这里的 Parse 失败不会回到 main，而是由 ExitOnError 结束进程。
    flag.Parse()
}

用 ContinueOnError 把错误交回业务代码

命令行工具需要统一错误格式、测试解析分支或由上层决定退出时，使用独立的 FlagSet 更稳妥。ContinueOnError 会让 Parse 返回错误，调用方可以记录原因并选择返回，而不是让库层直接终止程序。

package main

import (
    "errors"
    "flag"
    "fmt"
    "os"
)

func parseArgs(args []string) error {
    // 独立 FlagSet 把解析失败交回调用方处理。
    fs := flag.NewFlagSet("worker", flag.ContinueOnError)
    fs.SetOutput(os.Stderr)
    fs.Func("config", "配置文件路径", func(value string) error {
        if value == "" {
            // 回调只描述值的问题，不负责决定进程生命周期。
            return errors.New("配置文件路径不能为空")
        }
        return nil
    })
    if err := fs.Parse(args); err != nil {
        // 这里可以包装错误、记录日志或映射成业务退出码。
        return fmt.Errorf("解析命令行参数失败: %w", err)
    }
    return nil
}

func main() {
    // 上层统一处理错误，避免解析器隐藏退出动作。
    if err := parseArgs(os.Args[1:]); err != nil {
        fmt.Fprintln(os.Stderr, err)
        return
    }
}

上例中的回调只做值校验，parseArgs 负责错误上下文，main 决定输出和退出策略。若这是需要明确非零状态的 CLI，再由 main 调用 os.Exit(2) 即可，退出责任不会藏在 flag.Func 内。

四种处理策略怎么选

还有一个容易忽略的边界：回调可能已经修改了外部变量，随后才返回错误。不要把“回调执行过”当成“解析成功”；只有 Parse 返回 nil 后，才应把这些状态交给后续业务。

相关问题与排查清单

为什么只把 flag.Parse 改成检查返回值仍然无效？

全局 flag.Parse 使用的 FlagSet 仍是 ExitOnError，错误在返回前已经触发退出。需要从创建 FlagSet 的位置改用 ContinueOnError。

flag.Func 和 flag.Var 应该怎么选？

一次性的字符串校验或转换可用 Func；需要保存可读取状态、实现 String/Set 或支持更复杂生命周期时，再定义 flag.Value 使用 Var。

回调应该直接调用 os.Exit 吗？

通常不应该。回调只返回值错误，解析层选择错误策略，业务层决定日志和退出码，职责更容易测试和复用。