格式化

CSS 格式化

CSS 代码格式化、压缩和美化

输入 CSS
格式化结果
格式化结果将显示在这里

什么是 CSS 格式化?

CSS(Cascading Style Sheets)是用于描述网页样式的样式表语言。CSS 格式化工具可以将压缩的 CSS 代码转换为易于阅读的格式,添加适当的缩进和换行,帮助开发者更好地理解和维护样式代码。

功能特点

  • 格式化:美化 CSS 代码结构,提高可读性
  • 压缩:压缩 CSS 代码,移除空白字符,减小文件大小
  • 自定义缩进:支持自定义缩进大小
  • 语法校验:实时检查 CSS 语法错误
  • 压缩率显示:实时显示压缩比例和大小变化
  • 快速复制:一键复制格式化或压缩结果

使用场景

  • 代码审查:格式化 CSS 便于代码审查
  • 样式优化:压缩 CSS 减小文件大小,提升加载速度
  • 文档编写:生成格式化的 CSS 文档
  • 样式调试:格式化后更容易定位样式问题

CSS 格式化工具调用 js-beautify 的 CSS 美化器,把样式表重排成每条声明一行,并按大括号层级缩进,缩进字符固定为空格;另有一条紧凑通道专门折叠空白。适合阅读第三方或构建产物中的压缩 .css,也适合对比同一份规则的两个版本。

重排规则集时究竟改了什么

组件调用的是 js-beautify 的 CSS beautifier,它按 token 与大括号层级逐段重写文本,并不先构建 CSSOM。每条规则另起一行,规则内的声明按所在嵌套层级各占一行;逗号分隔的选择器列表会被拆开,每个选择器独占一行,且逗号后不留空格。每个块最后一条声明结尾的分号会被删掉:color:#fff} 会变成 color: #fff 再跟一个 }。这依然是合法 CSS,但字节已经变了。注释连同位置原样保留;wrap_line_length 固定为 0,不会按行宽折行;indent_char 固定为一个空格,因此不存在制表符输出。

紧凑输出为什么可能比原文更长

这里的「压缩」是把同一个美化器以 indent_size: 0 调用,再套两次正则替换:\s+ 换成一个空格,;\s*} 换成 }。除此之外不动任何字符,所以 .a{color:red} 回来是 .a { color: red },注释照样保留,{ 后面和 : 后面的空格也都还在。一份 127 字符的压缩样式因此变成 143 字符,算出来的压缩率是负数,而界面上的压缩率标签只在大于 0 时渲染,于是直接不显示。又因为 \s+ 是全文替换,它会作用到引号内部,把 content 字符串里连续的空格或制表符压成一个空格。

真正的 CSS 压缩器会做、而这里不做的步骤

生产环境用的压缩器会解析声明再改写 token:#ffffff 缩写成 #fff、0px 写成 0、重复属性合并、简写归并、删除未被引用的规则。这些步骤本工具一项都不执行,也从不调整声明顺序。它忠实保留的是结构,因为缩进只取决于大括号深度:原生嵌套中的 &、@media、@keyframes 都按层级展开而不会被拍平;反过来,少写一个右括号的 .a{color:red 也会「成功」返回,不给出任何提示。把结果当成重排过的文本,而不是校验通过的样式表。

实操示例

把两条规则的按钮样式重排,再走一次紧凑通道

输入
.btn,.btn:focus{display:inline-block;padding:8px 16px;border:1px solid #0d6efd;color:#fff}.btn:focus{outline:2px solid #0d6efd}
输出
.btn,
.btn:focus {
  display: inline-block;
  padding: 8px 16px;
  border: 1px solid #0d6efd;
  color: #fff
}

.btn:focus {
  outline: 2px solid #0d6efd
}

输入是一行 127 个字符,重排后为 11 行、154 个字符,多出来的部分来自缩进、被拆开的选择器列表,以及两条同级规则之间插入的一个空行;每个块末尾的分号则被删除。同一份输入走紧凑通道得到 143 个字符,仍比输入更长,因为 { 与 : 后面的空格并不会被移除。

边界与常见误用

  • 缩进选项只有 1、2、4 个空格三档,默认 2;indent_char 固定为空格,所以原本用制表符缩进的样式表会被整体改成空格。
  • 紧凑通道只折叠空白,127 字符的压缩样式会返回 143 字符;压缩率算成非正数时,界面上的压缩率标签不会显示。
  • 空白折叠同样作用于引号内部,content 字符串里连续的空格或制表符会被压成一个空格,间距敏感的取值不要走紧凑通道。
  • 没有 CSS 解析器,也不做语法校验:少一个右括号或出现未知 at-rule 都会静默重排,因为错误行只在美化库自身抛异常时出现。
  • 格式化在浏览器主线程同步执行,且输入框没有长度上限,多兆字节的样式表会让输入卡顿。

相关工具

一份样式表该丢进这块面板,还是该换工具

情形本页(浏览器里的 js-beautify CSS)真实做法
要看的 CSS 已经在某个页面上跑着得先把规则粘进左边的输入框,样式挂在 CDN 上时还要先去网络面板把它捞出来。DevTools 的 Sources 面板能直接打开同一个文件,点一下 {} 美化按钮就原地重排,连 link 标签引入的也一并处理——规则已经能跑,就没必要走剪贴板。
文件上线前体积真的要降下来「压缩」是同一个美化器配 indent_size: 0 再加两条正则,注释留着,每个冒号后面的空格又补了回来;它给的是可读视图,不是构建步骤。npx csso styles.css -o styles.min.css 会解析声明、改写 token 本身,字符数真正下降靠的是它;一旦数字重要,就该用它。
整个仓库的样式得长成一个样只有 1、2、4 三档,且只输出空格,一次一段粘,没法表达一份共享配置。Prettier 的 --parser css 支持 --use-tabs、任意 --tab-width,并会按 --print-width(默认 80)折行长的取值列表;把 .prettierrc 提交进仓库,各机器才一致,本页只能让一次粘贴自洽。
手上一整个目录的样式,而不只是一段一个输入框、没有文件选择、也不遍历目录,二十个文件就是二十趟复制粘贴。npx js-beautify -r "src/**/*.css" 跑的是同一个引擎,按展开结果原地改写;与这里唯一的差别是默认宽度,CLI 是 4,本页是 2。
想知道到底哪条规则生效了命中同一个元素的两条规则会并排返回,谁被覆盖没有任何标记——文本重排里既没有层叠也没有优先级。DevTools 的 Styles 面板会把被覆盖的声明划掉,并给出最终生效的选择器;规则不生效该去那边查,本页只负责把规则本身摊开给你读。
要证明这次重排没动任何东西只有一块输出区,没有可比对的基线,而每个块末尾被删掉的那个分号是实打实的字节变化。git diff -w 能滤掉缩进,却滤不掉被删掉的末尾 ;;把重排单独提交一次,或者把新旧两版丢进本站 text-diff,再去看你自己那笔改动。

一个具体场景

读一份被压成一行的 3,350 字符 vendor grid 样式

组件库把栅格样式压成一行发出来:3,350 个字符、40 条规则、200 条声明。按默认 2 空格贴进来,出来是 319 行、4,308 个字符——每条声明前多 2 个空格、每个冒号后多 1 个空格,再减去每块结尾被删的 40 个分号。改成 4 空格仍是 319 行,字符数变 4,708,正好多 400;选 1 空格是 4,108。所以档位该对齐仓库已提交的宽度:三档都压不到 3,350 以下,想让样式表更小,该动的不是缩进选择器。

常见问题

格式化后的 CSS 体积变大,影响加载吗?
不影响线上性能:格式化用于开发和调试,部署前用压缩(minify)版本即可,两者互为无损变换。本工具支持展开/紧凑两种输出——开发用展开、构建产物用压缩。
为什么属性顺序被打乱了?
如果开启了排序选项,工具会按属性分类(布局 → 盒模型 → 排版 → 视觉)重排,这是流行的可维护性约定(类似 stylelint-order)。纯格式化模式下属性顺序保持原样。
CSS 嵌套语法(&)能格式化吗?
可以。格式化只处理缩进、换行和空白,不解析属性含义,原生 CSS 嵌套以及 Less、SCSS 的结构都能正常展开;压缩模式会保留嵌套结构不展开。

内容复核: