状态栏项点击无反应，主因是未在package.json的contributes.commands中声明命令；须确保command字符串完全一致，并显式注册。
statusBarItem.command 点击没反应？检查 package.json 命令声明
状态栏项点击无反馈，最常见原因是只在 extension.ts 里写了 item.command = 'extension.myAction'，却没在 package.json 的 contributes.commands 中声明该命令。VS Code 不会自动注册任何命令，必须显式声明才能出现在命令系统中。
确保 package.json 包含类似结构：
{
"contributes": {
"commands": [
{
"command": "extension.myAction",
"title": "My Action",
"category": "Custom"
}
]
}
}
- command 字符串必须完全一致（大小写、点号、前缀都不能错）
- 如果用了
activationEvents: ["onCommand:extension.myAction"]，首次点击会触发插件激活；否则需提前激活 - 未声明的 command 会导致点击静默失败，控制台不报错，也不弹提示
想响应文件切换或编辑变化？别只监听 onDidChangeActiveTextEditor
仅靠 vscode.window.onDidChangeActiveTextEditor 无法捕获“编辑器内容变更”——它只在焦点切到另一个编辑器时触发，比如从 A.ts 切到 B.py。但用户在当前文件里打字、删行、粘贴，这个事件根本不会发。
真正需要动态更新文本的场景（如统计选中行数、显示 TODO 数量），应监听：
-
vscode.workspace.onDidChangeTextDocument：每次按键/粘贴后触发，注意节流 -
vscode.window.onDidChangeTextEditorSelection：选区变化时触发（比 document 更轻量） -
vscode.window.onDidChangeTextEditorVisibleRanges：滚动时触发（用于“当前函数名”类需求）
且每次更新前务必检查 vscode.window.activeTextEditor 是否存在，避免 undefined 报错。
show() 和 dispose() 必须成对管理，否则状态栏残留或内存泄漏
vscode.window.createStatusBarItem() 返回的对象不是一次性组件，而是长期存活的 UI 实例。它的生命周期必须由插件主动控制：
- 调用
item.show()才真正渲染到状态栏；不调用则创建了也看不见 - 调用
item.dispose()或将其加入context.subscriptions，否则插件停用后图标仍挂在那儿，且监听器持续占用内存 - 不要反复
createStatusBarItem而不dispose：同一插件多次激活（如重载窗口）会导致多个重复项堆叠 - 若需隐藏而非销毁，用
item.hide()；hide()后可再show()，而dispose()不可逆
图标闪烁、文字跳变？先做值比对再赋值
状态栏 UI 频繁重绘（尤其配合 onDidChangeTextDocument）极易引发视觉抖动。根本原因不是逻辑慢，而是每次事件都无差别执行 item.text = newValue，哪怕新旧值完全相同。
正确做法是显式缓存上一次值，并只在真有变化时更新：
let lastText = '';
function updateStatusBar(text: string) {
if (text === lastText) return;
lastText = text;
item.text = text;
}
- 对图标同理：
item.text = `$(git-branch) ${branch}`每次都生成新字符串，即使 branch 没变，也会触发重绘 - 复杂计算（如正则匹配全文 TODO）务必加防抖，或只在
event.contentChanges.length > 0时才运行 - 不要在监听回调里直接调用
item.show()多次——它本身是幂等的，但没必要
activeTextEditor、一次没节流的全文扫描、一个漏掉 dispose 的 StatusBarItem，都会让插件在用户切换标签页、重载窗口或长时间运行后逐渐失稳。
