VSCode插件图标必须为1024×1024 PNG且含Alpha通道、sRGB色彩空间；禁用渐变/阴影，适配深浅主题；仅支持PNG路径，不解析SVG；文件图标主题与插件Logo分离，推荐用SVG实现图标主题。
VSCode插件图标必须用1024×1024 PNG带透明通道
VSCode插件市场（marketplace.visualstudio.com）强制要求所有上架插件的图标为 1024×1024 像素、PNG 格式、含 Alpha 通道，且色彩空间为 sRGB。尺寸不符或缺透明背景的图标会被拒绝审核，即使本地显示正常——这是最常被卡住的硬性门槛。
常见错误现象：icon.png 是 512×512 或导出时勾选了“保留图层”导致无透明背景；用 Sketch/Figma 直接导出未检查“透明度”选项；Mac 上预览显示正常但上传后变白底。
实操建议：
- 用
ImageMagick批量校验并修复：identify -format "%wx%h %A %r" icon.png（确认输出含TrueColorAlpha sRGB） - Windows/macOS/Linux 统一推荐用
convert icon.png -resize 1024x1024^ -gravity center -extent 1024x1024 -alpha on -background none icon-1024.png - 别依赖编辑器内置导出，务必用命令行或在线工具（如 pngcheck）验证 Alpha 通道是否真实存在
插件 Logo 要适配深色/浅色主题且禁用渐变和阴影
VSCode 工作台会根据用户当前主题自动叠加一层半透明蒙版，图标若含复杂渐变、内阴影或低对比文字，会在深色模式下糊成一团，在浅色模式下又发灰不可读。官方设计规范明确禁止使用渐变和投影效果。
使用场景：图标会出现在扩展视图缩略图、命令面板提示、设置页插件卡片等多个上下文，尺寸从 16×16 到 1024×1024 动态缩放，细节必须可缩放不丢形。
实操建议：
- 图形主体用单色块+清晰负空间，避免细线、小图标嵌套、微小文字（如“v1.2”）
- 主色建议选高饱和度但非荧光色（如
#2E79B8比#FF00FF更稳），确保在 #000 和 #FFF 背景下都够显眼 - 用 Figma/Sketch 导出前关闭“抗锯齿”和“平滑”，防止边缘虚化；SVG 转 PNG 时禁用“模糊渲染”
vscode-drawio 那种“图标即图表”的实现方式不适用于普通插件
vscode-drawio 的图标能直接在 Draw.io 中编辑，是因为它把 .drawio 文件当图标资源用了——这属于极少数特例，依赖插件自身功能闭环。普通插件 **不能** 把 SVG 或 drawio 文件设为 icon 字段值，VSCode 插件清单（package.json）只接受 PNG 路径。
错误配置示例："icon": "logo.drawio" 或 "icon": "logo.svg" → 安装后图标不显示，控制台报 Failed to load icon。
实操建议：
- 所有图标路径必须是相对于
package.json的 PNG 文件，如"icon": "images/icon.png" - 想支持矢量？只能靠生成多分辨率 PNG（
16x16,32x32,1024x1024），VSCode 不解析 SVG 图标资源 - 若需运行时动态换图标（如状态指示），得用 WebView +
webview.iconPath，而非插件主 Logo
文件关联图标（file icon theme）和插件 Logo 是两套完全独立的系统
很多人混淆了“插件自己的 Logo”和“插件提供的文件图标”。前者是 package.json 里的 icon 字段，后者是插件通过 contributes.iconThemes 注册的完整图标主题包，包含 iconTheme.json 和几十个 SVG/PNG 文件。
性能影响明显：一个图标主题若打包了 200+ 个 1024×1024 PNG，会导致 VSCode 启动变慢、资源管理器滚动卡顿——尤其在远程开发或容器环境里。
实操建议：
- 插件 Logo 就一张图，别试图塞进图标主题逻辑里
- 若真要提供文件图标，用 SVG 而非 PNG（VSCode 原生支持 SVG 图标主题），并在
iconTheme.json中声明"defaultIcon": { "fontColor": "#6c5ce7" }控制默认色 - 图标主题的
fonts字段不要引用外部字体，VSCode 不加载 webfont，会导致图标空白
真正难的不是画得好看，是让这张图在 16×16 缩略图里还能认出是你做的插件——所有细节都在像素级取舍里，不是加阴影、不是堆特效，而是删到只剩核心符号。
