VS Code 插件无法在标尺最左侧（行号区）添加图标，因插件仅能操作行号右侧的装饰列，行号及其左侧区域由编辑器内部渲染且不开放 API；gutterIconPath 仅支持 SVG 格式，需用 vscode-resource URI 且尺寸≤16×16 px。
VS Code 不支持通过插件直接向编辑器左侧标尺（gutter）区域注入自定义符号（比如自定义装饰图标、状态标记等），DecorationOptions 和 TextEditorDecorationType 只能作用于行号区右侧的 gutter 区域（即代码行左侧紧挨着代码的位置），且仅限**背景色块、边框、小图标（via gutterIconPath）和文字（via gutterIconSize + gutterIconPath 的 SVG 内联内容）**，不能插入任意 DOM 或 WebView。
为什么 setDecorations 无法在标尺最左侧加图标
VS Code 编辑器的 gutter 实际由多个逻辑列组成：最左是行号（line numbers），然后是断点列（breakpoints）、折叠控件列（folding）、装饰列（decorations）。插件能写的只有「装饰列」，也就是行号右侧那窄窄一栏；你看到的“标尺最左侧”其实是行号本身或其左侧空白区——这部分完全由 VS Code 内部渲染，插件无权访问。
-
TextEditorDecorationType的gutterIconPath图标始终对齐到装饰列中心，无法左贴边或覆盖行号 - 试图用
before/after装饰写入行号区会静默失败，不报错但也不显示 - 没有 API 对应
editor.gutterLayout或gutterElement类型的扩展点
gutterIconPath 支持什么格式与限制
你只能通过 gutterIconPath 指定一个本地路径（相对 extension.js 运行时路径）或 vscode-resource: 协议 URI 的 SVG 文件。PNG/JPEG 不支持缩放抗锯齿，强烈建议只用 SVG。
- SVG 必须是单色（推荐
#000000），VS Code 会自动按当前主题 tint 渲染 - 宽高建议 ≤ 16×16 px，过大则被裁剪或模糊（即使设
gutterIconSize: "contain"） - 路径必须是绝对路径或
vscode-resource:URI，相对路径如"./icons/warn.svg"在打包后常失效，应改用vscode.Uri.file(path.join(context.extensionPath, "icons", "warn.svg")) -
gutterIconSize只接受"auto"（默认）、"contain"、"cover"，不能设像素值
替代方案：用行号装饰模拟“左侧标尺符号”
如果你的真实需求是给某几行打上视觉标记（如 TODO、FIXME、测试覆盖率缺口），可利用行号本身的 lineNumber 装饰能力——它虽不属 gutter，但渲染位置紧贴最左，视觉上接近目标效果。
- 调用
editor.setDecorations(decorationType, ranges)时，decorationType配置isWholeLine: true+overviewRulerColor，再配合light/dark字段控制颜色 - 行号装饰需在
onDidChangeTextEditorVisibleRanges或onDidChangeTextEditorSelection中动态更新，否则滚动后消失 - 注意：行号装饰不会响应鼠标事件，无法点击跳转；若需交互，必须叠加一个透明
WebviewPanel覆盖编辑器左侧，但会破坏原生滚动同步，慎用
容易被忽略的关键点
所有 gutter 装饰都受 editor.glyphMargin 设置开关控制；如果用户关了这个选项（默认开启），你的图标将完全不显示，且插件无法检测或强制开启它。另外，多根编辑器（split editor）中每个 TextEditor 实例必须单独调用 setDecorations，复用同一个 TextEditorDecorationType 实例没问题，但 range 数组必须按 editor 归属重算。
