状态栏项不显示需调用show()并加入context.subscriptions；text/tooltip需手动赋值更新；command须在package.json声明且正确注册；颜色应使用themecolor而非rgb。
状态栏项创建后不显示？检查 show() 和 context.subscriptions
最常见的情况是调用了 vscode.window.createStatusBarItem 却没调用 item.show()，结果图标完全不出现。VS Code 不会自动渲染状态栏项，必须显式触发；同样，若忘记把 item 加入 context.subscriptions，插件停用时不会自动清理，可能引发内存泄漏或下次启动时残留旧状态。
- 确保在
activate函数内完成：创建 → 设置属性（text、tooltip、command）→ 调用show()→ 推入context.subscriptions - 如果只在命令回调里创建（如用户点击才显示），记得每次都要
show()，且不要重复 push 同一个 item 实例 - 调试时可在创建后加
console.log('status bar item created:', item)，确认执行到了这一步
tooltip 或 text 不更新？别依赖自动刷新，得手动赋值
状态栏项不是响应式对象——改了变量值，item.text 不会跟着变。比如监听 Git 分支变化后，你得拿到新分支名，再执行 item.text = `$(git-branch) ${branch}`，否则永远卡在初始值。
-
tooltip同理：修改item.tooltip = 'New tooltip'才生效，不能只改外部字符串变量 - 更新前建议先比对是否真有变化：
if (item.text !== newText) item.text = newText，避免无谓重绘 - 图标语法必须用 VS Code 内置格式，如
$(zap)、$(sync~spin)；写成icon: 'zap'或⚡都无效
点击状态栏没反应？command 和 package.json 必须配对
设了 item.command = 'myExtension.doSomething' 但点击无反应，大概率是漏了注册命令。VS Code 要求命令名必须在 package.json 的 contributes.commands 里声明，否则直接忽略点击事件。
-
package.json中需包含：{ "contributes": { "commands": [{ "command": "myExtension.doSomething", "title": "Do Something" }] } } - 命令注册必须在
activate中完成：vscode.commands.registerCommand('myExtension.doSomething', handler) - 如果命令名拼错（比如大小写不一致、多空格），控制台不会报错，只会静默失败——建议复制粘贴，别手敲
图标颜色/背景色不生效？优先用 ThemeColor，别硬写 RGB
直接赋值 item.color = '#ff0000' 在深色/浅色主题下可能不可见或反色异常。VS Code 推荐使用内置主题色变量，由当前主题动态解析。
- 正确写法：
item.color = new vscode.ThemeColor('statusBarItem.warningForeground') - 可用主题色名参考官方文档
statusBarItem.*系列，如infoForeground、errorBackground - 若想彻底自定义颜色（比如固定红色警告），可配合 CSS 注入（需启用 Custom CSS 扩展），但属于非标准路径，升级后易失效
- 注意：颜色设置仅对文字生效，图标（
$(...)）本身颜色由主题统一控制，无法单独改
Developer: Toggle Developer Tools），过滤 console 输出，重点看有没有未捕获的 promise rejection 或 command not found 日志；同时确认插件是否真的被加载（Developer: Show Running Extensions）。
