Go go/scanner.ErrorList.Err 怎样把空错误列表转换为 nil
我第一次把 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 的习惯。

二、把扫描错误收集到一个统一出口
实际使用时,通常让 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。

三、非空列表返回什么,怎样判断才不会绕远
当 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()。
Java FileStore.getBlockSize 怎样查询文件系统块大小
- 上一篇
- Java FileStore.getBlockSize 怎样查询文件系统块大小
- 下一篇
- Python sys.getrecursionlimit 怎样读取解释器设置的递归深度上限
-
- Golang · Go教程 | 14分钟前 | go · Go break continue go/ast BranchStmt
- Go go/ast.BranchStmt 怎样读取 break 或 continue 的目标标签
- 157浏览 收藏
-
- Golang · Go教程 | 16分钟前 | 标准库 · go · Go 词法分析 go/token Token.IsLiteral
- Go go/token.Token.IsLiteral 怎样区分字面量记号与运算符
- 357浏览 收藏
-
- Golang · Go教程 | 42分钟前 | 标准库 · golang · Go 输出格式 go/doc 包文档 comment.Printer Package.Printer
- Go go/doc.Package.Printer 怎样定制包文档的输出格式
- 212浏览 收藏
-
- Golang · Go教程 | 1小时前 | go · Go 类型检查 go/types Package.GoVersion 语言版本
- Go go/types.Package.GoVersion 怎样读取类型检查记录的 Go 语言版本
- 176浏览 收藏
-
- Golang · Go教程 | 1小时前 | go · 泛型 · Go 泛型 类型约束 go/types TypeParam.Constraint
- Go go/types.TypeParam.Constraint 怎样取得泛型类型参数的约束类型
- 185浏览 收藏
-
- Golang · Go教程 | 1小时前 | Go教程 · Go 静态分析 ast go/types types.Info TypeAndValue IsType
- Go go/types.TypeAndValue.IsType 怎样判断表达式是否表示类型
- 235浏览 收藏
-
- Golang · Go教程 | 1小时前 | Go教程 · Go 类型检查 命名类型 go/types types.Named AddMethod
- Go go/types.Named.AddMethod 怎样向命名类型对象添加方法
- 414浏览 收藏
-
- Golang · Go教程 | 1小时前 | Go教程 · Go go/types token.Pos types.Scope Scope.LookupParent 作用域名称查找
- Go go/types.Scope.LookupParent 怎样按源码位置向父作用域查找名称
- 328浏览 收藏
-
- Golang · Go教程 | 1小时前 | Go教程 · Go 词法作用域 go/types types.Info Scope.Child
- Go go/types.Scope.Child 怎样访问指定的子作用域
- 332浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1095次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1092次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1256次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1197次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1046次使用
-
- Go map 并发写 panic 怎么办:从共享 map 到可控写入路径
- 2026-06-30 123浏览
-
- Go代码规范错误处理示例经验总结
- 2022-12-23 278浏览
-
- go语言中的defer关键字
- 2023-02-17 150浏览
-
- Golang中Interface接口的三个特性
- 2023-01-07 394浏览
-
- go语言中函数与方法介绍
- 2023-01-07 297浏览

