VSCode任务配置必须显式设"type":"shell"才能正确执行Node脚本，否则默认解析器会导致node命令失效；glob模式需在脚本内处理而非tasks.json；输出目录须手动创建，quality参数影响视觉质量非线性。
VSCode 任务配置必须显式指定 shell 类型才能正确执行 Node 脚本
直接写 "type": "shell" 是关键，否则 VSCode 默认用终端内置命令解析器（如 Windows 的 cmd.exe），会忽略 node 命令或报 'node' is not recognized 错误。尤其在跨平台项目中，Mac/Linux 用户也容易因默认 type 为 process 导致脚本静默失败。
实操建议：
- 在
.vscode/tasks.json中，"type"字段必须设为"shell"，不能省略或留空 -
"command"直接写"node compress-png.js"，不要加npm run包装层（除非你真有package.json中定义了该 script） - Windows 用户若仍报错，检查系统 PATH 是否包含 Node 安装路径；可临时改用绝对路径，如
"C:\Program Files\nodejs\node.exe compress-png.js"
glob 模式在 tasks.json 中不生效，得靠脚本内部处理
很多人试图在 tasks.json 的 "args" 里传 ./src/**/*.png，但 VSCode 任务系统不会展开 glob——它只是原样传给 Node 进程，而 node 自身不解析通配符，最终 imagemin 收到的是字面字符串，不是文件列表。
正确做法是把路径逻辑收进脚本里：
- 脚本中用
['./src/**/*.png']作为imagemin的第一个参数（它自己支持 glob） - 别在
tasks.json中尝试用args控制输入范围，那是徒劳的 - 如果需动态目录，可在脚本里读取环境变量，比如
process.env.INPUT_DIR || './src'
输出目录未创建会导致 imagemin 静默失败
imagemin 不会自动创建 destination 路径的父级目录。如果 ./dist 不存在，它既不报错也不建目录，而是跳过所有文件——你只会看到 ✅ 压缩完成:0 张 PNG，毫无提示。
解决方式很简单：
- 脚本开头加一行
require('fs').mkdirSync('./dist', { recursive: true }); - 或者用
fs.promises.mkdir('./dist', { recursive: true })（配合 async/await） - 别依赖
tasks.json的"group": "build"或其他字段来“触发”目录创建——它没这功能
压缩质量参数 quality: [0.4, 0.6] 实际影响远超直觉
这个数组不是“最低/最高质量”，而是 pngquant 的“保真度下限/上限”。0.4 意味着允许丢弃大量色阶细节，对 UI 截图可能肉眼可见 banding（色带）；0.6 在多数场景下已足够，但若图片含精细渐变（如设计稿），建议先试 0.7。
几个硬经验：
-
speed: 1必须显式设置，否则默认speed: 3，压缩比下降 15%–25% - 含大量纯色区域的 PNG（如图标），
quality: [0.2, 0.4]也能接受；但含照片类内容的 PNG，慎用低于 0.5 - 别指望
verbose: true输出每张图的压缩率——它只打日志，不返回结构化数据；如需统计，得用imagemin的回调或改用sharp+ 自定义 pipeline
真正卡住人的往往不是语法，而是 destination 目录不存在却无报错、glob 在任务配置里被当字面量、以及 quality 数值和视觉损失之间的非线性关系——这些点不提前踩一遍，脚本看起来跑通了，实际什么都没压。
