当前位置:首页 > 文章列表 > Golang > Go教程 > Go go/scanner.ErrorList.Err 怎样把空错误列表转换为 nil

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

来源:17golang原创 2026-11-18 15:14:39 0浏览 收藏

我第一次把 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删除
Java FileStore.getBlockSize 怎样查询文件系统块大小Java FileStore.getBlockSize 怎样查询文件系统块大小
上一篇
Java FileStore.getBlockSize 怎样查询文件系统块大小
Python sys.getrecursionlimit 怎样读取解释器设置的递归深度上限
下一篇
Python sys.getrecursionlimit 怎样读取解释器设置的递归深度上限
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1095次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1092次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1256次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1197次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1046次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码