TreeView 是唯一正路，必须实现 getChildren 和 getTreeItem 方法；createTreeView 接收的是 TreeDataProvider 而非数据数组；TreeItem 必须设 id、command（arguments 为数组）、collapsibleState，contextValue 需与 package.json 中 menus 的 when 条件严格匹配。
直接说结论：VSCode 插件里想自定义显示目录树，TreeView 是唯一正路，但必须配 TreeDataProvider，漏掉 getChildren 或 getTreeItem 中任意一个，视图就空白或报错 TypeError: treeDataProvider.getChildren is not a function。
为什么 createTreeView 传个数组就报错？
vscode.window.createTreeView 接收的不是数据本身，而是一个提供数据的“供应商”对象。它不关心你数据在哪、怎么来，只认两个方法：
-
getChildren(element?)：返回Promise<TreeItem[]>，根节点调用时element是undefined；子节点则传入上一级的element -
getTreeItem(element)：必须返回vscode.TreeItem实例（不能是 plain object），且至少设label和collapsibleState
常见错误是传了个静态数组进去，或者返回了 { label: 'xxx' } 这样的字面量对象——VSCode 会直接拒绝渲染。
TreeItem 点击没反应？检查这三处
点击节点无动作，90% 是因为 TreeItem 缺关键字段：
- 没设
id：折叠状态无法记忆，右键菜单 contextValue 错位，command参数也拿不到正确上下文 - 没设
command：即使你在package.json里注册了registerCommand('myExtension.open')，不绑定到具体节点也白搭 -
arguments不是数组：哪怕只传一个参数，也得写成[element.id]，写成element.id会静默失败
示例写法：
getTreeItem(element: MyNode): vscode.TreeItem {
const item = new vscode.TreeItem(element.label);
item.id = element.id;
item.command = {
command: 'myExtension.openDetail',
title: 'Open detail',
arguments: [element.id]
};
return item;
}
右键菜单不出现？package.json 漏配 menus
command 控制左键点击，右键菜单是另一套机制。光在 getTreeItem 里设 contextValue 不够，还必须在 package.json 的 contributes.menus 下声明：
"contributes": {
"menus": {
"view/item": [
{
"command": "myExtension.rename",
"when": "view == myTreeViewId && viewItem == myNodeContext"
}
]
}
}
注意：when 条件里的 viewItem 值，必须和你在 getTreeItem 中设置的 contextValue 字符串完全一致，大小写敏感，拼错一个字母就失效。
动态加载子节点，“小箭头”不显示？collapsibleState 设错
如果节点该有展开箭头却没显示，大概率是 collapsibleState 没设对：
-
vscode.TreeItemCollapsibleState.None：永远不可展开（比如叶子文件） -
vscode.TreeItemCollapsibleState.Collapsed：可展开，初始收起（比如文件夹，但子项尚未加载） -
vscode.TreeItemCollapsibleState.Expanded：可展开，初始展开（慎用，可能触发大量异步加载）
特别注意：如果你的节点理论上能展开（比如代表一个目录），但 getChildren 返回空数组或 null，也请设为 Collapsed，否则 VSCode 认为它就是个终端节点，不会画箭头。
