vscode中sharp无法运行需先确保系统node正确安装并被识别；macos需从命令行启动vscode或补全path；sharp是node端最佳图片转换库，应本地安装；配合tasks.json配置后台任务可实现保存自动转换；路径须相对于项目根目录，且需手动创建输出目录。
VSCode里Node没装好，sharp根本跑不起来
VSCode本身不自带Node运行时，必须先确认系统级Node已正确安装并被VSCode识别。打开终端（Ctrl+`），执行 node -v 和 npm -v。如果报错“command not found”，说明VSCode用的不是系统Shell环境——常见于macOS上用Launchpad启动VSCode（它继承的是GUI环境，而非Shell的$PATH）。解决方法：从命令行启动VSCode：code .；或在VSCode设置中搜索“terminal integrated env”，手动把PATH补全（Windows通常不用调，macOS/Linux需特别注意）。
用sharp批量转图片，别碰gm或canvas
sharp是目前Node生态里唯一真正适合自动化图片转换的库：轻量、跨平台、支持WebP/AVIF、有流式处理能力。而gm依赖GraphicsMagick本地二进制，Windows安装常失败；canvas编译复杂，且不原生支持AVIF。直接执行：npm install sharp。注意：不要全局安装（npm install -g sharp），VSCode调试时只认项目内node_modules里的版本。
一个最小可用脚本示例（存为convert.js）：
const sharp = require('sharp');
const fs = require('fs').promises;
async function convertJpgToWebp(inputPath, outputPath) {
await sharp(inputPath).webp({ quality: 80 }).toFile(outputPath);
}
convertJpgToWebp('./src/photo.jpg', './dist/photo.webp');
VSCode任务自动触发转换，关键在tasks.json的isBackground和problemMatcher
想保存图片后自动转格式？不能靠文件监视器（如chokidar）硬轮询，太耗资源。推荐用VSCode内置任务 + 文件关联。在项目根目录建.vscode/tasks.json：
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
{
"version": "2.0.0",
"tasks": [
{
"label": "convert-to-webp",
"type": "shell",
"command": "node convert.js",
"group": "build",
"isBackground": true,
"problemMatcher": {
"owner": "custom",
"pattern": [
{
"regexp": ".",
"file": 1,
"line": 2,
"column": 3,
"message": 4
}
]
}
}
]
}
然后在settings.json里加触发规则：
"files.associations": {
"*.jpg": "plaintext",
"*.png": "plaintext"
},
"files.watcherExclude": {
"**/dist/**": true
},
"task.autoDetect": "off"
最后按Ctrl+Shift+P → “Tasks: Configure Task” → 选“convert-to-webp”，再设为“Run on save”即可。注意两点：一是isBackground: true让任务不阻塞编辑；二是problemMatcher必须配空匹配（否则VSCode等不到任务结束就报错退出）。
转换结果路径出错？检查sharp的相对路径解析逻辑
sharp()接收的输入路径是相对于当前工作目录（即VSCode打开的文件夹根目录），不是convert.js所在位置。比如你在src/assets/里右键保存一张图，但convert.js在项目根目录，那么脚本里写./src/assets/photo.jpg才对——不能写./assets/photo.jpg。更稳妥的做法是用path.resolve(__dirname, '../src/assets/photo.jpg')。另外，sharp默认不创建父目录，如果./dist/不存在，会直接抛错ENOENT，得提前用fs.mkdir建好。
容易忽略的一点：sharp对SVG输入支持有限（仅转栅格化），且不支持PSD、RAW等专业格式；若需这些，得换libvips CLI或走Python管道。
