createTreeView报错因需传入实现TreeDataProvider接口的对象而非数组；必须提供getChildren（返回Promise）和getTreeItem（返回TreeItem实例）方法，且TreeItem须设id、command及arguments为数组。
createTreeView 为什么传数组就报错
因为 vscode.window.createTreeView 接收的不是数据本身，而是一个实现了 TreeDataProvider 接口的对象。它只认两个方法：getChildren 和 getTreeItem。传入静态数组会直接触发 TypeError: treeDataProvider.getChildren is not a function。
常见错误写法：
vscode.window.createTreeView('myTreeView', { data: [...] }); // ❌ 错误：data 不是 TreeDataProvider
正确做法是先实现一个类，再实例化传入：
-
getChildren(element?)必须返回Promise<treeitem></treeitem>，根节点调用时element是undefined -
getTreeItem(element)必须返回vscode.TreeItem实例（不能是 plain object） - 哪怕只有一个节点，也要包装成
new vscode.TreeItem(label)并设collapsibleState
TreeItem 点击无响应的三个硬性条件
90% 的点击失效问题都卡在这三处，缺一不可：
-
id字段未设置：折叠状态无法记忆，command.arguments拿不到上下文，右键菜单contextValue匹配也会错位 -
command字段缺失：即使你在package.json里注册了registerCommand('myExtension.open')，没绑定到节点上就是白搭 -
arguments不是数组：写成arguments: element.id会静默失败；必须是arguments: [element.id]，哪怕只传一个值
示例片段：
getTreeItem(element: MyNode): vscode.TreeItem {
const item = new vscode.TreeItem(element.label, element.collapsibleState);
item.id = element.id; // ✅ 必须
item.command = {
command: 'myExtension.openDetail',
title: 'Open detail',
arguments: [element.id] // ✅ 必须是数组
};
return item;
}
右键菜单不出现？检查 package.json 的 when 条件匹配
TreeView 的右键菜单和点击命令是两套独立机制。给 TreeItem 配了 command，右键依然不会弹出任何选项——除非在 package.json 中显式声明 contributes.menus，且 when 表达式与节点的 contextValue 严格一致。
-
contextValue是字符串，比如'fileNode'或'folderNode'，需在getTreeItem中手动赋值 -
package.json中的when: "viewItem == fileNode"必须完全等于该值，大小写、空格都不能差 - 菜单位置要写对：
"view/item/context"对应节点右键，"view/title"对应视图标题栏
漏掉任意一项，右键菜单就彻底消失，且无任何报错提示。
刷新 TreeView UI 的唯一可靠方式
Tree View 不会自动响应数据变化。想让 UI 更新，必须通过事件通知机制触发重绘。靠 treeView.reveal() 或手动修改节点属性都没用。
- 在
TreeDataProvider类中定义EventEmitter：private _onDidChangeTreeData = new vscode.EventEmitter<any>(); - 暴露
onDidChangeTreeData属性：onDidChangeTreeData = this._onDidChangeTreeData.event; - 提供
refresh()方法：refresh(): void { this._onDidChangeTreeData.fire(undefined); } - 外部调用
provider.refresh()即可触发整棵树重新调用getChildren和getTreeItem
容易被忽略的是：这个事件必须由同一个 TreeDataProvider 实例发出，跨实例或延迟绑定都会导致刷新失效。
