TreeView侧边栏不显示的根本原因是TreeDataProvider未正确注册或实现：getChildren必须返回Promise/数组，getTreeItem必须返回TreeItem实例且含label；需在activate中调用createTreeView并配置package.json的views节点。
TreeView 侧边栏插件不是靠“加个面板”就能跑起来的——它必须注册 TreeDataProvider，且响应 vscode.window.createTreeView 的调用时机，否则侧边栏空白、右键无菜单、双击无反应都是常态。
为什么 TreeView 不显示，连图标都不出来？
常见现象：插件激活了，但侧边栏区域空着，或者只显示“…”加载态，控制台无报错。根本原因是 TreeDataProvider 实例没被正确传入 createTreeView，或提供者未实现必需方法。
-
getChildren必须返回Promise或同步数组；返回undefined或null会导致整个树挂起 -
getTreeItem必须返回vscode.TreeItem实例（不能是 plain object）；漏写label字段会显示为空白项 - 注册时未在
activate中调用vscode.window.createTreeView('myViewId', { treeDataProvider })，仅声明 provider 不生效 -
package.json里漏配"views"节点，或viewId拼写与代码中不一致（大小写敏感）
如何让右键菜单和双击事件真正起作用？
TreeView 自身不处理交互，所有动作都要靠 package.json 中的 menus 配置 + 命令注册联动。缺一不可。
- 右键菜单需在
package.json的"menus": { "view/item": [...] }下配置，when条件要匹配viewId和viewItem类型（例如viewItem == myFileNode） - 双击触发命令，必须给
TreeItem设置command属性：treeItem.command = { command: 'my.extension.open', title: '', arguments: [node] }; - 命令必须提前用
vscode.commands.registerCommand注册，且参数能被正确序列化（避免传入 class 实例或函数） - 如果右键菜单灰色不可点，检查
when表达式是否写错，或对应命令未注册（控制台会报command 'xxx' not found）
刷新树节点时为什么卡顿或状态丢失？
频繁调用 refresh 或直接 mutate TreeItem 属性，会导致 VS Code 渲染层异常或复用旧 DOM 节点。
- 不要在
getTreeItem中返回缓存的TreeItem实例（除非你完全掌控生命周期）；每次调用应返回新实例，或确保id稳定且collapsibleState正确 - 触发刷新请用
treeDataProvider.refresh()（假设你暴露了该方法），而不是反复调用createTreeView - 异步加载子节点时，
getChildren返回 Promise 后，若用户快速折叠再展开，旧 Promise 的 resolve 可能覆盖新状态；建议加简单 cancel 逻辑（如用AbortSignal或标记当前请求 ID） - 大量节点（>500）建议启用懒加载：父节点设为
CollapsibleState.Collapsed，仅在展开时才请求子项
最常被忽略的一点：VS Code 不会自动监听文件系统或外部数据变化——refresh 必须由插件主动触发，无论是定时轮询、FSWatcher 回调，还是用户操作后手动调用。没人调 refresh()，树就永远静止。
