Golang CLI程序中如何输出错误_Golang终端程序错误提示规范

错误必须写到 stderr，使用 fmt.Fprintln(os.Stderr, err) 或 log.New(os.Stderr, "", 0).Println(err)；错误信息应简洁具体，如 "open config.yaml: permission denied"，不加 ERROR 等前缀；通过 %w 保留原始错误链，支持 errors.Is/As 检查；在 main 中统一处理错误输出与退出码，避免中间函数调用 os.Exit。

Go CLI 程序输出错误，核心是：用 os.Stderr 输出、不带多余前缀、末尾不加换行（由调用者控制）、错误信息清晰具体、不掩盖原始错误链。

错误必须写到 stderr，而不是 stdout

终端程序区分标准输出（stdout）和标准错误（stderr），前者用于正常结果，后者专用于错误和警告。用户可能重定向 stdout（如 mycmd > out.txt），但 stderr 仍会显示在终端，确保错误不被丢弃。

正确做法：

用 fmt.Fprintln(os.Stderr, "error: ...")
或更推荐：log.New(os.Stderr, "", 0).Println("error: ...")（避免全局 log.SetOutput 影响其他部分）
避免：fmt.Println("error: ...")（默认写到 stdout）

错误信息格式简洁明确，不加冗余前缀

不要自动加 ERROR:、[ERR] 或时间戳——CLI 用户习惯阅读原生、紧凑的错误描述。前缀应由上层统一处理（比如主函数统一包装），或完全交由调用方决定。

好例子：

open config.yaml: permission denied（直接复用 err.Error()）
invalid port number "abc": strconv.ParseInt: parsing "abc": invalid syntax

坏例子：

ERROR: open config.yaml: permission denied（前缀多余）
[2025-05-12 10:30:00] FATAL: ...（时间戳+级别对 CLI 不必要）

保留错误上下文与原始原因，善用 `%w` 和 `errors.Join`

不要用 fmt.Sprintf("failed to read %s: %v", file, err) 吞掉原始 error。要支持错误检查（errors.Is / errors.As）和展开（errors.Unwrap）。

推荐写法：

return fmt.Errorf("read config file %q: %w", path, err)
多个错误合并：errors.Join(err1, err2)（Go 1.20+）
最终输出时，可调用 errors.Unwrap 或 errors.Format（需自定义）展示全链，但多数 CLI 直接输出最外层 err.Error() 即可，够用且干净

主函数结尾统一处理错误退出

在 main() 函数中，用一个 if err != nil 块集中处理所有错误输出和退出码，保持逻辑清晰。

典型结构：

func main() {
    if err := run(); err != nil {
        fmt.Fprintln(os.Stderr, err)
        os.Exit(1)
    }
}

注意：

不要在中间函数里调用 os.Exit 或 log.Fatal——这会让测试变困难、无法拦截错误
若需不同退出码（如 2 表示命令行参数错），可用自定义错误类型实现 interface{ ExitCode() int }，然后在 main 中判断

基本上就这些。不复杂但容易忽略——关键是把 stderr 当“错误专用通道”，把 error 当“可传递、可检查的数据”，而不是字符串日志。

# go # golang # ai # if # format # Error # 字符串 # 命令行参数 # int # Interface # nil # number # 写到 # 不加 # 错误信息 # 自定义 # 而不是 # 中统 # 多个 # 不被 # 不带 # 这会

返回目录在线咨询

上一篇：解析IIS日志文件以提升网站安全性和SEO排名的方法有哪些？
下一篇：解决本机建站无法访问：检查服务器配置的几个关键点

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。