直接递归BuildTree易栈溢出，因.NET默认栈约1MB，50+层深度即超限；应改用Dictionary预分组+Stack迭代建树，避免递归调用和全表扫描。
为什么直接递归 BuildTree 容易栈溢出
当扁平 List<TreeNode> 节点数超 1000，且层级深（比如 50+），纯递归构建树会触发 StackOverflowException。这不是数据量大，而是调用栈深度超标——.NET 默认线程栈约 1MB，每层递归压入帧，很快耗尽。
实操建议：
- 改用显式栈（
Stack<TreeNode>）或队列（Queue<TreeNode>）模拟递归，控制内存分配位置 - 优先用
Dictionary<int, List<TreeNode>>预分组子节点，避免每次Where(x => x.ParentId == id)全表扫描 - 若原始数据无序，先按
ParentId排序再处理，能提升缓存局部性
如何用 Dictionary + 迭代一次完成建树
核心是把“找子节点”从 O(n) 降到 O(1)。假设每个 TreeNode 有 Id、ParentId、Name 三个字段：
var nodeDict = nodes.ToDictionary(n => n.Id);
var childrenMap = nodes
.Where(n => n.ParentId != null) // 或 != 0，依业务定根标识
.GroupBy(n => n.ParentId.Value)
.ToDictionary(g => g.Key, g => g.ToList());
var roots = nodes.Where(n => n.ParentId == null).ToList();
foreach (var root in roots) {
BuildChildrenIteratively(root, childrenMap, nodeDict);
}
注意：BuildChildrenIteratively 是一个 while 循环体，用 Stack<TreeNode> 存待处理节点，每次 pop 后查 childrenMap 获取子集并 push 进栈 —— 没有函数调用，无栈风险。
ParentId 为 0 或 null 时怎么统一处理
实际数据里，根节点的父标识五花八门：0、-1、null、空字符串、甚至 "ROOT"。硬编码判断会导致后续迁移脆弱。
实操建议：
- 定义常量
const int ROOT_PARENT_ID = 0;或static readonly object ROOT_MARKER = new(); - 建树前统一 Normalize：遍历一次，将所有非法父值转为统一哨兵值，比如
node.ParentId = node.ParentId == 0 ? null : node.ParentId; - 如果用 EF Core，可在
OnModelCreating中加HasIndex在ParentId上，加速分组查询
JSON 序列化时出现循环引用怎么办
建完树后，若直接用 System.Text.Json 序列化，可能报错 System.Text.Json.JsonException: A possible object cycle was detected —— 因为父子双向引用（Parent 属性反指）。
最轻量解法：
- 移除
Parent字段，只保留单向Children，前端靠路径定位父级 - 若必须双向，序列化时用
JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles; - 不推荐
[JsonIgnore]标记Parent，因为调试时看不到上下文关系
真正容易被忽略的是：建树后没清空原始 List 的引用，导致 GC 无法回收，内存悄悄涨。尤其在 ASP.NET Core 中长期存活的 Service 里，记得用完就置 nodes = null; 或用 Array.Empty<TreeNode>() 替代空集合。
