Go CommentMap.Filter 是否会复制注释节点本身

会复制一层映射，但不会复制注释节点本身。CommentMap.Filter 返回的是一个新的 CommentMap，所以你在新 map 里删除键不会直接删除旧 map 的键；不过它把原 map 中的节点键和 []*CommentGroup 值直接放进新 map，注释组指针仍然是同一批对象。

这其实是一种很明确的浅复制策略：适合筛选一棵已有 AST 的关联注释，不适合把结果当成独立可变的注释树。

先给结论：Filter 新建 map，但不复制注释节点

官方实现的核心可以概括成三件事：先创建 umap := make(CommentMap)，再遍历传入的 AST，最后把命中的 cmap[n] 直接赋给 umap[n]。因此要分开看“容器”和“内容”：容器是新 map，节点键仍来自原 AST，值里的注释组指针也没有被克隆。

把复制边界拆成四层看

最容易混淆的是把“返回新 map”理解成“整棵注释结构都复制”。实际边界如下：

所以 Filter 更像“按 AST 节点建立一个视图”，而不是“复制一份可独立编辑的注释文档”。

为什么筛选子树时这样设计是合理的

假设工具先为整棵文件 AST 建立了注释映射，后面只处理某个函数或声明。此时筛选的目标通常是缩小查找范围，而不是复制所有注释文本。只保留属于子树的键和值，可以避免重新计算注释归属，也能让后续的 Comments() 继续按源码位置整理结果。

func commentsForDecl(cmap ast.CommentMap, decl ast.Decl) []*ast.CommentGroup {
	// Filter 只建立 decl 子树对应的映射视图，不复制注释对象。
	sub := cmap.Filter(decl)
	// Comments 会从这个视图收集并按源码位置排序。
	return sub.Comments()
}

这里的关键假设是：decl 仍然属于创建 cmap 时使用的那棵 AST。若你重新解析了同一份源码，得到的是另一组节点指针，旧 map 不会因为位置和文本相同就自动命中。

修改注释内容时，两个 map 会看到同一个对象

由于 CommentGroup 和其中的 Comment 是指针，下面这种修改会沿着共享引用生效。它不是 Filter 的 bug，而是浅复制的预期行为；如果你的程序需要保留原始注释，就不能只复制 map。

func renameFirstComment(cmap ast.CommentMap, decl ast.Decl) {
	// 新 map 与旧 map 共享命中的 *CommentGroup。
	sub := cmap.Filter(decl)
	groups := sub[decl]
	if len(groups) == 0 || len(groups[0].List) == 0 {
		// 没有关联注释时直接返回，避免访问空切片。
		return
	}

	// 这里改的是共享的 *ast.Comment，原 map 也会看到新文本。
	groups[0].List[0].Text = "// rewritten"
}

如果只想让新视图少几个键，可以直接对新 map 操作；如果要让注释文本、注释组和列表都互不影响，就需要按项目需求显式创建新的 CommentGroup、Comment 和切片，再复制位置与文本字段。

AST 替换时，Filter 与 Update 解决的是两类问题

Filter 负责筛选“哪些现有节点还在这个 AST 范围内”；Update 负责把旧节点已经关联的注释迁移到新节点。它们都不会替你深复制注释内容。

func replaceNode(cmap ast.CommentMap, old ast.Node, new ast.Node) ast.Node {
	// Update 只迁移 old 对应的注释关联，不会复制 CommentGroup。
	return cmap.Update(old, new)
}

如果新节点来自 AST 重写，正确顺序通常是先决定旧节点与新节点的对应关系，再调用 Update。之后若还要让旧 AST 和新 AST 的注释内容互不干扰，必须额外做深拷贝；不能把 Update 或 Filter 当成克隆操作。

什么时候需要真正的独立副本

可以按目的做选择：

• 只是缩小查询范围：直接使用 Filter，接受共享节点和注释对象。
• 只是替换 AST 节点但保留注释归属：用 Update 迁移关联。
• 要并行改写两套注释：复制 map、切片、CommentGroup 和 Comment，并重新确认位置对象的处理方式。
• 要输出文本而不是继续编辑 AST：可以先调用 Comments() 收集结果，再把需要的字段转换成自己的领域结构。

一句话总结：CommentMap.Filter 复制的是映射视图，不是注释节点。把它当作轻量筛选器使用，代码边界会清楚很多。

相关问题

Filter 会复制 AST 节点吗？不会。它遍历传入 AST，并把原节点作为新 map 的键。

Filter 后删除新 map 的键会影响旧 map 吗？通常不会，因为两个 map 容器不同；但删除键不会让共享的注释对象消失。

重新解析同一份源码能复用旧 CommentMap 吗？不能直接复用。重新解析会产生新的节点对象，需要重新建立映射。