createStatusBarItem 创建的状态栏项需手动控制显示、更新与清理：必须在 activate 中创建并显式调用 show()，文本、图标（如 $(sync~spin)）、tooltip 和 command 均需主动设置且依赖正确注册；所有更新（如 Git 分支、选中行数、构建状态）须通过监听对应事件并主动赋值触发，不可依赖自动刷新。
用 createStatusBarItem 创建可更新的状态栏项
状态栏项不是静态标签，而是需要手动控制显示/隐藏、文本内容和交互逻辑的独立对象。调用 vscode.window.createStatusBarItem 是唯一标准入口，必须在 activate 函数中执行，且需显式调用 show() 才会出现在底部。
常见错误是只设置 text 就以为能自动刷新——它不会监听文件变化或任务事件，所有更新都得你主动触发。例如想显示当前分支，不能只写一次 item.text = "main"，而要在 Git 状态变更后重新赋值并调用 item.text = `$(git-branch) ${branchName}`。
-
StatusBarAlignment.Left和StatusBarAlignment.Right决定左右位置，数字优先级（如100）仅在同侧多个项时影响顺序 - 图标用 VS Code 内置的
$(icon-name)语法，比如$(sync~spin)表示旋转加载态，$(zap)表示闪电图标 - 不设
command属性时，点击无响应；设了之后还需在package.json的contributes.commands中声明对应命令
监听 onDidChangeTextDocument 实现编辑时动态更新
很多“实时信息”其实只需要响应文档内容变化，比如统计选中行数、检测 TODO 数量、高亮当前函数名。这类场景不必绑定构建或调试事件，直接监听编辑器内容变更更轻量、更稳定。
注意：该事件在每次按键后都会触发，若处理逻辑重（如全文正则匹配），会导致状态栏闪烁或卡顿。务必做节流或防抖，或者只在 event.contentChanges.length > 0 时才更新。
- 获取当前活动编辑器：
vscode.window.activeTextEditor，为undefined时跳过更新 - 统计选中行数可用
editor.selections.map(s => s.end.line - s.start.line + 1).reduce((a, b) => a + b, 0) - 避免频繁 DOM 操作：把计算逻辑和
item.text赋值拆开，先算值，再比对是否真有变化，再更新
绑定 tasks.onDidStartTask 和 onDidEndTask 显示构建状态
构建类状态（如 “Building…”、“Build succeeded”）依赖任务生命周期事件，但默认情况下 VS Code 不会向扩展暴露所有任务——只有设置了 "group": "build" 或 "problemMatcher" 的任务才会被识别为“构建任务”。否则 onDidStartTask 根本不会触发。
另一个易错点是：任务启动时状态栏项可能还没初始化完成，直接 item.show() 会失败。稳妥做法是在 activate 里先创建并隐藏项（item.hide()），等事件到来再 show() 并更新文本。
- 任务名称来自
event.execution.task.name，但注意它可能是undefined（如匿名任务），建议 fallback 到event.execution.task._label - 成功/失败状态不能只靠
onDidEndTask判断：该事件在任务退出时触发，但退出码需从event.execution.result?.exitCode获取，undefined表示未结束或被取消 - 别忘了清理：任务结束后，如果状态栏项只是临时展示，应调用
item.hide()，否则会残留 “Build succeeded” 长时间不消失
为什么 item.tooltip 和 item.command 经常失效
这两个属性看似简单，但实际生效有严格前提：item.tooltip 只在鼠标悬停且状态栏项已完全渲染后才显示，如果 item.text 为空或全是空白字符，tooltip 就不会出现；item.command 则要求对应命令已在 package.json 中注册，并在 activate 中用 vscode.commands.registerCommand 实际实现。
最常被忽略的是命令作用域问题：你在状态栏项上绑了 extension.openServer，但注册时写成了 registerCommand('openServer', ...)，漏了前缀，VS Code 就找不到这个命令。前缀必须和 package.json 中的 name 字段一致（如 "name": "my-statusbar-ext"，命令就得叫 "my-statusbar-ext.openServer"）。
- 调试 tooltip 是否生效：先确保
item.text有可见内容，比如设为"DEBUG"，再加item.tooltip = "Click to open debugger" - 命令点击无反应？检查开发者工具 Console 是否报错
command 'xxx' not found，再核对package.json的contributes.commands和activationEvents是否包含onCommand:xxx - 不要在
item.command里传参：它只接受字符串命令名，参数得靠vscode.commands.executeCommand('xxx', arg1, arg2)在别处触发
状态栏集成真正的复杂点不在 API 调用本身，而在于事件时机判断和资源清理——比如一个监听 Git 分支的项，既要响应 git.onDidPublish，也要响应 workspace.onDidChangeConfiguration（因为用户可能中途禁用 Git），还要在扩展停用时手动 dispose 所有事件监听器，否则会造成内存泄漏。这些细节不写进代码里，就永远只是“看起来能动”。
