Go debug/dwarf LineReader 为什么可能返回 nil

debug/dwarf.Data.LineReader 返回的 error 为 nil，并不保证 reader 非 nil。官方接口明确允许编译单元没有行表时返回 (nil, nil)。调用方应先处理错误，再判断 reader，最后才调用 Next。

官方文档：https://pkg.go.dev/debug/dwarf。以下围绕既有接口说明，不是新版本发布消息；示例未在本文环境运行。

先区分错误与没有行表

读取器为空有两类需要分开的情况：err非空表示本次创建失败；reader与err都为空，表示该编译单元没有可读行表。把后者当作成功创建对象，就可能在后面的Next处遇到空指针问题。

当前官方源码中，未提供line区段，以及编译单元的AttrStmtList无法取得int64形式的偏移，都会进入无行表返回；偏移越界或行表头解析失败则属于错误路径。源码细节用于解释现象，业务逻辑优先依赖公开接口契约。

从编译单元入口调用

LineReader要求传入TagCompileUnit条目，而且条目应来自同一份Data。不要把函数条目、空条目或另一份文件的Entry传进去，再把结果解释成目标文件没有行表。

package linescan

import (
    "debug/dwarf"
    "fmt"
    "io"
)

// ReadUnit统计一个编译单元中的非结束标记行；hasTable单独表达是否存在行表。
func ReadUnit(d *dwarf.Data, cu *dwarf.Entry) (rows int, hasTable bool, err error) {
    if d == nil || cu == nil || cu.Tag != dwarf.TagCompileUnit {
        return 0, false, fmt.Errorf("需要同一Data中的有效编译单元")
    }
    lr, err := d.LineReader(cu)
    if err != nil {
        return 0, false, fmt.Errorf("编译单元%#x创建行读取器: %w", cu.Offset, err)
    }
    if lr == nil {
        return 0, false, nil // 无行表是独立状态，不调用Next
    }
    for {
        var row dwarf.LineEntry
        err := lr.Next(&row)
        if err == io.EOF {
            return rows, true, nil // 正常结束与无行表不同
        }
        if err != nil {
            return rows, true, fmt.Errorf("编译单元%#x读取行表: %w", cu.Offset, err)
        }
        if row.EndSequence {
            continue // 结束标记不作为普通源码行统计
        }
        rows++
    }
}

标签检查只能排除明显输入错误，不能证明条目确实来自d；这个约束应由上层读取流程保证。此函数接收已经取得的DWARF数据，不负责打开文件，也没有需要由它关闭的文件句柄。

读取行记录时单独处理结束

有LineReader之后，Next仍可能遇到错误；不要只检查创建时的err。正常耗尽由io.EOF表示，与LineReader返回(nil, nil)是不同阶段的状态。上面的hasTable即使在零条普通行时也能保留“存在行表”的信息。

EndSequence表示指令序列结束边界，不应被直接当作普通源文件行。示例只做计数，不声称计数等于源文件物理行数，也不尝试建立完整地址索引。

按缺失范围决定后续动作

对多编译单元文件，某一单元没有行表，不足以证明全部单元都缺失。工具可以按单元报告偏移及缺失情况，继续处理其他有效单元；若业务必须有源码位置，再向调用者返回明确的不可映射状态。

同样，拿到行表不保证每个地址都有源码位置。不要通过伪造文件名或行号补空值，也不要把“没有行表”一律标成文件损坏。需要进一步定位时，先确认实际输入文件、DWARF数据装载情况与所选编译单元，再调查产物生成方式。

可以只判断err吗？

不可以，(nil, nil)是公开允许的组合，应在调用Next前判断reader。

reader为空就跳过整个文件吗？

通常不必。按工具目标决定是否跳过该单元，其他单元可能仍可读取。

rows为0是不是也表示没有行表？

不是。示例用hasTable区分不存在行表与存在行表但没有计入普通行的情况。

参考：Go接口文档、Go官方行表实现。