VSCode插件侧边栏Badge不自动刷新，必须显式调用viewContainer.updateBadge(badge)更新，传undefined可清除；初始值在package.json中静态定义，运行时仅支持内容更新，不支持配置变更。
VSCode 插件开发中，侧边栏 Badge（右上角小红点/数字）不能自动刷新，必须手动触发更新；它和状态栏项一样，属于“创建即冻结、更新靠手推”的设计模式。
Badge 更新必须调用 updateBadge 才生效
Badge 不是响应式属性，设置 badge 字段后不会监听任何变化。哪怕你改了扩展状态、Git 分支切换、或用户点了按钮，Badge 依然静止不动。
- 创建容器时传入的
badge只是初始值，例如：{ badge: { value: '3', tooltip: '有 3 个待处理任务' } } - 后续所有更新都必须显式调用
viewContainer.updateBadge(badge)，且每次都要传完整对象 - 如果想清除 Badge，不能传
null或空对象，得传undefined：viewContainer.updateBadge(undefined) - 该方法是异步但无返回值，调用后 UI 不会立刻重绘——实际刷新由 VS Code 主线程在下一帧统一处理，所以连续快速调用多次，可能只显示最后一次效果
viewsContainers 注册后无法动态修改 Badge 配置
Badge 的定义（是否显示、初始内容）写在 package.json 的 contributes.viewsContainers 中，仅在插件激活时读取一次。运行时无法通过 API 修改这个配置。
- 比如你注册了
"badge": { "value": "1" }，之后想改成带图标+文字的 Badge，做不到 - 也不能在
activate里反复调用registerViewsContainer来“重载”配置——会报错container with id 'xxx' already registered - 真正可变的只有
updateBadge接口传入的内容，它不改变容器元信息，只影响渲染层
Badge 更新时机容易踩的坑
常见错误是把 Badge 当成“状态快照”，在事件回调里直接计算并更新，结果出现闪烁、延迟或漏更。
- 监听
onDidChangeTextDocument时，若每输一个字符就updateBadge，会导致 Badge 频繁闪动，尤其在远程开发或低配机器上明显 - Git 状态变更（如
git.status）通常有延迟，直接监听onDidChangeRepository后立刻查repository.state.HEAD可能拿到旧值，应加setTimeout(..., 0)或用repository.state.onDidChange等稳定事件 - 多个来源（比如 Git + 自定义任务队列）同时触发更新时，没做防抖或合并，会出现 Badge 值跳变，例如从
2→1→3，中间态不该暴露给用户 - Badge 的
tooltip字符串长度超过 40 字，部分主题下会被截断且无省略号，建议提前slice(0, 38) + '…'
Badge 是轻量提示，不是状态面板。它只适合表达“有事发生”，不适合承载具体逻辑或长文本——真要展示详情，该用通知、状态栏项或 WebView。
