svg2png命令行工具最可靠，因VSCode无内置SVG转PNG功能，浏览器API受限、Electron插件易失败，而svg2png基于Node.js兼容性好、支持透明背景与指定尺寸，且比废弃工具更稳定解析现代SVG特性。
为什么直接用 svg2png 命令行工具最可靠
VSCode 本身不内置 SVG 转 PNG 功能，依赖 Node.js 生态的命令行工具是最轻量、可控的方式。浏览器 API（如 canvas.toDataURL）在 VSCode 插件中受限且无法稳定访问 DOM；而 Electron 环境下运行的插件又容易因上下文隔离失败。实测 svg2png 在 Node 16+ 下兼容性好、输出质量高、支持透明背景和指定尺寸。
- 安装前确保已全局或项目级安装 Node.js（
node -v可查版本） - 推荐使用 npm 安装：执行
npm install -g svg2png（全局）或npm install svg2png --save-dev（项目本地） - 注意：不要用
svg-to-png或svg2img——它们已多年未维护，对较新 SVG 特性（如<defs>引用、CSS 变量）解析失败率高
如何从 VSCode 终端一键转换单个 SVG 文件
在 VSCode 中打开 SVG 所在文件夹（右键 → “在集成终端中打开”），直接调用 svg2png 即可。它默认输出同名 PNG 到同一目录，无需额外配置。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 基础命令：
svg2png input.svg→ 输出input.png - 指定宽高：
svg2png input.svg --width 512 --height 512（注意：只设一个维度会等比缩放，两个都设则强制拉伸） - 保留透明背景（关键！）：
svg2png input.svg --background none（默认是白色背景） - 若报错
Error: Cannot find module 'sharp'，说明依赖未自动安装，手动运行npm install sharp（svg2png底层靠它渲染）
批量转换时如何避免文件名冲突和路径错误
VSCode 集成终端默认工作目录是当前打开的文件夹根目录，但 svg2png 不支持通配符（如 *.svg）。必须写脚本或借助 shell 命令逐个处理。
- Linux/macOS 终端中执行：
for f in *.svg; do svg2png "$f" --background none; done - Windows PowerShell 中执行：
Get-ChildItem *.svg | ForEach-Object { svg2png $_.FullName --background none } - 常见坑：
svg2png对相对路径敏感，若 SVG 内含<image href="logo.png">这类引用，需确保这些资源与 SVG 同目录，否则输出 PNG 会出现空白区域 - 输出目录建议单独指定：
svg2png input.svg --output ./dist/output.png，避免污染源目录
VSCode 中用任务（tasks.json）自动化转换的注意事项
想点一下“运行任务”就批量转？可以，但 tasks.json 的 shell 执行环境和终端不完全一致，尤其 Windows 下容易卡在权限或路径空格问题上。
- 在项目根目录建
.vscode/tasks.json，内容示例：
{
"version": "2.0.0",
"tasks": [
{
"label": "svg2png current dir",
"type": "shell",
"command": "svg2png",
"args": [
"${fileBasename}",
"--background",
"none"
],
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false
}
}
]
}
${fileBasename} 只能作用于当前打开的单个 SVG 文件，不支持多选或目录遍历'svg2png' is not recognized，需确认系统 PATH 包含 npm 全局 bin 目录（通常为 %USERPROFILE%\AppData\Roaming\npm），并在 VSCode 设置中启用 terminal.integrated.env.windows 补充该路径<foreignObject> 或依赖 JS 渲染的图表——这些 svg2png 一律不支持，得先用 Puppeteer 截图，那又是另一套环境了。 
