需先确认 Node ≥ v16.0.0 并安装 sharp（非 gm/canvas），再运行 resize-images.js 脚本，支持指定宽高、等比缩放（contain/cover）及覆盖原图，注意路径、格式校验与并发控制。
确认 Node 版本和全局依赖是否就位
VSCode 本身不提供图片处理能力，真正干活的是你本地的 node 环境 + 第三方库。先验证 node -v 和 npm -v 能正常输出——低于 v16.0.0 的版本可能无法使用 sharp 最新版，而 sharp 是目前最稳、最快的图片批量裁剪方案。
别用 gm 或 canvas：前者依赖系统 ImageMagick 安装易失败，后者在非浏览器环境要额外配 native 模块，踩坑概率高。
- 执行
npm install sharp --save（推荐本地安装，避免全局污染） - 确保目标目录下有
node_modules，且sharp已正确编译（安装时看到info sharp Using cached...或成功构建日志） - Windows 用户若遇到
Cannot find module './build/Release/sharp-win32-x64.node'，说明二进制没下下来，可加参数重装：npm install sharp --arch=x64 --platform=win32
写一个可直接运行的裁剪脚本（支持指定宽高/等比缩放/覆盖原图）
新建一个 resize-images.js 放在待处理图片目录同级，内容如下：
const fs = require('fs').promises;
const path = require('path');
const sharp = require('sharp');
const INPUT_DIR = './images'; // ← 改成你的源目录路径
const OUTPUT_DIR = './resized'; // ← 输出目录，会自动创建
const TARGET_WIDTH = 800;
const TARGET_HEIGHT = 600;
const FIT_MODE = 'contain'; // 可选 'cover' 'contain' 'fill' 'inside' 'outside'
async function resizeAll() {
const files = await fs.readdir(INPUT_DIR);
const imageFiles = files.filter(f => /\.(jpe?g|png|webp|gif)$/i.test(f));
for (const file of imageFiles) {
const inputPath = path.join(INPUT_DIR, file);
const outputPath = path.join(OUTPUT_DIR, file);
try {
await sharp(inputPath)
.resize(TARGET_WIDTH, TARGET_HEIGHT, { fit: FIT_MODE, withoutEnlargement: true })
.toFile(outputPath);
console.log(`✅ ${file} → ${TARGET_WIDTH}x${TARGET_HEIGHT}`);
} catch (err) {
console.error(`❌ ${file}:`, err.message);
}
}
}
resizeAll();
关键点：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
-
withoutEnlargement: true防止小图被强行拉伸，强烈建议保留 -
fit: 'contain'保持比例并完整显示，四周可能留白；'cover'则裁剪居中区域填满目标尺寸 - 若想覆盖原图，把
outputPath改成inputPath，但务必先备份——sharp写入是原子操作，出错不会损坏原图，但逻辑错误可能误删
在 VSCode 里快速运行并调试
不用切终端、不用记命令。右键点击 resize-images.js → “Run Code”，前提是已装 Code Runner 插件且配置了 Node 运行器；更稳妥的方式是用 VSCode 内置终端：
- 打开终端：
Ctrl+`（反引号），确保当前路径是脚本所在目录 - 运行：
node resize-images.js - 想边改边试？加一句
console.time('total')开头、console.timeEnd('total')结尾，看整体耗时 - 如果报错
ERR_MODULE_NOT_FOUND，说明用了 ES Module 语法（如import），把文件后缀改成.mjs或在package.json加"type": "module"
常见失败场景和绕过方法
不是所有图都能顺利处理。以下错误出现时别急着重装：
-
Error: Input buffer contains unsupported image format：文件扩展名和实际格式不符（比如 .jpg 文件其实是 WebP），用file filename.jpg（macOS/Linux）或ffprobe -v quiet -show_entries format=format_name -of default=nw=1 filename.jpg检查真实格式 - 动图（GIF）只处理第一帧：这是
sharp默认行为，如需逐帧处理，得配合gifsicle或改用ffmpeg流式处理，复杂度陡增，建议先人工筛出静态图 - 中文路径报错
ENAMETOOLONG或乱码：Windows 下 Node 对长路径支持差，把脚本和图片移到盘根目录下（如D:\pics\）再试 - 内存溢出（OOM）：一次处理几百张高清图容易触发，加个并发控制，比如用
p-map限制同时处理 4 张
批量图片分辨率调整这事，核心不在 VSCode，而在脚本是否贴合你的原始数据质量。格式混杂、路径含空格、尺寸差异极大——这些细节比语法更重要。
