# 安装核心包（v9+ 不内置任何插件）
npm install imagemin
 
# 安装所需插件
npm install imagemin-pngquant    # PNG 压缩
npm install imagemin-mozjpeg     # JPEG 压缩
npm install imagemin-svgo        # SVG 优化
npm install imagemin-gifsicle    # GIF 压缩
npm install imagemin-webp        # WebP 转换

import imagemin from 'imagemin';
import imageminMozjpeg from 'imagemin-mozjpeg';
import imageminPngquant from 'imagemin-pngquant';
 
// ESM 模块（v9+ 强制 ESM）
const files = await imagemin(['images/*.{jpg,png}'], {
  destination: 'build/images',
  plugins: [
    imageminMozjpeg({ quality: 80 }),
    imageminPngquant({ quality: [0.6, 0.8] })
  ]
});
 
console.log('已优化的文件：', files);

import imagemin from 'imagemin';
import imageminMozjpeg from 'imagemin-mozjpeg';
 
// 最简单的使用
const files = await imagemin(['images/*.jpg'], {
  destination: 'output/',
  plugins: [
    imageminMozjpeg({ quality: 75 })
  ]
});
 
console.log(`优化了 ${files.length} 个文件`);

// 插件接口
async function plugin(buffer, options) {
  // 处理 buffer
  return optimizedBuffer;
}
 
// 插件通过 p-pipe 串联
const pipeline = pPipe(plugin1, plugin2, plugin3);
const result = await pipeline(inputBuffer);

// 开发环境：监听文件变化并优化
import chokidar from 'chokidar';
import imagemin from 'imagemin';
import imageminMozjpeg from 'imagemin-mozjpeg';
 
chokidar.watch('src/images/**/*.{jpg,png}').on('change', async (path) => {
  await imagemin([path], {
    destination: 'public/images',
    plugins: [imageminMozjpeg({ quality: 80 })]
  });
  console.log(`Optimized: ${path}`);
});

import gulp from 'gulp';
import imagemin from 'gulp-imagemin';
 
gulp.task('images', () =>
  gulp.src('src/images/**/*')
    .pipe(imagemin([
      imagemin.mozjpeg({ quality: 80 }),
      imagemin.pngquant({ quality: [0.6, 0.8] }),
      imagemin.svgo(),
      imagemin.gifsicle()
    ]))
    .pipe(gulp.dest('dist/images'))
);

// webpack.config.js
import ImageMinimizerPlugin from 'image-minimizer-webpack-plugin';
 
export default {
  plugins: [
    new ImageMinimizerPlugin({
      minimizer: {
        implementation: ImageMinimizerPlugin.imageminMinify,
        options: {
          plugins: [
            ['imagemin-mozjpeg', { quality: 80 }],
            ['imagemin-pngquant', { quality: [0.6, 0.8] }],
          ]
        }
      }
    })
  ]
};

# 检查依赖安全性
npm audit
npx audit-ci --moderate

// 风险：安装时从外部服务器下载二进制
// 可能的问题：
// 1. 下载服务器不可用
// 2. 二进制文件被篡改
// 3. 企业网络限制
 
// 缓解措施：
// 1. 使用缓存代理
// 2. 锁定二进制版本
// 3. 校验下载文件哈希

// 推荐配置：平衡质量和体积
const plugins = [
  // JPEG：mozjpeg 质量 80
  imageminMozjpeg({ quality: 80 }),
  // PNG：pngquant 质量范围
  imageminPngquant({ quality: [0.65, 0.8] }),
  // SVG：使用 svgo
  imageminSvgo({
    plugins: [{ name: 'preset-default' }]
  }),
  // GIF：限制颜色数
  imageminGifsicle({ colors: 128 })
];

// 生产环境推荐配置
import imagemin from 'imagemin';
import imageminMozjpeg from 'imagemin-mozjpeg';
import imageminPngquant from 'imagemin-pngquant';
import imageminSvgo from 'imagemin-svgo';
 
const productionPlugins = [
  // JPEG：质量 80，渐进式
  imageminMozjpeg({
    quality: 80,
    progressive: true
  }),
  // PNG：有损量化，质量范围
  imageminPngquant({
    quality: [0.65, 0.8],
    speed: 1  // 最高质量（最慢）
  }),
  // SVG：使用 preset-default
  imageminSvgo({
    plugins: [{ name: 'preset-default' }]
  })
];

// 错误：没有插件，不会做任何优化
await imagemin(['*.jpg'], { destination: 'out/' });
 
// 正确：传入插件
await imagemin(['*.jpg'], {
  destination: 'out/',
  plugins: [imageminMozjpeg({ quality: 80 })]
});

// CommonJS 项目无法使用 v9+
const imagemin = require('imagemin'); // ❌ 报错
 
// 解决方案：
// 1. 使用 v7（最后的 CJS 版本）
// 2. 切换到 ESM
// 3. 使用 dynamic import
const imagemin = (await import('imagemin')).default;

# 解决方案：使用缓存
# 设置环境变量缓存二进制
export MOZJPEG_BIN=https://your-cdn.com/mozjpeg-bin/

// Imagemin 方式
import imagemin from 'imagemin';
import imageminMozjpeg from 'imagemin-mozjpeg';
await imagemin(['*.jpg'], {
  destination: 'out/',
  plugins: [imageminMozjpeg({ quality: 80 })]
});
 
// Sharp 等效方式
import sharp from 'sharp';
import glob from 'glob';
const files = glob.sync('*.jpg');
await Promise.all(files.map(f =>
  sharp(f).jpeg({ quality: 80 }).toFile(`out/${f}`)
));

// 1. JPEG 压缩
// Imagemin: imageminMozjpeg({ quality: 80 })
// Sharp:    sharp(input).jpeg({ quality: 80 })
 
// 2. PNG 压缩
// Imagemin: imageminPngquant({ quality: [0.6, 0.8] })
// Sharp:    sharp(input).png({ quality: 80 })
 
// 3. SVG 优化（Imagemin 独有）
// 需要继续使用 svgo：
import { optimize } from 'svgo';
const result = optimize(svgContent, { plugins: ['preset-default'] });
 
// 4. 注意 Sharp 不支持的功能：
// - 特定编码器选择（mozjpeg、guetzli 等）
// - gifsicle 的 GIF 优化