根本原因是节点添加后未展开或显示设置不当、Nodes未清空、文本为空、Tag使用错误、遍历不递归、删除未清理资源。需检查ExpandAll、ShowLines、Text、Tag类型转换与线程安全、手动递归遍历、主动释放Tag资源。
TreeView.Nodes.Add() 添加节点但不显示？
根本原因通常是没调用 TreeView.ExpandAll() 或没设置 TreeView.ShowRootLines/ShowLines 导致视觉上“看不见”。更常见的是在绑定前忘了清空 TreeView.Nodes，旧节点残留干扰层级。
- 添加后立刻调用
treeView1.ExpandAll()看是否真没加进去 - 确认
treeView1.Nodes.Count是否递增，排除 UI 刷新假象 - 避免在循环里反复调用
ExpandAll()——性能差，改用node.Expand()展开父节点即可 - 如果节点文本为空（
new TreeNode("")），WinForms 默认不渲染，务必检查Text属性非空
TreeNode.Tag 存数据却取不到？
Tag 是唯一推荐的节点附带数据方式，但容易踩两个坑：一是类型强转失败，二是跨线程访问引发异常。它不是用来存大对象或复杂业务模型的，而是轻量标识（如 ID、状态码）。
- 存的时候用明确类型：
node.Tag = (long)record.Id;，别直接存object后再猜 - 取之前先判空：
if (node.Tag is long id) { ... }，避免InvalidCastException - 别在后台线程里读写
Tag——TreeView是 UI 控件，必须通过Invoke()同步 - 不要把整个
DataTable或List塞进Tag，内存泄漏风险高
遍历所有节点时漏掉子节点？
TreeView.Nodes 只返回根级节点，递归必须手动写。用 TreeNode.Nodes 才能拿到子集合，但很多人误以为 TreeView.Nodes[0].Nodes 就是全部子孙——其实只是一级子节点。
- 正确递归方式：
private void Traverse(TreeNode node) { /* 处理 node */ foreach (TreeNode child in node.Nodes) Traverse(child); } - 想一次性获取全部节点（含嵌套），用 LINQ 不直观也不推荐；老实用递归或栈模拟
- 避免在遍历时修改
Nodes集合（如边遍历边Remove()），会抛InvalidOperationException；先收集待删节点，再统一删 - 如果树很深（>1000 层），递归可能爆栈，改用迭代+
Stack
删除节点后数据还在内存里？
TreeNode.Remove() 或 Nodes.RemoveAt() 只是从控件树中移除引用，Tag 指向的对象不会自动释放。尤其当 Tag 是事件处理器、数据库连接或大数组时，容易造成隐性内存泄漏。
- 删除前主动清理：
if (node.Tag is IDisposable disposable) disposable.Dispose(); - 若
Tag是自定义类，确保它实现IDisposable并在Remove()后调用 - 别依赖 GC 回收——
TreeNode被移除后仍可能被其他变量引用（比如你存了List） - 调试时观察
node.Parent是否为null，这是判断是否真正脱离树的可靠依据
事情说清了就结束。TreeView 的坑不在 API 多难，而在“看似删了/加了/遍历了”，实际只是 UI 表面动作，底层数据和引用关系没同步到位。
