Go语言技术文章
-
Go token.FileSet 的 Read 与 Write 保存的是文件区间、行偏移和行指令等位置元数据，不是源文件内容。本文用 gob 回调展示如何保存并恢复映射，并说明为什么恢复时应使用新的 FileSet。430 收藏 -
Go 1.20 起可以用 FileSet.RemoveFile 移除不再使用的文件，降低长驻源码分析工具持续积累的文件位置表内存。本文说明位置引用、AST、诊断文本与 FileSet.Base 的迁移边界。393 收藏 -
token.NoPos表示缺失源码位置，不能拿它代替文件起点。本文用三类输入说明有效性判断、文件集归属和诊断展示，避免未知位置被补成第一行。181 收藏 -
解释 Go token.FileSet.AddFile 的 base、size 与 Pos 区间关系，说明旧 base 为什么不能复用，并给出连续加入源码文件的安全写法。179 收藏 -
Go token.FileSet.Iterate 会按文件基址升序遍历多个源码文件。本文说明 AddFile 注册的基址、大小和末端范围，并给出导出 FileRange 报告的实用写法，避免把全局 Pos 误当成文件内字节偏移。462 收藏 -
Go token.File.SetLines 返回 false，通常是因为行偏移没有严格递增，或某个偏移已经达到文件大小。本文从换行边界、空文件和自定义行表三个角度说明如何构造有效数据。127 收藏 -
Go代码生成器可用AddLineColumnInfo登记来源位置锚点。本文说明字节偏移、行列延续、登记顺序，以及诊断展示和源码访问的不同用途。487 收藏 -
Go token.File 的 Position.Column 不是中文字符数量，而是基于 UTF-8 字节偏移计算的行内列号。本文用 Pos、Offset、Position 和中文标识符示例说明如何正确换算，并处理 //line 位置调整。413 收藏 -
Go token.File.Pos 接收文件内字节偏移并返回 token.Pos；再交给 FileSet.Position，就能得到文件名、行号和列号。本文说明 Base、Size、Offset 与越界钳制，给出源码分析工具中的完整写法。105 收藏 -
Go 源码分析工具处理内存 []byte 时，需要先为 token.File 注册同样的文件大小，再用 SetLinesForContent 建立行首字节偏移表。本文说明 Position、Lines、换行、UTF-8、//line 注释与 SetLines 的边界。368 收藏 -
go/ast.ImportSpec 只能告诉你导入声明长什么样，不能单独证明包名是否被引用。本文用 go/types 的 Defs、Uses、Implicits 连接语法节点与语义对象，说明普通、别名、空白和点导入的判断边界。199 收藏 -
Go token.File.PositionFor 的 adjusted 控制是否采用替代位置信息，可能改变文件名和行列，但不改变原始偏移。本文用同一 Pos 对照示例，解释诊断显示、源码编辑与回退策略。293 收藏 -
Go 用 go/ast 修改 ImportSpec 时，直接改 Path 或 Name 通常不会丢掉 Comment；真正需要谨慎的是解析时是否保留注释，以及移动、删除节点后 File.Comments 与位置关系是否仍然一致。本文给出一套可复用的修改和输出流程。180 收藏 -
从 ast.ImportSpec.Name 和 Path 入手，拆解 Go 点导入、空白导入与默认导入在语法树中的表示和编译期语义，并给出安全分类与改写代码。342 收藏 -
Go AST 中 ImportSpec.Name 为 nil 通常不是解析失败，而是源码没有显式本地包名。本文拆解普通导入、别名导入、点导入和空白导入的差异，说明为什么不能把导入路径末段直接当成真实包名，并给出安全的 AST 读取与 go/types 语义层选择方法。323 收藏