Go go/token 怎样把文件位置对象格式化成字符串

在做 Go 语法树、扫描器或静态分析工具时，*token.File 经常同时承担两类信息：它代表哪个源文件，以及这个文件在 FileSet 中占用了哪一段 token.Pos 坐标。想把这个对象直接打印成字符串，调用 file.String() 就够了；但它输出的是文件身份和位置范围，不是某一行源码位置。

先把 File.String 看成“文件范围标签”

Go 官方实现把 File.String 定义为 fmt.Sprintf("%s(%d-%d)", f.Name(), f.Base(), f.End())。因此，文件名来自 Name，左边的数字来自 Base，右边的数字来自 End。例如文件以 base 为 100、size 为 128 加入文件集时，字符串会是 parser/demo.go(100-228)。

这里的数字是 FileSet 的坐标范围。它的价值在于日志里能一眼看出“这是哪个文件、占了哪段 Pos”，不适合直接当作用户错误提示里的行号。把它理解成对象的调试身份标签，后面的排查会简单很多。

用 FileSet 建立可复现的 Pos 区间

实际代码中不要手拼字符串，先让 FileSet.AddFile 注册文件，再由 String 读取统一状态。这样多个源文件加入同一个集合时，每个文件的 Pos 范围仍然可比较，日志也不会混入手工计算的边界。

package main

import (
    "fmt"
    "go/token"
)

func main() {
    fset := token.NewFileSet()
    // base 是该文件在 FileSet 中的起点，size 使用源文件字节数。
    file := fset.AddFile("parser/demo.go", 100, 128)

    // String 只描述文件名和 Pos 范围，不代表源码的行列号。
    fmt.Println(file.String()) // parser/demo.go(100-228)
    fmt.Println(file.Base(), file.Size(), file.End())
}

这个输出也能帮助检查一个常见错误：End 不是“最后一个有效字节的下标”，而是 base + size 这个结束位置。源码偏移使用 0 到 size 的边界语义时，直接用 String 比较范围即可；不要把右端点再减一后写回坐标系统。

需要行列号时，把 Pos 转成 Position

如果日志要显示用户能定位的 文件:行:列，应先用文件内偏移创建 Pos，再转换为 Position。File.String 与这一步不是替代关系：前者回答“文件范围是什么”，后者回答“某个位置落在哪里”。

package main

import (
    "fmt"
    "go/token"
)

func main() {
    fset := token.NewFileSet()
    // 先登记每一行的起始偏移，Position 才能给出准确行列。
    file := fset.AddFile("parser/demo.go", 100, 40)
    file.AddLine(12)
    file.AddLine(27)

    // offset 是文件内字节偏移；Pos 再交给 FileSet 统一转换。
    pos := file.Pos(15)
    fmt.Println(file.String())       // parser/demo.go(100-140)
    fmt.Println(fset.Position(pos))  // parser/demo.go:2:4（示意）
}

AddLine 的偏移必须递增且小于文件大小。扫描器或解析器通常会替你维护行表；如果只是构造调试样例，缺少行表时不要把 String 的范围输出误认为已经完成了行列映射。

把它放进调试日志时的判断清单

跨文件比较时，必须使用同一个 FileSet 的坐标语境；只拿两个 File.String 的数字做业务判断，容易把不同集合里的 Base 当成可比较值。对越界 offset，File.Pos 会按文件起止位置修正，日志里最好同时保留原始 offset，避免把“被修正后的合法 Pos”误判成输入本身有效。

常见问题

File.String 会返回完整的 file:line:column 吗？

不会。它返回的是文件名和 Pos 区间；要显示行列，使用 Position 或 PositionFor。

为什么 End 看起来比文件最后一个字节大一位？

因为 End 表示文件范围的结束位置，定义为 base + size，它是边界而不是最后一个字节的编号。

只知道 token.Pos 时还需要 File.String 吗？

如果要定位源代码，优先让 FileSet.Position(pos) 返回行列；如果要诊断 FileSet 的分段分配，再把所属 File 的 String 一起写入日志。

记住一个简单的分工：File.String 负责说明文件对象的坐标范围，Position 负责解释具体源码位置。把两者分开使用，语法树工具的日志既短又不容易误导。