直接用 node 跑图片处理脚本更可靠，因vscode不内置图片批量处理能力，本质是编辑+运行node.js脚本；装gui插件易卡顿且不支持cli参数，而sharp等命令式库在终端直跑高效可控。
为什么直接用 node 跑图片处理脚本比装插件更可靠
VSCode 本身不内置图片批量处理能力，所谓“在 VSCode 中处理”，本质是用它编辑 + 运行 Node.js 脚本。很多用户误以为要找“VSCode 图片处理插件”，结果装了带 GUI 的扩展，反而卡顿或不支持 CLI 参数。真实高效的做法是：写一个 node 脚本，用 sharp 或 gm 这类命令式库，在终端里直接跑——VSCode 只负责写代码、调试、看输出。
关键点：sharp 性能远超 gm（尤其多核 CPU），但 Windows 上需确保已安装 Python 和 Visual Studio Build Tools（sharp 编译原生模块依赖）；若只想零配置，改用 canvas + jpeg-js 组合，纯 JS 实现，启动慢但无构建问题。
sharp 批量压缩/裁剪时路径和并发怎么设才不出错
常见错误是脚本跑一半卡住或报 EMFILE: too many open files，根源在于默认并发过高且没控制文件句柄释放。正确做法不是调低 concurrency，而是用流式处理 + 显式关闭资源。
-
sharp的.toBuffer()会把整张图加载进内存，100 张 5MB 图 = 500MB 内存峰值 → 改用.toFile()直接写磁盘，避免堆积 - 用
glob获取路径时，务必加{ nodir: true }，否则遇到子目录就崩 - 并发数设为
Math.min(os.cpus().length, 4)，Windows 上超过 4 常触发句柄泄漏 - 别用
fs.readdirSync后再map+Promise.all，应改用p-map控制并发，例如：const pMap = require('p-map');<br>await pMap(filePaths, async file => {<br> await sharp(file).resize(800).toFile(`out/${path.basename(file)}`);<br>}, { concurrency: 4 });
如何让脚本自动识别图片类型并跳过非图片文件
sharp 对非图片文件（如 .DS_Store、.txt）会抛 Input buffer contains unsupported image format 错误，但你不该靠 try/catch 挨个试——效率低还掩盖真正问题。
更稳的方式是预过滤：
- 用
file-type库读文件头（只读前 4KB），比扩展名靠谱得多：const fileType = require('file-type');<br>const buffer = await fs.promises.readFile(filePath);<br>if ((await fileType.fromBuffer(buffer))?.mime.startsWith('image/')) { /* 处理 */ } - 或者用
sharp自带的sharp(file).metadata()，它失败快（底层 libvips 会快速拒绝非图像），但注意：必须传绝对路径，相对路径可能静默失败 - Windows 用户特别注意：
fs.stat判断isFile()后，还要检查size > 0，NTFS 里空文件会被sharp当作损坏图像处理
调试时图片输出全黑或尺寸不对怎么办
最常踩的坑是忘了 sharp 默认保留原始色彩空间，而浏览器只认 sRGB。导出 PNG/JPEG 时如果没显式转色域，Mac 上看着正常，Windows Chrome 里可能发灰甚至全黑。
- 强制转 sRGB：
.toColourspace('srgb')（注意拼写是Colourspace，不是Colorspace） - resize 后没指定
fit和position，默认居中裁切 → 加.resize(800, 600, { fit: 'contain', background: '#fff' })避免意外裁剪 - 输出 WebP 时漏掉
quality，默认是 80，但某些旧版sharp（.webp({ quality: 80 }) - VSCode 终端里跑脚本看不到实时进度？加
console.log(`${i}/${total} ${fileName}`)即可，别依赖 fancy-progressbar —— 纯文本最稳
复杂点在于：同一张图在不同系统上解码后像素值可能差几个 LSB，这不是 bug，是 libvips 渲染路径差异。如果业务要求像素级一致，就得弃用 sharp，改用 pngjs + jpeg-js 手动实现，但速度会降 5–8 倍。
