cssstats cli报“cannot find module ‘postcss’”是因为该工具依赖postcss但未自动安装，需手动全局安装postcss及对应语法插件（如postcss-less），且不支持多文件直接输入，须用脚本遍历或合并处理。
用 CSSStats 分析样式表重复率时，cssstats CLI 为什么总报 Cannot find module 'postcss'
因为 cssstats 是基于 PostCSS 构建的老工具（2016 年后基本停更），默认不自带依赖，必须手动安装 postcss 和 postcss-less（或 postcss-scss）才能解析对应语法。
- 只运行
npm install -g cssstats不够，必须补装：npm install -g postcss postcss-less（用 Less 的项目） - SCSS 项目要换
postcss-scss，且需在命令中显式指定：cssstats --parser postcss-scss style.scss - 如果样式表含
@import或自定义函数（如color-mod()），PostCSS 插件缺失会导致解析中断，错误可能静默吞掉部分规则，让重复率统计偏低
cssstats 输出的 rules 和 declarations 数值到底代表什么
这两个是核心复杂度指标，但含义常被误解：rules 是 CSS 规则块数量（即有多少个 {...}），不是选择器个数；declarations 是所有 Property: value; 声明的总数，含重复声明。
- 比如
.btn { color: red; border: 1px solid red; } .link { color: red; }→rules: 2，declarations: 4 -
specificityAvg值偏高（如 > 15）通常意味着大量 ID 选择器或深层嵌套，但cssstats不区分嵌套层级，只算最终 specificity 值，所以它对 SCSS/Less 编译后 CSS 更准，对源码分析意义有限 - 重复率靠
declarationCount（每个属性出现次数）推算，但它不识别语义等价，margin: 0 10px和margin: 0 10px 0 10px被视为两条不同声明
想批量分析多个 CSS 文件，cssstats 却只接受单文件输入
它原生不支持 glob 或目录递归，强行传入 css/*.css 会报错 ENOTDIR。必须靠 shell 脚本或 Node.js 脚本驱动。
- 简单方案（unix/macos）：
for f in css/*.css; do echo "== $f =="; cssstats "$f" | grep -E "(rules|declarations|specificityAvg)"; done - windows 用户用 PowerShell：
Get-ChildItem css*.css | foreach-Object { Write-Host "== $($_.Name) =="; cssstats $_.FullName | select-String "rules|declarations|specificityAvg" } - 注意：每次调用都重新初始化 PostCSS，大项目（>100 个文件）会明显变慢；建议先合并再分析，用
cat css/*.css > all.css && cssstats all.css，但会丢失单文件维度数据
替代方案比 cssstats 更靠谱吗
是的，cssstats 已无法处理现代 CSS 特性（如 @layer、容器查询、CSS Nesting），且无维护。真正需要审计时，应优先考虑：
立即学习“前端免费学习笔记（深入）”；
-
css-tree+ 自定义脚本：可精确遍历 AST，识别嵌套、作用域、重复声明（包括缩写/展开等价），但需写 20 行以上 JS -
stylelint配合stylelint-no-unused-selectors和stylelint-declaration-block-no-duplicate-properties：能定位具体重复行，但不输出全局统计数字 - 浏览器 DevTools 的 Coverage Tab：实时看未使用 CSS 比例，适合运行时验证，而非构建时审计
真正卡点不在工具选型，而在「重复」的定义——是字面相同？计算后值相同？还是视觉效果相同？cssstats 只做字面计数，这点从一开始就没打算解决。