vscode插件市场图标必须为128×128像素png格式，仅支持package.json中icon字段指定的相对路径文件，不支持svg、jpeg、url或base64；界面图标与市场图标相互独立，需分别配置。
插件市场图标必须用 PNG，128×128 像素
VSCode 插件市场（marketplace.visualstudio.com）只接受 icon 字段指向的 PNG 文件，且明确要求分辨率为 128x128。JPEG、SVG、ICO 或任何其他格式都会被忽略，上传时不会报错，但图标在市场页显示为空白或默认齿轮。
常见错误现象：
- 本地开发时用
.svg图标预览正常，发布后市场页不显示 - 用了
256x256或64x64的 PNG，图标模糊或被裁切 - 路径写成
./icons/icon.svg，但 package.json 中icon字段只认相对路径下的 PNG
实操建议：
- 图标文件放在项目根目录或
images/子目录下，确保路径与package.json中一致 - 用 ImageMagick 或在线工具批量转为无透明通道、无嵌入 ICC 配置的纯 PNG：
convert icon.svg -resize 128x128 -background white -alpha remove -flatten icon.png - 检查最终打包后的
.vsix文件：解压后确认icon.png确实在根目录且大小为 128×128
package.json 的 icon 字段只支持相对路径，不支持 URL 或 base64
icon 字段值必须是相对于 package.json 的路径字符串，例如 "icon": "images/extension-icon.png"。写成 "https://example.com/icon.png" 或 "data:image/png;base64,..." 全部无效——VSCode 市场构建流程根本不会解析这些内容。
为什么容易踩坑：
- 误以为和 Web 页面一样能加载远程资源，实际市场打包器只做静态文件拷贝
- 本地测试时用 Live Server 预览，路径看似通，但发布时 VSIX 打包不包含外部资源
- 某些脚手架（如 yo code）默认生成 SVG 路径，需手动改回 PNG 并校验路径
实操建议：
- 运行
vsce package后，用unzip -l your-extension-0.1.0.vsix | grep icon确认图标文件已打入包内 - 不要依赖插件开发期的热重载效果，市场图标只读取打包那一刻的文件状态
- 路径中避免大写字母或空格，Windows 下可能因大小写敏感导致找不到文件
侧边栏/活动栏图标和市场图标是两套独立资源
插件在 VSCode 界面中显示的图标（比如活动栏里的小图标）和插件市场页面显示的图标，来源完全不同：package.json 的 icon 字段只用于市场；界面图标由 contributes.viewsContainers.icon 或 contributes.menus 中指定的 SVG 决定，二者互不影响。
典型混淆场景：
- 改了市场图标 PNG，结果侧边栏还是灰色齿轮——那是
viewsContainers加载失败导致的兜底行为 - 侧边栏图标正常，但市场页空白——说明
icon字段路径错或文件没打进 VSIX - 误用同一份 SVG 同时塞给市场和界面，结果市场拒收（非 PNG），界面又因 SVG 不合规（含渐变、fill="currentColor"）而渲染失败
实操建议：
- 市场图标：专注 128×128 PNG，命名清晰（如
market-icon.png） - 界面图标：单独准备单色 SVG（
#000或#fff，无 style 标签、无宽高属性、viewBox="0 0 16 16"） - 两者路径分开管理，别共用一个字段或文件
图标颜色和风格没有强制规范，但用户感知很直接
VSCode 官方不规定图标配色、形状或风格，但市场算法会基于点击率、安装量、用户停留时间等隐式评估视觉质量。灰暗、文字过多、缺乏辨识度的图标，真实转化率明显偏低。
数据反馈出的有效实践：
- 主色控制在 1–2 种，避免多色渐变（尤其在深色主题缩略图里易糊成一团）
- 留白充足，文字尽量不用——128×128 下中文几乎不可读，英文缩写也慎用
- 避免使用 VSCode 自带图标元素（如文件夹、齿轮、括号），否则用户第一眼无法区分是系统还是你的插件
- 同类功能插件（如 ESLint、Prettier、Stylelint）图标风格趋同，新插件若反差过大，会被认为“不专业”或“不兼容”
真正容易被忽略的是：市场图标一旦发布，修改后不会自动同步到已安装用户的历史版本页——旧版本仍显示旧图标，除非用户手动更新插件并刷新页面。所以首次提交前务必确认终稿。
