代码

CSS 压缩与格式化:缩小样式表并检查结果

·

CSS 压缩会移除不必要的文本,并用更短的写法缩减样式表源码。ToolMellow 提供“压缩 CSS”和“美化 CSS”两个操作,分别生成紧凑代码和带有清晰缩进的代码。粘贴样式表或打开本地文本文件后,先检查单独显示的“结果”,再决定是否使用。

请使用已可部署的无嵌套的 CSS。原生嵌套和预处理器语法应先在项目中编译。压缩器会拒绝部分无法安全解析的语法,但处理成功不代表每个属性都有效、每条注释都保留,也不能证明结果在页面中的行为正确。

CSS 压缩与格式化工具

处理完整样式表,并保留原文件

先用“试用示例”比较两个操作。处理自己的代码时,将样式表粘贴到“输入”,或打开本地样式表。两个操作都读取完整输入;选中一部分文本不会把压缩或美化限制在选区内。

处理成功后,“输入”不变,代码出现在只读的“结果”中。修改输入或处理选项会清除旧结果,因此更改后要再次运行相应操作。用导出或复用的结果替换原文件前,请另存原稿。

  • 使用无嵌套的 CSS,并保留原样式表副本。
  • 选择保留顶层重要注释,或全部移除注释。
  • 首次处理可关闭规则重组,确认取舍后再启用。
  • 用“压缩 CSS”生成紧凑代码,用“美化 CSS”生成可读缩进。
  • 检查完整结果、必要声明、错误提示及字节数。
  • 复制或下载完整结果,再放回实际项目测试。

了解每个操作使用哪些选项

“压缩 CSS”使用注释和规则重组选项。“美化 CSS”使用缩进选项,走单独的格式化流程。因此,压缩的设置不会要求美化器删除注释或合并规则。

初始缩进为 2 个空格,注释选项为保留重要注释,规则重组默认关闭。“自动换行”只改变编辑器显示。这里没有浏览器目标列表、项目扫描或 source map 导出选项。

了解每个操作使用哪些选项
选项或操作此处的值作用
压缩 CSS紧凑样式表使用注释与规则重组设置。
美化 CSS可读样式表使用缩进设置。
缩进2 或 4 个空格;默认 2影响美化缩进,不控制压缩布局。
压缩时的注释保留重要注释(!)或全部移除重要注释能否保留与位置有关。
允许重组规则默认关闭启用额外的结构优化步骤。
自动换行仅显示不会向源码插入换行符。
结果只读与输入分开接收成功处理的代码。
大小提示UTF-8 字节数和取整百分比结果可能变小,也可能变大。

CSSO:压缩 API 与压缩选项Prettier 格式化选项

保留重要注释时也要检查位置

默认压缩选项保留写成 /*! ... */ 的顶层注释,普通注释会被移除。规则内部或嵌套块中的重要注释仍可能消失;这个选项不保证保留所有包含声明的注释。

例如,顶层的 /*! attribution */ 可以留下,而放在 .a { ... } 内的同一条注释可能在压缩中丢失。使用结果前,逐项检查每条必要声明。“全部移除”也会删除原本可保留的顶层重要注释。“美化 CSS”采用自己的格式化流程,不使用此删除设置。

CSSO:压缩 API 与压缩选项

关闭重组后,仍会进行不止空白处理的压缩

规则重组默认关闭,但清理和较短写法的替换仍会执行。例如颜色 #ffffff 可变为 #fff,零长度 0px 可变为 0。关闭重组不等于只删除空白。

启用重组可能合并或重新安排规则。在已观察的示例中,启用后 .a{color:red}.b{color:red} 变为 .a,.b{color:red}。请比较结果,并在目标应用中测试样式表;无论开关如何设置,都不保证所有情况下渲染行为相同。

关闭重组后,仍会进行不止空白处理的压缩
情况可采用的起点检查重点
首次处理不熟悉的样式表先关闭重组数值缩写等其他压缩仍会执行。
重复且可合并的声明试用开启重组优化过程中规则可能合并或移动。
依赖顺序的覆盖规则保留原文件进行比较在实际项目中检查层叠行为。
媒体查询和条件规则检查输出中的分组字节数变少不代表兼容性已验证。
未使用的选择器另用了解项目使用情况的工具此工作区不会扫描页面并据此删除选择器。
浏览器支持要求使用项目的构建与测试流程这里没有浏览器目标配置。

CSSO:压缩 API 与压缩选项

美化便于检查,无法恢复已经丢失的信息

“美化 CSS”用 2 或 4 个空格排版,便于阅读紧凑样式表。输入中已有的普通或重要注释可以保留在格式化输出中。此操作不应用注释删除或规则重组选项。

美化压缩过的文本无法找回被删除的注释、原始空白或原规则组织方式。两个操作都读取“输入”,不会自动读取另一个操作的“结果”。如果确实想美化压缩结果,先点“将结果用作输入”,并另外保留原稿。

Prettier 格式化选项

压缩前先编译嵌套和预处理器语法

请提供完整且不含嵌套选择器的样式表,而不是只有 color:red;margin:0; 这样的声明片段。使用“压缩 CSS”前,先在所属项目中编译 Sass、Less 和嵌套 CSS。此工作区不会解析导入依赖、展开变量或生成项目打包文件。

两个解析器接受的源码可能不同。例如嵌套选择器 .a{color:red;&:hover{color:blue}} 可以由“美化 CSS”排版,却被“压缩 CSS”拒绝。美化成功不能证明同一份源码支持压缩,也不代表它已经适用于目标浏览器。

W3C CSS Syntax:错误处理概述

拒绝部分语法是为了防止缺失输出,不是全面检查 CSS

压缩器无法安全解析部分规则或声明时,会停止处理,而不是静默丢弃这些源码后返回 CSS。输入仍然保留,不会出现成功的部分结果。请检查源码,必要时把不支持的语法编译为无嵌套的 CSS,再运行操作。

其他输入仍可能被宽松接受。已观察到缺少闭合花括号的输入被补上闭合符,未知属性名或值也可能留在输出中。请阅读本地化错误摘要,并展开可能为英文的原始技术详情。部分解析错误提供行号和列号,但并非每次拒绝都有位置。

W3C CSS Syntax:错误处理概述

把字节节省理解为源码大小比较

大小提示把输入和结果按 UTF-8 字节比较,显示十进制 B、KB、MB 和取整百分比。这是源码文本的比较,不测量 gzip 或 Brotli 传输大小、页面加载速度或缓存效果。

美化会增加便于阅读的排版,因此大小可能增加。空规则或只有普通注释的输入可以被压缩为空结果。长度为零的成功结果仍可导出;请检查它是否符合预期,而不是只凭数字变小判断成功。

把字节节省理解为源码大小比较
显示信息含义比较的边界
输入字节数当前输入的 UTF-8 大小不同于可见字符数及 UTF-16 输入单位。
结果字节数完整结果的 UTF-8 大小不是压缩后的网络传输量。
减少百分比取整后的字节减少比例不保证页面更快或行为不变。
增加百分比结果包含更多 UTF-8 字节美化后可能出现。
成功的空输出结果中没有源码文本可能来自移除注释或空规则。

文件字节数与解码文本分别受限

输入最多接受 1,000,000 个 UTF-16 代码单元。它不同于 UTF-8 字节数和可见字符数,例如补充平面字符 🌿 占两个 UTF-16 单元。本地文件必须同时满足字节检查和解码文本限制。

输出可能超过独立的输入限制,美化时尤其如此。仍可完整复制或下载;“将结果用作输入”会拒绝超过输入上限的输出,并保留当前输入和结果。

文件字节数与解码文本分别受限
项目上限边界行为
粘贴或处理的输入1,000,000 个 UTF-16 代码单元恰好达到上限可接受;更长文本被拒绝。
本地文件严格小于 4,000,000 字节恰好 4,000,000 字节时,在读取前拒绝。
解码后的文件文本1,000,000 个 UTF-16 代码单元使用 UTF-8 解码后也必须在限制内。
将结果用作输入1,000,000 个 UTF-16 代码单元过大的结果仍可完整导出。
查找文本1,000 个 UTF-16 代码单元按原文查找的文本长度有上限。
替换文本10,000 个 UTF-16 代码单元超过输入上限的修改会被拒绝。
撤销与重做历史最多 20 个旧快照已接受的输入修改共享有限历史。
历史文本总量4,000,000 个 UTF-16 代码单元不含当前输入;旧状态总量受限。

按 UTF-8 文本导入样式表源码

“打开文本文件”把本地源码载入输入。导入器先检查文件字节数,通过文件的文本读取方法以 UTF-8 解码,再检查解码后长度。没有编码选择器;更改文件名、MIME 类型或 CSS 编码声明,都不会选择另一种解码方式。

其他编码的样式表应先用合适的编辑器转为 UTF-8,再导入。这里读取本地文本,不从网址获取样式表,不从 PDF 或 Word 提取 CSS,也不加载样式表引用的资源。

W3C File API:Blob 文本解码

复制或下载完整结果

“复制结果”和“下载”使用完整结果,而非文本框选区或仅可见的行。下载生成名为 toolmellow-result.css 的 UTF-8 文本。剪贴板不可用时,可选中结果文本手动复制。

下载文件包含样式表源码,不打包图片、字体、导入的样式表或 source map。请为 CSS 保留所需资源和项目部署路径,替换原文件前先检查修改。

有明确目的且在上限内时再复用结果

“将结果用作输入”会用限制内的成功结果替换输入,同时清除旧结果,随后需再运行下一步操作。仅生成单独结果不会替换输入,也不会创建一次输入历史修改。

已观察到一个恰好一百万单元的注释输入,在美化时增加末尾换行,生成 1,000,001 个单元。结果仍可完整复制或下载,但复用会被拒绝,且不会删除输入或结果。这不表示导出的文本被截断。

按原文编辑、显示换行与清空各有作用

查找替换作用于输入中的原文,可选择区分大小写。它不接受正则表达式,也不会在整个项目中重命名 CSS 符号。替换内容如 $& 会按原文插入。替换重复的选择器、字符串或 URL 前先检查匹配;已接受的修改会清除旧结果。

“自动换行”改变输入和结果文本框的显示,不向源码插入换行,也不改变复制或下载的 CSS。即使周围界面从右向左排列,代码仍从左向右显示。

撤销与重做在可用历史内覆盖已接受的输入编辑、导入、替换和结果复用,不撤销生成单独结果这件事。“清空”删除输入、结果、查找文本及历史,但保留处理选项和自动换行偏好。清空无法撤销。

本地处理也需要先加载引擎

处理在浏览器 worker 中运行。编辑器保存的是 CSS 文本,不会把它应用到预览页面,因此工作区不获取源码中的图片或字体 URL。这不表示任意输出在别处使用都安全。加载 worker 和引擎资源可能需要网络,本地处理本身不保证首次离线可用。

引擎无法加载时,请保留输入,连接恢复后再运行。取消可以停止待处理任务并保留输入。启动与处理配置的时限为 60 秒,实际完成时间取决于浏览器和源码。请自己另存副本,不要把当前标签页当备份。

Prettier:在浏览器中运行

在实际使用样式表的项目中测试

把导出样式表与原稿比较,包括必要声明和依赖顺序的规则。使用项目检查流程,并查看 CSS 影响的页面、响应式布局及交互状态。文件更小不能证明这些行为不变。

此工具不会检查 HTML 来判断哪些选择器未使用,不重写部署所需的资源 URL,不选择浏览器目标,也不验证无障碍功能。请把这些项目任务保留在正常构建和审查流程中,将此处的压缩或美化作为一次源码编辑步骤。

W3C CSS Syntax:错误处理概述

常见问题

为什么重要 CSS 注释仍会消失?

默认压缩选项保留顶层 /*! ... */ 注释,但规则或嵌套块内部的注释仍可能丢失。使用结果前检查每条必要声明;工具不会替你决定哪些声明必须保留。

关闭重组会禁用所有优化吗?

不会。清理和较短写法的替换仍运行,因此不止空白会改变。重组控制额外的规则合并或重新安排步骤。无论哪种结果都应检查并测试。

注释设置会改变“美化 CSS”吗?

不会。注释删除和规则重组适用于“压缩 CSS”。“美化 CSS”使用单独的格式化流程及 2 或 4 个空格的缩进设置。

美化能恢复原始样式表吗?

不能。它能让紧凑代码易读,但无法恢复已删除的注释、原始空白或规则组织方式。请另存原稿;如需下一步处理当前结果,先将结果用作输入。

为什么小于 4 MB 的 CSS 文件也会被拒绝?

文件必须严格小于 4,000,000 字节,使用 UTF-8 解码后的文本也必须满足独立的 1,000,000 个 UTF-16 单元输入上限。文件字节数合格不代表解码文本一定合格。

能只压缩选中的 CSS 吗?

不能。两个操作都处理完整输入,选区不缩小处理范围。如需单独处理某个完整片段,请把它放在独立输入中。

为什么不能将结果用作输入?

美化时输出可能超过输入上限。结果大于 1,000,000 个 UTF-16 单元时,复用会被拒绝,输入和结果均保留,仍可完整复制或下载。

压缩会验证 CSS 或移除未使用的选择器吗?

不会。它会拒绝部分无法安全解析的语法,但仍可能接受经过恢复的语法、未知属性或无效值。工具不扫描页面或项目的选择器使用情况,请另外使用项目验证和了解使用情况的工具。

清空后可以撤销吗?

不可以。清空会丢弃输入、结果、查找文本和撤销重做历史。普通的已接受输入修改只能在清空前、可用历史范围内撤销。

能压缩原生 CSS 嵌套吗?

请先将嵌套编译为无嵌套的 CSS,再使用“压缩 CSS”。不支持的嵌套规则可能被拒绝。“美化 CSS”可以排版部分嵌套源码,但这不是编译,也不能证明压缩器支持它。

这里会编译 Sass 或 Less 吗?

不会。请使用项目的编译器和配置,然后提供生成的无嵌套的 CSS。工作区不处理项目导入、变量或构建依赖。

字节节省是 gzip 或 Brotli 的节省量吗?

不是。提示比较的是 UTF-8 源码字节数和取整百分比,不测量压缩传输量、缓存或页面加载速度。美化也可能生成更大的结果。

下载包括资源文件或 source map 吗?

不包括。下载把完整结果导出为 UTF-8 文件 toolmellow-result.css,不打包图片、字体、导入的样式表和 source map。

本地处理能立即离线使用吗?

不保证首次离线可用。处理发生在浏览器 worker 中,但页面、worker 和引擎资源必须先加载。引擎加载失败时,请保留输入,待连接恢复后重试。

主要参考资料

动手试试。

相关指南