TreeView 初始化必须配合 TreeDataProvider 实现，其核心是实现 getChildren 和 getTreeItem 方法；节点交互需设置 id 和 command，右键菜单需在 package.json 中配置 view/item 并匹配 contextValue；刷新视图须通过 onDidChangeTreeData 事件触发。
TreeView 初始化必须配合 TreeDataProvider 实现
VSCode 的 TreeView 本身不存储数据，只是一个渲染容器。你调用 vscode.window.createTreeView 时传入的 treeDataProvider 才是核心——它决定节点长什么样、能否展开、点击后干什么。
常见错误是直接传一个静态数组或对象进去，结果视图空白或报 TypeError: treeDataProvider.getChildren is not a function。必须实现至少两个方法：getChildren 和 getTreeItem。
-
getChildren(element?)：返回Promise<treeitem></treeitem>；根节点调用时element为undefined，子节点则为上一级传入的element -
getTreeItem(element)：必须返回TreeItem实例（不能是 plain object），且需设置label和collapsibleState - 如果节点需要动态加载子项，
collapsibleState要设为vscode.TreeItemCollapsibleState.Collapsed或Expanded，否则“小箭头”不会出现
TreeItem 的 label 和 id 决定交互行为
TreeItem.label 是唯一显示文本，但真正影响点击响应的是 TreeItem.id 和 command 字段。VSCode 不会自动根据 label 触发命令，必须显式绑定。
典型误区是以为点击某行就会触发某个函数——其实什么都不会发生，除非你在 getTreeItem 中给该节点设置了 command 属性：
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] // 这个数组会原样传给 registerCommand
};
return item;
}
- 没设
id：节点无法被正确识别，折叠状态丢失，右键菜单可能错位 - 没设
command：点击无响应，即使绑了registerCommand('myExtension.openDetail', ...)也无效 -
arguments必须是数组，哪怕只传一个值也要写成[element.id]
右键菜单需要单独注册 context menu contribution
TreeView 里的右键菜单（context menu）和点击命令是两套机制。即使你给每个 TreeItem 配了 command，右键仍然不会弹出任何选项——除非在 package.json 里声明 contributes.menus。
关键配置项是 view/item，路径必须严格匹配你的视图 ID（即 createTreeView 的第一个参数）：
"contributes": {
"menus": {
"view/item": [
{
"command": "myExtension.deleteNode",
"when": "view == myViewId && viewItem == myExtension.node"
}
]
}
}
-
when条件中view == myViewId是必需的，否则菜单永远不出现 -
viewItem == ...是可选过滤，靠你在TreeItem.contextValue里设的字符串匹配（比如item.contextValue = 'myExtension.node'） - 漏写
contextValue或拼写不一致，右键菜单就静默失效
刷新视图要用 TreeDataProvider 的 onDidChangeTreeData 事件
数据变了，TreeView 不会自动重绘。你得自己触发通知——不是调用某个刷新函数，而是通过 EventEmitter 触发 onDidChangeTreeData。
最简做法是让 TreeDataProvider 实现 EventEmitter 接口，并暴露 onDidChangeTreeData 属性：
class MyTreeDataProvider implements vscode.TreeDataProvider<MyNode> {
private _onDidChangeTreeData = new vscode.EventEmitter<MyNode | undefined>();
readonly onDidChangeTreeData?: vscode.Event<MyNode | undefined> = this._onDidChangeTreeData.event;
refresh(): void {
this._onDidChangeTreeData.fire(undefined); // 刷新全部
}
refreshNode(node: MyNode): void {
this._onDidChangeTreeData.fire(node); // 只刷新该节点及其子树
}
}
- 调用
fire(undefined)相当于全量重载，适合配置变更、登录状态切换等场景 - 调用
fire(node)更高效，但要求该node在getChildren中能被正确识别并返回新子项 - 别忘了在
getChildren里加缓存逻辑，否则每次展开都重新 fetch，用户会明显感知卡顿
