tdewolff/minify

Minify

概述

Minify是一个用Go语言编写的高性能Web格式压缩工具包，支持HTML5、CSS3、JavaScript、JSON、SVG和XML等文件类型的压缩。其核心原理是通过移除冗余字节（如空白字符、注释、默认属性值等）而不改变文件输出内容，从而减小文件体积，加快网络传输速度和解析效率。该工具通过将MIME类型与压缩函数关联，可自动处理嵌入式资源（如HTML中的CSS或JS代码块），并允许用户基于MIME类型或正则表达式扩展自定义压缩器或集成外部命令（如Closure Compiler、UglifyJS等）。

核心功能与特性

• 多格式原生支持：内置HTML5、CSS3、JS、JSON、SVG和XML压缩器，覆盖主流Web资源类型。
• 高性能设计：采用解析器而非正则表达式处理文件，确保压缩安全且效率极高，通常比传统工具快1-2个数量级。
• 嵌入式资源处理：自动识别并压缩文件中嵌入的资源（如HTML内的<style>或<script>标签内容）。
• 灵活扩展能力：支持通过MIME类型或正则表达式添加自定义压缩函数、外部命令（如esbuild）或第三方压缩工具。
• 命令行工具集成：提供CLI工具，支持并发压缩、文件变更监控（-w参数）和批量处理，方便集成到构建流程。
• 安全压缩策略：严格遵循各格式规范，仅进行安全压缩（如CSS不合并规则集，JS不修改全局作用域变量），避免破坏文件功能。

使用场景与适用范围

• Web开发优化：压缩静态资源（HTML、CSS、JS等），减少服务器带宽消耗，提升网站加载速度。
• 构建流程集成：作为CI/CD环节的一部分，自动压缩项目资源文件，输出优化后的生产环境版本。
• 动态服务压缩：通过中间件（m.Middleware）实现HTTP响应实时压缩（建议配合缓存使用以避免性能损耗）。
• 临时文件处理：通过命令行工具快速压缩单个或批量文件，满足即时优化需求（如手动压缩配置文件）。

安装与使用

Docker镜像获取

从Docker Hub拉取官方镜像：

bash
docker pull docker.xuanyuan.run/tdewolff/minify

基础命令格式

Minify Docker镜像内置CLI工具，基本使用语法如下：

bash
docker run --rm -v [本地目录]:/data docker.xuanyuan.run/tdewolff/minify minify [选项] [输入文件] -o [输出文件/目录]

参数说明

• --rm：容器退出后自动清理，避免残留临时文件。
• -v [本地目录]:/data：将本地目录挂载到容器内/data路径，用于访问输入文件和输出结果。
• minify：容器内CLI工具名称，后续为具体压缩参数。
• 核心选项：
  • -w：监控文件变更并自动重新压缩。
  • -u：启用并发压缩（多文件处理时加速）。
  • --help：查看所有支持的格式特定选项（如--html-keep-whitespace、--css-precision等）。

常用操作示例

1. 压缩单个HTML文件

将当前目录下的index.html压缩为index.min.html：

bash
docker run --rm -v $(pwd):/data docker.xuanyuan.run/tdewolff/minify minify /data/index.html -o /data/index.min.html

2. 压缩CSS并保留高精度数值

压缩style.css，设置CSS数值保留3位有效数字（默认0为不限制）：

bash
docker run --rm -v $(pwd):/data docker.xuanyuan.run/tdewolff/minify minify --css-precision 3 /data/style.css -o /data/style.min.css

3. 监控JS文件变更

实时监控app.js，文件修改后自动压缩为app.min.js：

bash
docker run --rm -v $(pwd):/data docker.xuanyuan.run/tdewolff/minify minify -w /data/app.js -o /data/app.min.js

4. 批量压缩目录文件

并发压缩src/目录下所有JS文件，输出到dist/目录：

bash
docker run --rm -v $(pwd):/data docker.xuanyuan.run/tdewolff/minify minify -u /data/src/*.js -o /data/dist/

5. 集成外部压缩工具（如esbuild）

通过AddCmd配置使用esbuild压缩JS（需提前在容器内安装esbuild）：

bash
# 示例：通过自定义命令行调用esbuild（需确保容器内有esbuild可执行文件）
docker run --rm -v $(pwd):/data docker.xuanyuan.run/tdewolff/minify sh -c "minify --js-cmd 'esbuild --minify' /data/app.js -o /data/app.min.js"

格式特定配置选项

各压缩器支持精细化配置，可通过命令行参数调整，常见选项如下：

通过docker run --rm tdewolff/minify minify --help可查看完整选项列表。

性能参考

Minify在Thinkpad T460（i5-6300U 2.4GHz）上的基准测试结果（Go 1.15环境）：

相比传统工具（如UglifyJS、Terser），Minify在JS压缩速度上快10-100倍，且压缩率接近专业工具水平。

许可证

Minify基于MIT许可证开源，详细信息参见https://github.com/tdewolff/minify/blob/master/LICENSE%E3%80%82