Go scanner.ErrorList.Reset 怎样清空上一轮诊断

在批量扫描多段 Go 源文本时，scanner.ErrorList 很适合复用，但复用前必须显式调用 Reset。它清空的是错误集合本身；本轮扫描是否遇到词法错误，还要看新建或重新初始化的 scanner.Scanner.ErrorCount。把这两个状态混在一起，最容易出现“第二份输入明明正常，页面仍显示上一轮错误”的问题。

复用 ErrorList 时先划清两个状态

ErrorList 的零值就是可用的空集合，Add 会把位置和消息追加进去。调用 Reset 后，集合回到“没有诊断”的状态，之后再收到的消息才属于新一轮输入。这个动作不会改变已经存在的 scanner.Scanner，也不会替你重新建立 token.File 的位置映射。

用 Reset 配合 Init 完成两轮扫描

下面的实验故意让第一份输入包含未闭合字符串，第二份输入是正常的包声明。关键点只有一个：第二轮开始前清空同一个 ErrorList，然后为本轮输入重新准备 Scanner 和文件位置。错误处理函数只负责把诊断写入当前集合。

package main

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

func scanOnce(src []byte, list *scanner.ErrorList) int {
    list.Reset() // 复用集合前清掉上一轮的诊断

    var s scanner.Scanner
    fset := token.NewFileSet()
    file := fset.AddFile("input.go", fset.Base(), len(src)) // 为本轮输入建立位置表
    s.Init(file, src, func(pos token.Position, msg string) {
        list.Add(pos, msg) // 只收集本轮回调传来的诊断
    }, 0)

    for {
        _, tok, _ := s.Scan() // 词法扫描可能继续产出 token，同时报告错误
        if tok == token.EOF {
            break // 到 EOF 后再读取本轮统计值
        }
    }
    return s.ErrorCount // 这是 Scanner 自己记录的本轮错误次数
}

func main() {
    var list scanner.ErrorList

    firstCount := scanOnce([]byte("package demo\nvar s = \"unterminated\n"), &list)
    fmt.Printf("first: list=%d scanner=%d\n", list.Len(), firstCount)

    secondCount := scanOnce([]byte("package demo\nvar n = 1\n"), &list)
    fmt.Printf("second: list=%d scanner=%d\n", list.Len(), secondCount)
}

第一轮结束时，list.Len() 与 firstCount 都能反映错误；第二轮的 scanOnce 先执行 Reset，因此正常输入不会继承第一轮的集合内容。示例输出的具体错误文案会随 Go 版本变化，判断时应关注数量和错误位置，不要把文案当成稳定协议。

为什么 Len 和 ErrorCount 不能互相替代

ErrorList.Len() 只回答“回调已经放进集合多少条”，而 ErrorCount 回答“扫描器本轮遇到多少次错误”。如果没有安装错误处理函数，集合可能仍为空，但扫描器的计数仍然有意义；反过来，如果回调把消息过滤或分流，集合数量也不一定等于扫描器计数。

实际工程里可以把 list.Len() 用于展示待处理诊断，把 ErrorCount 用于判断扫描是否发生过错误。若两者必须一致，就让错误处理函数只做一次原样 Add，并在扫描器完成后统一读取，别在回调中悄悄丢弃消息。

常见问题

Reset 应该放在扫描结束后还是开始前

放在下一轮扫描开始前最清楚。这样上一轮结果仍可在结束处读取或展示，进入新输入时再建立明确的状态边界。

调用 Reset 后还要重新 Init 吗

Reset 只清空错误集合。只要换了输入，就应按 Scanner.Init 的要求重新准备 Scanner 和 token.File；不要把 Reset 当成扫描器重置函数。

怎样让每行只保留一条错误

那是 RemoveMultiples 的职责，不是 Reset 的职责。先完成本轮收集，再根据展示需求决定是否整理。

记住一句话：Reset 管集合生命周期，Init 管扫描输入，ErrorCount 管本轮计数。三者职责分开，批量诊断就不会把旧结果带进新任务。