首先定义标准退出码并统一在main函数中处理错误，通过os.Exit()返回对应状态；接着使用%w包装错误以保留调用链，同时提供包含上下文的清晰错误信息；然后在程序早期验证输入参数，对必填flag进行检查并输出明确提示；最后通过自定义error类型如usageError区分错误场景，结合errors.As判断是否显示帮助信息。整套机制确保错误可读、可追溯，并提升CLI工具的可用性与健壮性。
在开发Golang命令行工具时，错误处理是保证程序健壮性和用户体验的关键环节。良好的错误处理能让用户清楚知道哪里出了问题，并指导其如何修复。以下是一些实用的错误处理实践，帮助你写出更清晰、可靠的CLI工具。
统一错误返回与退出码设计
命令行工具通常通过退出状态码向外部系统传递执行结果。Go中可以通过os.Exit()设置退出码，建议定义一组标准的退出码：
- 0：成功执行
- 1：未预期的错误（通用错误）
- 2：使用错误（如参数不合法）
- 其他值：根据业务自定义，比如配置加载失败、网络请求超时等
在main函数中集中处理错误并映射到合适的退出码：
func main() {if err := run(); err != nil {
fmt.Fprintf(os.Stderr, "Error: %v\n", err)
os.Exit(1)
}
}
提供清晰的错误信息
避免直接输出panic或原始错误堆栈。应将错误包装成用户可理解的信息。例如，当文件无法打开时，不要只说“open failed”，而应说明是哪个文件、为什么失败：
立即学习“go语言免费学习笔记（深入）”；
if _, err := os.Open(configPath); err != nil {return fmt.Errorf("failed to open config file at %q: %w", configPath, err)
}
使用%w动词包装错误，保留底层调用链，便于调试同时又提供上下文。
验证输入参数
命令行参数往往是错误来源之一。应在早期阶段验证flag、子命令和必填参数。例如使用flag包后检查必要字段：
fmt.Fprintln(os.Stderr, "error: --input is required")
flag.Usage()
os.Exit(2)
}
对于复杂的参数校验逻辑，可以封装为独立函数，在main流程前统一执行，确保错误尽早暴露。
使用error类型区分错误场景
在较复杂的CLI工具中，可通过自定义错误类型判断是否属于“使用错误”或“系统错误”，从而决定显示帮助信息还是仅打印错误详情：
type usageError struct {msg string
}
func (e *usageError) Error() string {
return e.msg
}
在main中判断错误类型，决定是否调用flag.Usage()：
flag.Usage()
os.Exit(2)
} 基本上就这些。关键是让错误可读、可追踪，并配合合理的退出码，让用户和自动化脚本都能正确响应。
