本文介绍使用 golang.org/x/tools/go/ast/astutil 包中的 cursor.delete() 方法，安全、结构化地从 go 抽象语法树（ast）中删除指定类型节点（如表达式语句），并说明其原理、用法及关键注意事项。
本文介绍使用 golang.org/x/tools/go/ast/astutil 包中的 cursor.delete() 方法，安全、结构化地从 go 抽象语法树（ast）中删除指定类型节点（如表达式语句），并说明其原理、用法及关键注意事项。
在 Go 的 AST 操作中，不能直接通过 ast.Inspect 删除或修改节点——因为 Inspect 是只读遍历器，其回调函数返回 bool 仅用于控制是否继续向下遍历，对 AST 结构无任何副作用。尝试在 Inspect 中赋值（如 x.X = nil）不仅无效，还可能破坏 AST 的完整性，导致后续 ast.Print 或 go/format 失败。
正确的方式是使用 astutil.Cursor ——它提供了一种带上下文感知的、可变的 AST 遍历机制，支持安全插入、替换与删除节点。核心流程如下：
- 构建 astutil.Cursor 并遍历：astutil.Apply 或 astutil.Cursor 配合 Walk 可获取当前节点在父节点中的位置信息；
- 定位目标节点：在 Cursor 的 Enter 或 Leave 回调中判断节点类型（如 *ast.ExprStmt）；
- 调用 c.Delete()：该方法会自动将其从父节点的子节点切片中移除，并保持 AST 结构合法（例如，若父节点是 *ast.BlockStmt，则从 List 中删去该 ExprStmt）。
✅ 示例：删除源文件中所有 *ast.ExprStmt（如 x++、fmt.Println() 等无结果表达式语句）
import (
"go/ast"
"go/parser"
"go/token"
"golang.org/x/tools/go/ast/astutil"
)
func deleteAllExprStmts(srcFile string) (*ast.File, error) {
fset := token.NewFileSet()
file, err := parser.ParseFile(fset, srcFile, nil, parser.ParseComments)
if err != nil {
return nil, err
}
// 使用 astutil.Apply 进行可变遍历
astutil.Apply(file, func(c *astutil.Cursor) bool {
// 检查当前节点是否为 *ast.ExprStmt
if exprStmt, ok := c.Node().(*ast.ExprStmt); ok {
// 安全删除：Cursor 自动处理父节点的切片更新
c.Delete()
return false // 删除后无需再遍历其子树
}
return true
}, nil)
return file, nil
}⚠️ 关键注意事项：
- c.Delete() 仅适用于可被父节点“拥有”的节点（如 Stmt 在 BlockStmt.List、Expr 在 CallExpr.Args 中）。对顶层 *ast.File 或孤立节点调用会 panic；
- 删除后务必确保语义合法性：例如删除 return 后的 ExprStmt 可能导致控制流异常，建议结合 ast.Walk 先做语义分析；
- astutil 属于 golang.org/x/tools，需单独安装：
go get golang.org/x/tools/go/ast/astutil
- 替换而非删除？可用 c.Replace(newNode)，例如替换为 &ast.EmptyStmt{} 实现“空占位”，但注意 EmptyStmt（分号）在某些上下文中不被允许（如函数体末尾）。
? 提示：调试时可用 ast.Print(fset, file) 输出修改后的 AST，验证节点是否真正消失；配合 go/format.Node 可生成格式化后的 Go 源码字符串，用于落地变更。
总之，astutil.Cursor.Delete() 是 Go 生态中操作 AST 结构变更的标准、可靠且推荐的方式，避免了手动维护父节点切片的繁琐与风险，是编写代码生成器、重构工具或静态分析器不可或缺的基础能力。
