codebuddy 提供五大错误处理智能检查：一、自动识别未用%w的error wrapping；二、校验哨兵错误声明与引用一致性；三、建议关键节点注入上下文；四、辅助errors.is/as安全调用；五、校验自定义错误类型结构。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
一、自动识别并高亮 error wrapping 模式
CodeBuddy 能静态扫描 Go 源码，检测 fmt.Errorf 调用中是否使用 %w 动词进行错误包装。若发现字符串拼接（如 + " failed"）或 fmt.Sprintf 未含 %w，则标记为潜在错误链断裂风险。
1、打开 .go 文件后，CodeBuddy 在右侧问题面板列出所有未使用 %w 的错误构造位置。
2、将光标悬停于 fmt.Errorf("read config: %v", err) 行时，提示框显示：缺少 %w：此写法会丢失原始错误类型，无法用 errors.Is 或 errors.As 判断。
3、点击快速修复建议，自动替换为 fmt.Errorf("read config: %w", err)。
二、哨兵错误（sentinel error）声明与引用一致性检查
CodeBuddy 将包内定义的导出错误变量（如 var ErrNotFound = errors.New("not found")）纳入符号索引，追踪其在函数返回、errors.Is 判断及错误包装中的实际使用路径，确保哨兵语义未被破坏。
1、当用户在 handler 中写 if errors.Is(err, ErrNotFound) 时，CodeBuddy 验证 ErrNotFound 是否为包级导出变量且未被重新赋值。
2、若某处误写为 return errors.New("not found") 替代 return ErrNotFound，CodeBuddy 在该行下方标红并提示：哨兵误用：应返回预定义变量 ErrNotFound，而非新建相同文本的 error。
3、在 errors.Is 调用中，若传入非导出错误变量（如 errInternal），CodeBuddy 显示警告：不可导出哨兵：ErrInternal 无法被其他包安全比较，请提升为导出变量。
三、错误链上下文注入建议
CodeBuddy 分析调用栈深度与错误传播路径，在可能丢失上下文的关键节点（如跨包调用、HTTP handler 入口）主动建议添加语义化包装层，保留原始错误的同时注入操作域信息。
1、当 detectFunc() 返回 err 且当前函数名为 GetUserByID，CodeBuddy 在 return err 前插入轻量提示条：建议包装：return fmt.Errorf("get user by ID %s: %w", id, err)。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
2、若 err 已被包装但未包含关键参数（如 ID、路径、方法名），CodeBuddy 在 fmt.Errorf 调用行右侧显示气泡：上下文缺失：建议加入 id=%q 或 path=%q 提升可追溯性。
3、对嵌套三层以上的错误包装链（如 A→B→C→D），CodeBuddy 在编辑器底部状态栏显示链长提示，并建议审查是否过度包装。
四、errors.Is / errors.As 安全调用辅助
CodeBuddy 对 errors.Is 和 errors.As 的参数进行类型流分析，确保左侧目标错误（如 sql.ErrNoRows）与右侧被检错误（err）存在可达的包装路径，避免恒假判断。
1、当写入 if errors.Is(err, io.EOF) 但 err 来源为 json.Unmarshal，CodeBuddy 标记该条件永不成立，并提示：类型不兼容：json.Unmarshal 不可能返回 io.EOF，请检查错误来源或更换哨兵。
2、在 errors.As(err, &perr) 中，若 *os.PathError 未在 err 的任何包装层级中出现，CodeBuddy 在 &perr 处下划波浪线，并显示：类型不匹配：err 链中无 *os.PathError 实例，As 将始终返回 false。
3、若检测到 errors.Is(err, ErrInvalidInput) 但 ErrInvalidInput 定义在内部未导出包中，CodeBuddy 报告：跨包哨兵不可见：ErrInvalidInput 非导出，外部包无法安全使用 errors.Is。
五、自定义错误类型结构校验
CodeBuddy 解析实现了 error 接口的结构体类型，验证其是否同时满足 Error() 方法实现与可判定性支持（即 Unwrap() 方法），防止仅实现字段而忽略接口契约。
1、当定义 type MyError struct { Code int; Msg string } 但未实现 Error() 方法时，CodeBuddy 在结构体声明行报错：缺失 Error() 方法：MyError 未实现 error 接口，无法作为返回值使用。
2、若已实现 Error() 但未实现 Unwrap()，且该错误常被 fmt.Errorf(... %w) 包装，CodeBuddy 提示：包装不完整：建议添加 func (e *MyError) Unwrap() error { return e.err } 以支持 errors.As 提取。
3、当 Error() 方法体内调用了 fmt.Sprintf 或 JSON 序列化等可能阻塞的操作，CodeBuddy 在方法首行标记性能风险：Error() 含高开销操作：禁止在 Error() 中执行网络、IO 或复杂序列化。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
