errorsAsType按泛型类型取错误

以前用 errors.As 取具体错误，通常要先声明一个指针变量，再把它的地址传进去。Go 1.26 提供了泛型函数 errors.AsType[E]，可以直接返回匹配到的错误值和布尔结果：if pathErr, ok := errors.AsType[*fs.PathError](err); ok { ... }。它仍然会沿着 Unwrap 得到的错误树查找，所以不是只做一次类型断言。

官方资料：https://pkg.go.dev/errors

先把 errors.As 的旧写法换成泛型返回值

下面的小例子模拟读取不存在文件。os.Open 返回的通常是 *fs.PathError，外层再用 %w 增加业务语境。这里不比较错误字符串，而是按错误类型处理路径和操作名。

package main

import (
    "errors"
    "fmt"
    "io/fs"
    "os"
)

func loadConfig() error {
    _, err := os.Open("config/app.yaml")
    if err != nil {
        // %w 保留原始错误，让调用方仍能沿错误树取出 *fs.PathError。
        return fmt.Errorf("读取应用配置失败: %w", err)
    }
    return nil
}

func main() {
    if err := loadConfig(); err != nil {
        // 类型参数写真实的错误类型；文件错误是指针类型。
        if pathErr, ok := errors.AsType[*fs.PathError](err); ok {
            fmt.Printf("操作=%s 路径=%s\n", pathErr.Op, pathErr.Path)
            return
        }
        fmt.Println("其他错误:", err)
    }
}

旧写法需要 var pathErr *fs.PathError，再调用 errors.As(err, &pathErr)。新写法把“目标变量的声明”和“匹配动作”合并了，返回的 pathErr 已经是 *fs.PathError。如果把类型参数写成 fs.PathError，就会和实际的指针错误错开。

包装错误仍然匹配，关键是保留 %w

AsType 检查当前错误以及通过 Unwrap() error 或 Unwrap() []error 继续得到的子错误。也就是说，业务层可以加入上下文，但必须使用 %w；如果改成 %v，文本看起来相同，错误链却断了。

当一个错误实现了自定义 As(any) bool，它也可以定义额外的匹配规则；普通项目不需要为了使用 AsType 自己实现这套方法。先保证错误类型和包装关系清楚，排查会简单很多。

连续判断时别把原始 err 遮蔽掉

泛型返回值让变量名更顺手，也更容易在 if 初始化语句里写出遮蔽问题。下面这种结构看起来紧凑，第二个条件里的 err 已经是第一个分支产生的 *FooError，不再是原始错误：

// 错误示例：第二个 AsType 读取了被遮蔽的 err。
if err, ok := errors.AsType[*FooError](err); ok {
    handleFoo(err)
} else if err, ok := errors.AsType[*BarError](err); ok {
    handleBar(err)
}

更稳妥的做法是给输入起一个不会变化的名字，并让每个分支只声明自己的结果变量：

func handle(err error) {
    sourceErr := err
    if fooErr, ok := errors.AsType[*FooError](sourceErr); ok {
        // 每个分支只消费匹配到的具体错误，不修改 sourceErr。
        handleFoo(fooErr)
        return
    }
    if barErr, ok := errors.AsType[*BarError](sourceErr); ok {
        // 未命中 FooError 时，仍从同一棵错误树判断 BarError。
        handleBar(barErr)
        return
    }
    logUnknown(sourceErr)
}

如果项目还要支持 Go 1.25 或更早版本，不能直接编译 errors.AsType。这时继续使用 errors.As，或通过版本分支保留兼容实现，不要只改调用语法。

迁移后的四项检查清单

• 版本：构建环境至少是 Go 1.26；模块声明、CI 镜像和本地工具链要一致。
• 类型：确认目标是 *MyError 还是 MyError，和构造错误时的实际形状一致。
• 链路：跨层增加上下文用 %w，不要用 %v 伪装成可展开的包装。
• 作用域：多个类型连续判断时保留原始 error 输入，避免 err 被分支变量遮蔽。

这样改完后，errors.AsType[E] 的价值不只是少写几行：它把“我要什么错误类型”放到了调用点，减少了 target 指针层级，也让错误处理分支更容易读。

常见问题

errors.AsType 能替代所有 errors.As 吗？

不能。需要把匹配结果写入一个自定义 target，或要兼容 Go 1.25 及更早版本时，仍应使用 errors.As。

为什么 errors.AsType[*MyError] 没有匹配到？

先检查错误是否真的以指针形式实现 error，再检查中间包装是否使用了 %w。%v 会让原始错误类型无法沿链访问。

errors.AsType 找到的是哪一个错误？

它返回错误树中按先当前节点、再深度优先访问子节点顺序遇到的第一个匹配值；多错误场景要明确组合顺序。