跳转到主要内容

超快且智能的HTML + JS + CSS压缩器

项目描述

minify-html

一个针对速度和效率精心优化的Rust HTML压缩器,具有其他语言的绑定。

  • 先进的压缩策略在速度上超越其他压缩器。
  • 使用SIMD搜索、直接查找和查找表。
  • 处理无效的HTML,经过广泛的测试和模糊测试
  • 使用minify-jslightningcss进行超快的JS和CSS压缩。

查看变更日志以查看最新更新。

性能

html-minifierminimize的比较,在顶级网页上运行。在这里查看细分。

Chart showing speed of HTML minifiersChart showing compression of HTML minifiers

onepass变体在速度上进行了更多优化。查看其README以获取更多详细信息。

兼容性和用法

CLI

CLI 命令名为 minhtml。预编译的二进制文件适用于 Linux(ARM64 和 x64)、macOS(ARM64 和 x64)以及 Windows(x64)。您可以在 GitHub 发布版中下载它们。

如果您已安装 Cargo,也可以从源码构建和安装: cargo install minhtml

使用

使用 --help 参数获取更多详细信息。

minhtml --output /path/to/output.min.html --keep-closing-tags --minify-css /path/to/src.html

快速并行处理一批文件

minhtml --keep-closing-tags --minify-css /path/to/**/*.html
Rust

获取

[dependencies]
minify-html = "0.15.0"

使用

查看 API 和用法示例的 文档

Deno

使用

import init, {minify} from "https://wilsonl.in/minify-html/deno/0.15.0/index.js";

const encoder = new TextEncoder();
const decoder = new TextDecoder();

await init();

const minified = decoder.decode(minify(encoder.encode("<p>  Hello, world!  </p>"), { keep_spaces_between_attributes: true, keep_comments: true }));

所有 Cfg 字段 都可作为对象提供的第二个参数上的 snake_case 属性使用;如果未设置任何属性,则默认为 false

Node.js
  • 包: @minify-html/node
  • 绑定: Neon
  • 平台:Linux(ARM64 和 x64)、macOS(ARM64 和 x64)、Windows(x64);Node.js 8.6.0 和更高版本

获取

使用 npm

npm i @minify-html/node

使用 Yarn

yarn add @minify-html/node

使用

提供 TypeScript 定义。

import { Buffer } from "node:buffer";
import minifyHtml from "@minify-html/node";
// Or `const minifyHtml = require("@minify-html/node")` if not using TS/ESM.

const minified = minifyHtml.minify(Buffer.from("<p>  Hello, world!  </p>"), { keep_spaces_between_attributes: true, keep_comments: true });

所有 Cfg 字段 都可作为对象提供的第二个参数上的 snake_case 属性使用;如果未设置任何属性,则默认为 false

Java
  • 包: in.wilsonl.minifyhtml
  • 绑定: JNI
  • 平台:Linux(ARM64 和 x64)、macOS(ARM64 和 x64)、Windows(x64);Java 7 和更高版本

获取

作为 Maven 依赖项添加

<dependency>
  <groupId>in.wilsonl.minifyhtml</groupId>
  <artifactId>minify-html</artifactId>
  <version>0.15.0</version>
</dependency>

使用

import in.wilsonl.minifyhtml.Configuration;
import in.wilsonl.minifyhtml.MinifyHtml;

Configuration cfg = new Configuration.Builder()
    .setKeepHtmlAndHeadOpeningTags(true)
    .setMinifyCss(true)
    .build();

String minified = MinifyHtml.minify("<p>  Hello, world!  </p>", cfg);

所有 Cfg 字段 都可作为 Builder 的 camelCase 设置方法使用;如果未设置任何属性,则默认为 false

Python
  • 包: minify-html
  • 绑定: PyO3
  • 平台:Linux(ARM64 和 x64)、macOS(ARM64 和 x64)、Windows(x64);Python 3.8 到 3.12

获取

将 PyPI 项目作为依赖项添加,并使用 pippipenv 安装。

使用

import minify_html

minified = minify_html.minify("<p>  Hello, world!  </p>", minify_js=True, remove_processing_instructions=True)

所有 Cfg 字段 都可作为 Python 关键字参数使用;如果省略任何参数,则默认为 False

Ruby
  • 包: minify_html
  • 绑定: rb-sysmagnus
  • 平台:Linux(ARM64 和 x64)、macOS(ARM64 和 x64)、Windows(x64);Ruby 2.7 到 3.2

获取

将库作为依赖项添加到 Gemfile*.gemspec

使用

require 'minify_html'

print minify_html("<p>  Hello, world!  </p>", { :keep_spaces_between_attributes => true, :minify_js => true })

所有 Cfg 字段 都可用;如果省略任何字段,则默认为 false

WASM

可能需要 bundler 来使用 WebAssembly 模块,有关更多详细信息,请参阅 此处

使用

import init, {minify} from "@minify-html/wasm";

const encoder = new TextEncoder();
const decoder = new TextDecoder();

await init();

const minified = decoder.decode(minify(encoder.encode("<p>  Hello, world!  </p>"), { keep_spaces_between_attributes: true, keep_comments: true }));

所有 Cfg 字段 都可作为对象提供的第二个参数上的 snake_case 属性使用;如果未设置任何属性,则默认为 false

模板语法

minify-html 能够解析并保留源代码中的 {{/{%/{#<% 语法,允许对大多数引擎(如 Pebble、Mustache、Django、Go、Jinja、Twix、Nunjucks、Handlebars、Sailfish、JSP、EJS 和 ERB)编写的许多 HTML 模板进行压缩。请查找 preserve_*_template_syntax 配置选项。

PHP 块(<?php<?=)也恰好是处理指令,默认情况下会被保留。

请注意,在这些语法中,解析是“愚蠢”的:它将简单地查找下一个与关闭分隔符匹配的字符序列。如果这些块内部有嵌套或字符串文字,可能会导致问题,但这种情况应该很少。

压缩

请注意,某些压缩操作可能会导致生成的 HTML 无法通过验证,但仍然可以由浏览器正确解析和渲染;本质上,利用了浏览器的宽松性以实现更好的压缩。要防止这种情况,请参考以下配置选项

  • do_not_minify_doctype
  • ensure_spec_compliant_unquoted_attribute_values
  • keep_spaces_between_attributes

空白符

minify-html 具有高级上下文感知空白符压缩功能,例如

  • precode 等空白符敏感的元素中保留空白符不变。
  • 在内容标签中修剪和合并空白符,因为空白符在渲染时总是会合并。
  • 在布局标签中删除空白符,这允许使用内联布局同时保持格式化代码。

方法

存在三种空白符压缩方法。当处理文本内容时,minify-html 会根据包含元素选择使用哪些方法。

合并空白符

适用于:空白符敏感 元素之外的所有元素。

将文本节点中的连续空白符序列减少到单个空格(U+0020)。

之前之后
<p>↵
··The·quick·brown·fox↵
··jumps·over·the·lazy↵
··dog.↵
</p>
<p>·The·quick·brown·fox·jumps·over·the·lazy·dog.·</p>
删除整个空白符

适用于:空白符敏感内容内容优先格式化 元素之外的所有元素。

删除任何只包含空白符的文本节点。

之前之后
<ul>↵
··<li>A</li>↵
··<li>B</li>↵
··<li>C</li></ul>
<ul>↵
··<li>A</li><li>B</li><li>C</li></ul>
修剪空白符

适用于:空白符敏感格式化 元素之外的所有元素。

删除任何标签的前导/尾随空白符。

之前之后
<p>↵
··Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup></p>
<p>Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup></p>

元素类型

minify-html 基于标准和最佳实践假设 HTML 和 SVG 元素的使用方式。通过这些假设,它可以应用最优的空白符压缩策略。如果这些假设不成立,请考虑调整 HTML 源文件或关闭空白符压缩。

分组 元素 期望的子元素
格式化 astrong 格式化元素,文本。
内容 h1p 格式化元素,文本。
布局 divul 布局元素,内容元素。
内容优先 labelli 类似于内容,但可能只有一个子元素作为布局。
格式化元素

空白符被压缩。

格式化元素通常是内联元素,它们围绕内容元素中的某些文本,因此其空白符不会被修剪,因为它们可能是内容的一部分。

内容元素

空白符被修剪和压缩。

内容元素通常代表连续的完整内容单元,如段落。因此,空白符很重要,但它们的序列很可能是由格式引起的。

之前
<p>↵
··Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup></p>
之后
<p>Hey,·I·<em>just</em>·found·out·about·this·<strong>cool</strong>·website!·<sup>[1]</sup></p>
布局元素

空白符被修剪和压缩。整个空白符被删除。

这些元素应该只包含其他元素,不包含任何文本。这使得可以移除整个空白字符,这在使用 display: inline-block 时很有用,因为元素之间的空白(例如缩进)不会改变布局和样式。

之前
<ul>↵
··<li>A</li>↵
··<li>B</li>↵
··<li>C</li></ul>
之后
<ul><li>A</li><li>B</li><li>C</li></ul>
内容优先元素

空白符被修剪和压缩。

这些元素通常像内容元素一样使用,但有时会像具有一个子元素的布局元素一样使用。由于可能包含内容,因此不会移除整个空白字符,但在用作布局时是可以接受的,因为只有一个子元素,空白字符会被修剪。

之前
<li>↵
··<article>↵
····<section></section>↵
····<section></section>↵
··</article></li>
之后
<li><article><section></section><section></section></article></li>

标签

移除可选的开启和关闭标签。

属性

解码属性值中的任何实体,然后计算并使用值的最短表示形式。

  • 使用双引号,并编码任何 "
  • 使用单引号,并编码任何 '
  • 未使用引号,如果适用,编码 "/' 的第一个字符,任何 > 和任何空白字符。

属性在解码后(如果可能)修剪和合并空白。

布尔属性 的值被移除。如果值在处理后为空或默认值,则完全移除一些其他属性(即不保留 =)。

具有等于 JavaScript MIME 类型 的值的 script 标签上的 type 属性被移除。

如果属性值在处理后为空,则除了名称之外的所有内容都将被完全移除(即没有 =),因为空属性隐式地与空字符串值的属性相同。

如果可能,移除属性之间的空格。

实体

如果有效并且解码后的长度较短或相等,则解码实体。对具有较短实体表示的 UTF-8 序列进行编码。

不指向有效 Unicode 标量值 的数字实体被替换为 替换字符

尽可能避免编码;例如,只有在后面跟随有效的标签名称字符时,才会编码 <。如果需要,选择最短的实体表示形式。

注释

移除注释。

忽略

感叹号、处理指令 和空元素不会被移除,因为这假设它们的声明有特殊原因。

解析

minify-html 可以处理任何 HTML,优雅地处理所有可能的语法(包括无效的语法),就像浏览器一样。有关更多详细信息,请参阅 Parsing.md

问题和贡献

欢迎 Pull 请求和任何贡献!

如果 minify-html 做了意想不到的事情,误解了一些语法,或者错误地保留/删除了一些代码,请 提出问题 并提供一些相关的代码,以便可以重现和调查问题。

项目详情


发布历史 发布通知 | RSS 源

下载文件

下载适用于您的平台的文件。如果您不确定选择哪一个,请了解有关安装包的更多信息

源代码分发

minify_html-0.15.0.tar.gz (96.9 kB 查看哈希值)

上传时间 源代码

构建分发

minify_html-0.15.0-cp312-none-win_amd64.whl (2.4 MB 查看哈希值)

上传时间 CPython 3.12 Windows x86-64

minify_html-0.15.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB 查看哈希值)

上传时间 CPython 3.12 manylinux: glibc 2.17+ x86-64

minify_html-0.15.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB 查看哈希值)

上传时间 CPython 3.12 manylinux: glibc 2.17+ ARM64

minify_html-0.15.0-cp312-cp312-macosx_11_0_arm64.whl (2.2 MB 查看哈希值)

上传时间 CPython 3.12 macOS 11.0+ ARM64

minify_html-0.15.0-cp312-cp312-macosx_10_12_x86_64.whl (2.3 MB 查看哈希值)

上传时间 CPython 3.12 macOS 10.12+ x86-64

minify_html-0.15.0-cp311-none-win_amd64.whl (2.4 MB 查看哈希值)

上传时间 CPython 3.11 Windows x86-64

minify_html-0.15.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB 查看哈希值)

上传时间 CPython 3.11 manylinux: glibc 2.17+ x86-64

minify_html-0.15.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB 查看哈希值)

上传时间 CPython 3.11 manylinux: glibc 2.17+ ARM64

minify_html-0.15.0-cp311-cp311-macosx_11_0_arm64.whl (2.2 MB 查看哈希值)

上传时间 CPython 3.11 macOS 11.0+ ARM64

minify_html-0.15.0-cp311-cp311-macosx_10_12_x86_64.whl (2.3 MB 查看哈希值)

上传时间 CPython 3.11 macOS 10.12+ x86-64

minify_html-0.15.0-cp310-none-win_amd64.whl (2.4 MB 查看哈希值)

上传时间 CPython 3.10 Windows x86-64

minify_html-0.15.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB 查看哈希值)

上传时间 CPython 3.10 manylinux: glibc 2.17+ x86-64

minify_html-0.15.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB 查看哈希值)

上传时间 CPython 3.10 manylinux: glibc 2.17+ ARM64

minify_html-0.15.0-cp310-cp310-macosx_11_0_arm64.whl (2.2 MB 查看哈希值)

上传时间 CPython 3.10 macOS 11.0+ ARM64

minify_html-0.15.0-cp310-cp310-macosx_10_12_x86_64.whl (2.3 MB 查看哈希值)

上传时间 CPython 3.10 macOS 10.12+ x86-64

minify_html-0.15.0-cp39-none-win_amd64.whl (2.4 MB 查看哈希值)

上传时间 CPython 3.9 Windows x86-64

minify_html-0.15.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB 查看哈希值)

上传时间 CPython 3.9 manylinux: glibc 2.17+ x86-64

minify_html-0.15.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB 查看哈希值)

上传时间 CPython 3.9 manylinux: glibc 2.17+ ARM64

minify_html-0.15.0-cp39-cp39-macosx_11_0_arm64.whl (2.2 MB 查看哈希值)

上传时间 CPython 3.9 macOS 11.0+ ARM64

minify_html-0.15.0-cp39-cp39-macosx_10_12_x86_64.whl (2.3 MB 查看哈希值)

上传时间 CPython 3.9 macOS 10.12+ x86-64

minify_html-0.15.0-cp38-none-win_amd64.whl (2.4 MB 查看哈希值)

上传时间 CPython 3.8 Windows x86-64

minify_html-0.15.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB 查看哈希值)

上传时间 CPython 3.8 manylinux: glibc 2.17+ x86-64

minify_html-0.15.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB 查看哈希值)

上传时间 CPython 3.8 manylinux: glibc 2.17+ ARM64

minify_html-0.15.0-cp38-cp38-macosx_11_0_arm64.whl (2.2 MB 查看哈希值)

上传时间 CPython 3.8 macOS 11.0+ ARM64

minify_html-0.15.0-cp38-cp38-macosx_10_12_x86_64.whl (2.3 MB 查看哈希值)

上传时间 CPython 3.8 macOS 10.12+ x86-64

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面