不能用 errors.New 直接当全局错误变量用，因为每次调用都会创建新实例，内存地址不同导致 == 比较失败；哨兵错误需为同一地址的导出包级变量，如 var ErrNotFound = errors.New("user not found")。
为什么不能用 errors.New 直接当全局错误变量用
因为每次调用 errors.New 都会新建一个 error 实例，内存地址不同，== 比较必然失败。下游代码写 if err == ErrNotFound 就永远进不去分支——哪怕错误消息一模一样。
- 哨兵错误的本质是「单例标识」，必须靠同一地址实现值比较
- 导出的变量名必须大写（如
ErrNotFound），否则包外不可见 - 不能在函数里重复声明，比如
func handle() { var ErrNotFound = errors.New("not found") }—— 这不是哨兵，只是个局部变量 - 别用
fmt.Errorf("not found: %w", err)初始化哨兵，它返回的是*fmt.wrapError，底层结构不兼容==
怎么正确定义一个包级 ErrXXX 变量
在包根目录下建 errors.go，用 var 声明一次、导出、带 Err 前缀：
package user
import "errors"
var (
ErrNotFound = errors.New("user not found")
ErrInvalidID = errors.New("invalid user ID")
ErrPermission = errors.New("permission denied")
)
- 所有哨兵集中放一个文件，避免散落在
internal/或子模块里——使用者得能import "yourpkg"就拿到 - 不要加
const：Go 没有「错误常量」语法，const无法满足error接口要求 - 消息字符串保持简洁，不带动态内容（如 ID、时间戳），否则就该换成自定义错误类型
- 如果包有多个子功能（如
user/auth,user/profile），哨兵仍定义在user主包，不拆分
== 和 errors.Is 到底该用哪个
优先用 ==，仅当错误可能被 %w 包装时才切到 errors.Is。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
-
if err == user.ErrNotFound最快、最直接，适用于未包装的原始错误 -
if errors.Is(err, user.ErrNotFound)能穿透fmt.Errorf("loading failed: %w", err)多层包装 - 别混用：
errors.Is(err, errors.New("user not found"))永远 false —— 你 new 的不是那个哨兵变量 - 测试里别伪造哨兵，比如
return errors.New("user not found")；应直接返回user.ErrNotFound或用errors.Is断言
什么情况不该用哨兵错误
哨兵只适合「无状态、纯语义标识」的错误。一旦需要携带上下文（比如失败的字段名、HTTP 状态码、重试次数），就必须换路子。
立即学习“go语言免费学习笔记（深入）”；
- 错误消息含变量：
"failed to parse field 'name': invalid format"→ 改用自定义结构体 +Unwrap()/Is() - 需要日志中提取结构化字段（如
StatusCode）→ 自定义类型比字符串拼接可靠得多 - 想支持
errors.As(err, &e)提取原始错误值 → 哨兵做不到，必须实现接口 - 第三方库返回的错误（如
redis.Nil）已自带哨兵，别自己再造一个同名变量去比
容易被忽略的一点：哨兵错误和自定义错误类型不是二选一，而是协作关系——前者做顶层分类，后者承载细节。错把上下文塞进 ErrInvalidID 的字符串里，后面谁都救不了你。
