为什么用嵌套结构时 interface{} 不是好选择
Go 里想表达“任意子节点”时，很多人第一反应是塞 interface{}，结果很快遇到类型断言失败、无法遍历、序列化丢失字段等问题。根本原因是 interface{} 抹掉了具体类型信息，而组合模式依赖的是统一行为接口，不是任意值容器。
真正需要的是一个明确定义的节点接口，比如：
type Node interface {
Name() string
Children() []Node
IsLeaf() bool
}
- 所有树节点（文件、目录、配置项）都实现这个接口，而不是靠运行时猜类型
-
Children()返回[]Node，天然支持递归遍历，编译期就能检查一致性 - JSON 序列化时不会丢字段——只要每个具体类型实现了
json.Marshaler，就可控制输出 - 避免在遍历时写一堆
if v, ok := n.(DirNode); ok { ... }这类脆弱分支
如何让叶子节点和容器节点共用同一接口而不冗余
常见错误是给叶子节点也硬塞一个空的 Children() 方法，或者返回 nil 切片但调用方还得判空。这不是语义问题，是设计信号混乱：叶子节点本就不该有子节点。
正确做法是用方法返回值明确表达意图：
立即学习“go语言免费学习笔记（深入）”；
func (f FileNode) Children() []Node { return nil } // 明确无子节点
func (d DirNode) Children() []Node { return d.children }
- 返回
nil切片比返回空切片[]Node{}更轻量，且for range nil安全，不 panic - 调用方统一用
for _, child := range node.Children() { ... }，无需额外判空 - 如果业务需要区分“暂无子节点”和“不可拥有子节点”，那就加个
CanHaveChildren() bool方法，而不是靠返回值猜
递归遍历树时怎么避免栈溢出或无限循环
Go 默认栈大小约 2MB，深度超过几千层的树容易爆栈；更隐蔽的是环形引用（比如 A 的子节点包含 B，B 又引用回 A），会导致无限递归。
- 不要裸写递归函数，加深度限制参数：
func Walk(n Node, depth int, maxDepth int)，到depth >= maxDepth就提前返回 - 检测环形引用必须维护已访问节点标识，推荐用
map[uintptr]bool存对象地址（uintptr(unsafe.Pointer(&n))），比用reflect.ValueOf(n).Pointer()稍快且不依赖反射 - 对超深树，改用显式栈（
[]Node切片模拟）做 DFS，或用 channel + goroutine 做 BFS，把调用栈压力转为堆内存 - 注意：
fmt.Printf("%v", tree)这类调试操作也会触发递归，可能悄无声息地卡死或 panic
JSON 序列化嵌套结构时字段丢失或嵌套错乱
直接 json.Marshal(tree) 经常得到空对象或只有一层字段，因为 Go 的 JSON 包默认只序列化导出字段（首字母大写），且对嵌套接口处理生硬。
- 确保所有要输出的字段都是导出的，比如
Name string而不是name string - 如果节点类型混用（
FileNode和DirNode），别指望json.Marshal([]Node{...})自动识别具体类型——它只会按接口的底层结构序列化，大概率是空对象。必须显式转换：json.Marshal([]any{f, d})或为每种类型写定制MarshalJSON() - 避免在
MarshalJSON()里调用json.Marshal(n)造成无限递归，应手动构造map[string]any再序列化 - 测试时用
json.Compact()输出，比原始格式更容易看出嵌套是否符合预期
