登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Go go/scanner.ErrorList.Err 怎样把空错误列表转换为 nil

来源:17golang原创

时间:2026-11-18 15:14:39 171浏览 收藏

我第一次把 go/scanner 接进一个小型源码检查器时,最容易写错的地方不是扫描,而是函数最后该返回什么:错误集合为空时,应该返回一个空的 ErrorList,还是返回 nil?答案是直接调用 errs.Err()。官方定义已经把这个转换规则封装好了:列表为空返回 nil,列表非空返回一个与错误列表等价的 error。

官方地址:https://pkg.go.dev/go/scanner#ErrorList.Err

空列表不需要手写类型判断,也不需要把切片重新赋值为 nil;在准备把扫描结果交给上层时,使用值类型的 ErrorList.Err() 就可以得到正确的 error 返回值。
先记住三个判断
  • var errs scanner.ErrorList 是可直接使用的零值,调用 errs.Err() 会得到 nil。
  • make(scanner.ErrorList, 0) 和 scanner.ErrorList{} 即使底层切片不为 nil,长度为零时 Err() 仍返回 nil。
  • 列表里有一个或多个错误时,Err() 返回非 nil 的 error,此时不要再用列表是否为 nil 判断结果。

一、先把空列表和 nil 返回值分开

ErrorList 的底层类型是错误指针切片,零值就是一个长度为零的列表。Err() 的接收者是 ErrorList 值,而不是指针;它关心的是列表中有没有错误,不是底层切片头是否恰好为 nil。所以,下面三种写法都适合表达“当前没有扫描错误”,但真正对外返回时统一交给 Err():

package main

import (
    "fmt"
    "go/scanner"
)

func main() {
    var zero scanner.ErrorList       // 零值列表,直接可用
    empty := make(scanner.ErrorList, 0) // 空切片,长度同样是 0
    literal := scanner.ErrorList{}    // 空字面量列表

    fmt.Printf("%v %v %v\n", zero.Err(), empty.Err(), literal.Err()) // 三个结果都表示 nil
}

这里要注意语义层次:你不需要先执行 errs = nil,因为 Err() 已经把“长度为零”映射成了没有错误的 nil。这比比较底层切片更稳定,也更符合函数返回 error 的习惯。

Go ErrorList 空列表与 Err nil 返回值的静态关系框图
图1:静态结构说明图展示 ErrorList、列表长度、Err 方法和 nil error 的关系,不是截图或运行证据。

二、把扫描错误收集到一个统一出口

实际使用时,通常让 scanner.Scanner.Init 接收一个回调,把每个语法错误追加进列表;扫描结束后只写一处 return errs.Err()。这样上层函数看到的是标准 error,调用者只需要判断 err != nil,不必知道内部保存了多少条扫描错误。

package checker

import (
    "go/scanner"
    "go/token"
)

// ScanSource 收集扫描器报告的错误;没有错误时返回 nil。
func ScanSource(src []byte) error {
    var errs scanner.ErrorList             // 用零值承接多个扫描错误
    var s scanner.Scanner
    files := token.NewFileSet()
    file := files.AddFile("source.go", files.Base(), len(src))

    // 回调只负责保存位置和消息,最终的 nil 转换集中在 return 处。
    s.Init(file, src, func(pos token.Position, msg string) {
        errs.Add(pos, msg)
    }, 0)

    for {
        _, tok, _ := s.Scan()               // 继续扫描,便于收集后续错误
        if tok == token.EOF {
            break
        }
    }
    return errs.Err()                       // 空列表为 nil,非空列表为 error
}

这个小工具的关键不在于把错误列表“清空”,而在于把它作为内部聚合器使用。扫描器可能在一次输入里发现多个问题,保留它们比遇到第一条错误就返回更有帮助;但函数边界仍然可以只暴露一个 error。

Go scanner 回调、ErrorList 聚合与 error 返回边界的静态结构图
图2:静态结构说明图展示扫描回调、ErrorList 聚合和 Err 返回边界,不是截图或运行证据。

三、非空列表返回什么,怎样判断才不会绕远

当 errs 中至少有一条错误时,errs.Err() 返回非 nil 的接口值。此时应直接按普通错误处理:

func check(src []byte) error {
    err := ScanSource(src) // ScanSource 已经把 ErrorList 转成 error
    if err != nil {
        return err          // 保留扫描错误给上层处理或展示
    }
    return nil              // 成功路径明确返回 nil
}

不要写成“先判断 len(errs) == 0,再自己构造某个错误类型”的重复逻辑。官方方法已经处理了空与非空两种分支;你只需要在业务边界判断返回的 error。如果需要输出多条错误,ErrorList 本身实现了错误接口,仍可在内部保留列表,最后统一返回。

还有一个容易混淆的点:Err() 是值接收者方法。普通的 scanner.ErrorList 值可以直接调用,但不要把一个未初始化的 *scanner.ErrorList 指针当成空列表来调用方法;指针本身为 nil 时,先解引用调用值接收者可能触发 panic。若代码确实使用指针,就在调用前保证指针已指向一个列表。

小结

Go 中把空 go/scanner.ErrorList 转成 nil 的最短写法就是 errs.Err()。它按列表长度决定结果:空列表返回 nil,非空列表返回可交给上层的 error。把 ErrorList 留在扫描函数内部聚合,再在函数出口统一转换,代码更短,也不会把“底层切片是否为 nil”和“是否存在扫描错误”混为一谈。

相关问题

空切片不是 nil,为什么 Err() 仍返回 nil?

Err() 判断的是错误列表是否为空,而不是底层切片头是否为 nil;长度为零就代表没有要返回的错误。

非空 ErrorList 能直接作为 error 返回吗?

可以,但在函数出口调用 Err() 更清楚,因为它同时处理了空列表的 nil 语义,并把返回类型明确为 error。

为什么 nil 的 ErrorList 指针不能当作空列表?

空列表是一个可用的值;nil 指针没有可供值接收者读取的列表。若使用指针形式,先分配或初始化它,再调用 Err()。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>