Go token.File.MergeLine 怎样合并行表而不修改源码

token.File.MergeLine(line) 合并的是内存里的行偏移表，不是源码本身。它会把指定行与下一行视为同一行，实际做法类似从行表中移除下一行的起始偏移，因此原始 []byte 的内容、长度和后续字节偏移都不会被改写。

最容易记住的调用边界是：line 从 1 开始，并且必须小于当前 LineCount()。最后一行没有“下一行”可合并，传入 0、负数或最后一行都会触发 panic。下面用一个最小源码位置表，把这个行为拆开说明。

官方文档：https://pkg.go.dev/go/token#File.MergeLine

先分清源码字节和行偏移表

go/token 服务的是源码位置映射。FileSet.AddFile 注册文件名、起始位置和字节大小，File 再维护每一行首字符对应的偏移。例如源码 a\nb\nc\n 的行起点可以记为 [0, 2, 4]：第 1 行从偏移 0 开始，第 2 行从偏移 2 开始，第 3 行从偏移 4 开始。

调用 MergeLine(2) 后，表会变成 [0, 2]。这里的 4 没有从源码中删除，只是不再作为“新的一行”出现在行表里，所以原始内容依然是 a\nb\nc\n。后续位置查询会把偏移 4 附近的内容映射到合并后的第 2 行。

用 FileSet 建立一个可查询的行表

如果要在源码分析工具中维护自己的位置映射，可以先把源码长度交给 AddFile，再用 SetLinesForContent 根据内容建立行表。下面的示例只展示对象关系和预期观察点，不把行表操作误解成对文件的写入。

package main

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

func main() {
	// 源码只作为位置表的输入，后续不会被 MergeLine 改写。
	source := []byte("alpha\nbeta\ngamma\n")
	fset := token.NewFileSet()
	file := fset.AddFile("sample.go", -1, len(source))
	file.SetLinesForContent(source)

	// 先复制一份，便于在真实程序中比较源码字节是否被改动。
	original := append([]byte(nil), source...)
	before := file.Lines()
	file.MergeLine(2)
	after := file.Lines()

	// MergeLine 只调整行表；源码切片仍应与副本相同。
	fmt.Println("行表:", before, "->", after)
	fmt.Println("源码未改:", bytes.Equal(source, original))
	fmt.Println("当前行数:", file.LineCount())
}

对于这段内容，初始行表可理解为 [0, 6, 11]，合并第 2 行和第 3 行后，行表变为 [0, 6]，行数从 3 变为 2。Lines 返回的是有效行偏移表，调用方不应修改返回切片；需要编辑源码时，应在自己的字节或语法树层完成，不要把这个返回值当成编辑缓冲区。

MergeLine 实际合并了哪两行

参数表示“当前行”，方法把它与紧邻的下一行合并。例如当前有三行：

这里的“共享同一行号范围”是位置映射语义，不是把两个字符串拼接起来。官方实现通过删除下一行在内部 lines 中的条目完成操作，同时用锁保护行表。源码字节没有被替换为空格；“像把换行换成空格”只是帮助理解剩余偏移为何保持不变的比喻。

用 Pos、Offset 和 Position 读取变化

File.Pos(offset) 把文件内字节偏移转换成 token.Pos，File.Offset(pos) 再取回偏移，File.Position(pos) 则给出文件名、行号和列号。MergeLine 主要改变最后一种查询中的行号判断，不会让已经注册的文件大小或字节偏移整体移动。

// 该片段接在前一个示例的 file 和 fset 后面使用。
pos := file.Pos(11) // 偏移11仍指向原源码中的gamma起点。
position := fset.Position(pos)

// MergeLine(2)后，偏移11对应合并后的第2行，而不是新增一行。
fmt.Printf("偏移=%d 行号=%d 列号=%d\n", file.Offset(pos), position.Line, position.Column)

要注意两点：一是列号仍然根据偏移计算，二是位置是否受 //line 指令调整属于另一个位置机制。本文的 MergeLine 只讨论有效行偏移表，不把它与替代文件名、替代行列信息混在一起。

调用前先守住合法行号范围

最稳妥的保护条件是先读取 n := file.LineCount()，只有在 1 时才调用。空文件或只有一行时，根本没有可合并的相邻行。若行号来自外部输入，不要用 recover 把范围错误悄悄吞掉；应该在进入位置表操作前返回带上下文的错误。

func mergeLineIfValid(file *token.File, line int) error {
	// MergeLine要求当前行存在且后面还存在一行。
	if file == nil {
		return fmt.Errorf("文件位置表为空")
	}
	lineCount := file.LineCount()
	if line = lineCount {
		return fmt.Errorf("行号%d不可合并：有效范围为1到%d", line, lineCount-1)
	}
	// 通过范围检查后才改变内存中的行偏移表。
	file.MergeLine(line)
	return nil
}

这个包装函数并不修改源码，也没有把 panic 当作正常分支。它只是把标准库要求的 1 到 LineCount()-1 范围转成调用方可处理的错误。并发场景下还要让同一个 File 的行表生命周期由明确的所有者管理，避免检查和修改之间由其他逻辑改变对象状态。

常见问题

MergeLine 会删除源码中的换行符吗？

不会。它调整的是 token.File 的行偏移表，源码字节仍由调用方持有，文件也不会被写回。

可以对最后一行调用 MergeLine 吗？

不可以。该方法合并当前行和下一行，最后一行没有下一行；传入 0、负数或不小于当前行数的值都属于非法行号。

需要真正合并两段文本时该用什么？

使用字节切片、编辑缓冲区或语法树重写工具完成文本变更，再重新建立位置表。MergeLine 只适合维护位置映射语义，不能代替源码编辑。

因此，Go 的 token.File.MergeLine 适合“保留原始字节偏移、调整行号解释”的源码工具场景。把它看成行表元数据操作，再用合法行号范围包住调用，就能避免把位置维护误用成文本编辑。