命令行界面（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

• 包： https://wilsonl.in/minify-html/deno/0.15.0/index.js
• 绑定： WASM
• 平台：所有

使用

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 项目作为依赖项添加，并使用 pip 或 pipenv 安装。

使用

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-sys 和 magnus
• 平台：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

• 包： @minify-html/wasm
• 绑定： WASM
• 平台：所有

可能需要使用打包器来使用 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。

适用于：除了空白字符敏感元素之外的所有元素。

将文本节点中的空白字符序列缩减为一个空格（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>

空白字符会合并。

格式化元素通常是行内元素，它们围绕内容元素中的一些文本进行包装，因此其空白字符不会被删除，因为它们可能是内容的一部分。

空白字符将被删除并合并。

内容元素通常代表一个连续且完整的单位，例如一段文本。因此，空白字符很重要，但它们的序列很可能是由于格式化引起的。

之前

<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>