Go token.NoPos 怎样避免被误显示为源码第一行

token.NoPos 表示没有源码位置。避免它被显示为第一行，关键是在换算字节偏移或填充默认行号之前判断 p.IsValid()，并让展示层保留“位置未知”。真正的文件首字节应该来自 file.Pos(0)，不能用 NoPos 代替。

一个典型症状是诊断列表里许多无法定位的问题都显示 sample.go:1:1。这通常需要检查工具自己的默认值和位置换算。本例用有限输入比较定位语义，不报告未经测量的性能收益。

用三种输入区分缺失位置和文件起点

先准备三类诊断输入：缺失位置、属于文件的首字节位置、非零但不属于当前文件集的位置。它们分别应显示未知、真实坐标、文件集归属缺失。前两类尤其容易混淆：文件内字节偏移可以是0，而紧凑位置值的0是专门保留的 NoPos。

说明图将紧凑位置值与文件内偏移分开，连线表示所属关系，不表示执行流程。

先判断位置再决定是否访问源文件

把判断放在公共的诊断格式化函数中，调用者就不必各自拼接文件名和行号。先保留缺失状态，再确认非零位置属于当前文件集，最后取得显示坐标。

package main

import (
    "fmt"
    "go/token"
)

// location 不把缺失位置替换成文件开头。
func location(fset *token.FileSet, p token.Pos) string {
    if !p.IsValid() {
        return "位置未知"
    }
    if fset == nil || fset.File(p) == nil {
        return "位置不属于当前文件集"
    }
    pos := fset.PositionFor(p, false)
    if !pos.IsValid() {
        return "位置未知"
    }
    return pos.String()
}

func main() {
    // 空位置和真正的首字节位置必须保持可区分。
    fset := token.NewFileSet()
    file := fset.AddFile("sample.go", -1, 3)
    file.SetLinesForContent([]byte("abc"))
    fmt.Println(location(fset, token.NoPos))
    fmt.Println(location(fset, file.Pos(0)))
    fmt.Println(location(fset, token.Pos(file.End()+1)))
}

这是独立使用示例，本文未执行。按输入语义推导，第一条保持未知，第二条是 sample.go 的第一行第一列，第三条不会被拼成 sample.go 的坐标。这三项是读者可以在自己的项目中比较的预期分类。

Pos.IsValid 只负责区分 NoPos 与非零值；非零值不能证明属于某个指定 FileSet。因此，跨解析任务传递位置时，还要带上对应文件集或明确的来源标识。

让展示层保留未知状态

容易出问题的适配代码会先取文件偏移，再用“行号至少为1”的规则补齐显示。对文件位置取偏移时，NoPos 可能落入文件起点的偏移语义；如果随后调用 file.Pos(offset)，缺失信息就被换成了真实起点。此时再判断换算结果已经太晚。

另一种错误来自接口协议：把缺失的 line 初始化为0，再统一加1交给使用零基行号的编辑器。需要加1的是已知坐标的基数转换，缺失字段不能参与这个计算。面向编辑器输出时，可以省略 range 或使用业务协议约定的缺失标记；具体采用哪种形式由接收端协议决定。

结构图中的“缺失标记”属于诊断数据本身，不应由文件名或默认行号覆盖。

比较修正前后的定位语义

修正目标是减少错误归因，而不是让所有诊断都带上一个看似完整的坐标。可以使用上面的三类固定输入比较格式化前后：缺失输入不生成第一行坐标，首字节输入仍然能定位，异文件集输入不被误解。这里比较的是行为，没有压测数据，也不据此宣称吞吐量或内存变化。

针对已有系统，可以先定位统一格式化出口及偏移转换入口，再检查是否有把0当默认值的字段。日志可以同时记录位置是否存在和来源标识，避免只保存一个已经拼好的字符串。用户点击诊断时，只有明确位置才提供跳转。

选择物理坐标还是替代坐标是另外一个决定。本例使用 PositionFor(p, false) 解释文件集中的物理位置；若要尊重生成代码的来源映射，可以改用 true，但缺失位置的分支仍然必须保留。

常见问题

直接把 NoPos 交给 FileSet.Position 可以吗？

可以得到无效的 Position。问题通常出在之后用默认文件名和行号把无效结果补成了有效位置。应检查有效性，并保留未知含义。

FileSet.File 返回 nil 一定说明原始 AST 没有位置吗？

不一定。也可能使用了另一个解析任务的文件集，或文件已经被移除。不要仅凭 nil 给节点填入当前文件首行。

拿到一个非零 Pos 就能跨进程传给其他工具吗？

不能只凭整数假设对方能解释。紧凑位置需要对应文件集的上下文。跨进程协议更适合显式携带来源与坐标，并单独表达位置是否存在。

官方参考：https://pkg.go.dev/go/token#NoPos；源码说明：https://go.dev/src/go/token/position.go。