CSS 压缩与格式化:缩小样式表并检查结果
Admin ·
CSS 压缩会移除不必要的文本,并用更短的写法缩减样式表源码。ToolMellow 提供“压缩 CSS”和“美化 CSS”两个操作,分别生成紧凑代码和带有清晰缩进的代码。粘贴样式表或打开本地文本文件后,先检查单独显示的“结果”,再决定是否使用。
请使用已可部署的无嵌套的 CSS。原生嵌套和预处理器语法应先在项目中编译。压缩器会拒绝部分无法安全解析的语法,但处理成功不代表每个属性都有效、每条注释都保留,也不能证明结果在页面中的行为正确。
处理完整样式表,并保留原文件
先用“试用示例”比较两个操作。处理自己的代码时,将样式表粘贴到“输入”,或打开本地样式表。两个操作都读取完整输入;选中一部分文本不会把压缩或美化限制在选区内。
处理成功后,“输入”不变,代码出现在只读的“结果”中。修改输入或处理选项会清除旧结果,因此更改后要再次运行相应操作。用导出或复用的结果替换原文件前,请另存原稿。
- 使用无嵌套的 CSS,并保留原样式表副本。
- 选择保留顶层重要注释,或全部移除注释。
- 首次处理可关闭规则重组,确认取舍后再启用。
- 用“压缩 CSS”生成紧凑代码,用“美化 CSS”生成可读缩进。
- 检查完整结果、必要声明、错误提示及字节数。
- 复制或下载完整结果,再放回实际项目测试。
了解每个操作使用哪些选项
“压缩 CSS”使用注释和规则重组选项。“美化 CSS”使用缩进选项,走单独的格式化流程。因此,压缩的设置不会要求美化器删除注释或合并规则。
初始缩进为 2 个空格,注释选项为保留重要注释,规则重组默认关闭。“自动换行”只改变编辑器显示。这里没有浏览器目标列表、项目扫描或 source map 导出选项。
| 选项或操作 | 此处的值 | 作用 |
|---|---|---|
| 压缩 CSS | 紧凑样式表 | 使用注释与规则重组设置。 |
| 美化 CSS | 可读样式表 | 使用缩进设置。 |
| 缩进 | 2 或 4 个空格;默认 2 | 影响美化缩进,不控制压缩布局。 |
| 压缩时的注释 | 保留重要注释(!)或全部移除 | 重要注释能否保留与位置有关。 |
| 允许重组规则 | 默认关闭 | 启用额外的结构优化步骤。 |
| 自动换行 | 仅显示 | 不会向源码插入换行符。 |
| 结果 | 只读 | 与输入分开接收成功处理的代码。 |
| 大小提示 | UTF-8 字节数和取整百分比 | 结果可能变小,也可能变大。 |
保留重要注释时也要检查位置
默认压缩选项保留写成 /*! ... */ 的顶层注释,普通注释会被移除。规则内部或嵌套块中的重要注释仍可能消失;这个选项不保证保留所有包含声明的注释。
例如,顶层的 /*! attribution */ 可以留下,而放在 .a { ... } 内的同一条注释可能在压缩中丢失。使用结果前,逐项检查每条必要声明。“全部移除”也会删除原本可保留的顶层重要注释。“美化 CSS”采用自己的格式化流程,不使用此删除设置。
关闭重组后,仍会进行不止空白处理的压缩
规则重组默认关闭,但清理和较短写法的替换仍会执行。例如颜色 #ffffff 可变为 #fff,零长度 0px 可变为 0。关闭重组不等于只删除空白。
启用重组可能合并或重新安排规则。在已观察的示例中,启用后 .a{color:red}.b{color:red} 变为 .a,.b{color:red}。请比较结果,并在目标应用中测试样式表;无论开关如何设置,都不保证所有情况下渲染行为相同。
| 情况 | 可采用的起点 | 检查重点 |
|---|---|---|
| 首次处理不熟悉的样式表 | 先关闭重组 | 数值缩写等其他压缩仍会执行。 |
| 重复且可合并的声明 | 试用开启重组 | 优化过程中规则可能合并或移动。 |
| 依赖顺序的覆盖规则 | 保留原文件进行比较 | 在实际项目中检查层叠行为。 |
| 媒体查询和条件规则 | 检查输出中的分组 | 字节数变少不代表兼容性已验证。 |
| 未使用的选择器 | 另用了解项目使用情况的工具 | 此工作区不会扫描页面并据此删除选择器。 |
| 浏览器支持要求 | 使用项目的构建与测试流程 | 这里没有浏览器目标配置。 |
美化便于检查,无法恢复已经丢失的信息
“美化 CSS”用 2 或 4 个空格排版,便于阅读紧凑样式表。输入中已有的普通或重要注释可以保留在格式化输出中。此操作不应用注释删除或规则重组选项。
美化压缩过的文本无法找回被删除的注释、原始空白或原规则组织方式。两个操作都读取“输入”,不会自动读取另一个操作的“结果”。如果确实想美化压缩结果,先点“将结果用作输入”,并另外保留原稿。
压缩前先编译嵌套和预处理器语法
请提供完整且不含嵌套选择器的样式表,而不是只有 color:red;margin:0; 这样的声明片段。使用“压缩 CSS”前,先在所属项目中编译 Sass、Less 和嵌套 CSS。此工作区不会解析导入依赖、展开变量或生成项目打包文件。
两个解析器接受的源码可能不同。例如嵌套选择器 .a{color:red;&:hover{color:blue}} 可以由“美化 CSS”排版,却被“压缩 CSS”拒绝。美化成功不能证明同一份源码支持压缩,也不代表它已经适用于目标浏览器。
拒绝部分语法是为了防止缺失输出,不是全面检查 CSS
压缩器无法安全解析部分规则或声明时,会停止处理,而不是静默丢弃这些源码后返回 CSS。输入仍然保留,不会出现成功的部分结果。请检查源码,必要时把不支持的语法编译为无嵌套的 CSS,再运行操作。
其他输入仍可能被宽松接受。已观察到缺少闭合花括号的输入被补上闭合符,未知属性名或值也可能留在输出中。请阅读本地化错误摘要,并展开可能为英文的原始技术详情。部分解析错误提供行号和列号,但并非每次拒绝都有位置。
把字节节省理解为源码大小比较
大小提示把输入和结果按 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,也不加载样式表引用的资源。
复制或下载完整结果
“复制结果”和“下载”使用完整结果,而非文本框选区或仅可见的行。下载生成名为 toolmellow-result.css 的 UTF-8 文本。剪贴板不可用时,可选中结果文本手动复制。
下载文件包含样式表源码,不打包图片、字体、导入的样式表或 source map。请为 CSS 保留所需资源和项目部署路径,替换原文件前先检查修改。
有明确目的且在上限内时再复用结果
“将结果用作输入”会用限制内的成功结果替换输入,同时清除旧结果,随后需再运行下一步操作。仅生成单独结果不会替换输入,也不会创建一次输入历史修改。
已观察到一个恰好一百万单元的注释输入,在美化时增加末尾换行,生成 1,000,001 个单元。结果仍可完整复制或下载,但复用会被拒绝,且不会删除输入或结果。这不表示导出的文本被截断。
按原文编辑、显示换行与清空各有作用
查找替换作用于输入中的原文,可选择区分大小写。它不接受正则表达式,也不会在整个项目中重命名 CSS 符号。替换内容如 $& 会按原文插入。替换重复的选择器、字符串或 URL 前先检查匹配;已接受的修改会清除旧结果。
“自动换行”改变输入和结果文本框的显示,不向源码插入换行,也不改变复制或下载的 CSS。即使周围界面从右向左排列,代码仍从左向右显示。
撤销与重做在可用历史内覆盖已接受的输入编辑、导入、替换和结果复用,不撤销生成单独结果这件事。“清空”删除输入、结果、查找文本及历史,但保留处理选项和自动换行偏好。清空无法撤销。
本地处理也需要先加载引擎
处理在浏览器 worker 中运行。编辑器保存的是 CSS 文本,不会把它应用到预览页面,因此工作区不获取源码中的图片或字体 URL。这不表示任意输出在别处使用都安全。加载 worker 和引擎资源可能需要网络,本地处理本身不保证首次离线可用。
引擎无法加载时,请保留输入,连接恢复后再运行。取消可以停止待处理任务并保留输入。启动与处理配置的时限为 60 秒,实际完成时间取决于浏览器和源码。请自己另存副本,不要把当前标签页当备份。
在实际使用样式表的项目中测试
把导出样式表与原稿比较,包括必要声明和依赖顺序的规则。使用项目检查流程,并查看 CSS 影响的页面、响应式布局及交互状态。文件更小不能证明这些行为不变。
此工具不会检查 HTML 来判断哪些选择器未使用,不重写部署所需的资源 URL,不选择浏览器目标,也不验证无障碍功能。请把这些项目任务保留在正常构建和审查流程中,将此处的压缩或美化作为一次源码编辑步骤。
常见问题
为什么重要 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 和引擎资源必须先加载。引擎加载失败时,请保留输入,待连接恢复后重试。