CSS Lint 已停止维护，其解析器基于2011–2014年旧规范，无法识别现代CSS语法（如自定义属性、calc()空格、嵌套、@layer等），导致大量误报或静默跳过，不建议新项目使用。
CSS Lint 已停止维护，npm install csslint 安装的版本（最新为 1.0.5）不支持现代 CSS 语法（如 calc() 中的空格、自定义属性 --color、嵌套语法、gap、aspect-ratio 等），直接运行会大量报错或静默跳过，**不建议在新项目中启用**。
为什么 CSS Lint 的规则在现代项目里频繁误报
CSS Lint 的解析器基于 2011–2014 年的 CSS2.1/早期 CSS3 规范构建，无法识别：
-
--primary-color被当作非法标识符，触发Unknown property错误 -
width: calc(100% - var(--spacing-md));中的var()和减号空格组合导致解析失败，整条声明被忽略或报Parse error -
@layer、@container、&嵌套等新语法直接不识别，规则引擎跳过检查 - 对
flex、grid相关属性的兼容性判断仍基于 IE10/IE11，与当前浏览器支持现状严重脱节
替代方案：用 stylelint 替代 CSS Lint
stylelint 是当前事实标准，活跃维护、插件丰富、支持 CSS-in-JS 和现代语法。迁移只需三步：
- 执行
npm install --save-dev stylelint stylelint-config-standard - 创建
.stylelintrc.json，内容为：{ "extends": "stylelint-config-standard", "rules": { "no-descending-specificity": null, "declaration-block-trailing-semicolon": "always" } } - 把构建脚本中的
csslint *.css换成npx stylelint "**/*.css" --fix
它能正确解析 clamp()、env()、自定义选择器 @scope，且可通过 stylelint-config-recommended-scss 或 stylelint-config-html 扩展支持更多场景。
立即学习“前端免费学习笔记（深入）”；
如果必须用 CSS Lint（如遗留系统审计）
仅限快速扫描明显错误（如重复 class、未闭合大括号），需主动绕过语法限制：
- 用
csslint --ignore=universal-selector,known-properties,errors关闭易误报规则 - 先用
postcss+postcss-custom-properties预处理，把var(--x)替换为实际值，再喂给 CSS Lint - 禁止对
.module.css或含@layer的文件运行 —— 它们必然解析失败 - 输出格式用
--format=checkstyle，方便集成进旧版 CI，但注意其 XML 结构不包含现代属性位置信息
真正影响代码质量的是可维护性（命名一致性、作用域控制、响应式逻辑分层），不是“是否用了 !important”。工具只是辅助，而 CSS Lint 连基本语法都覆盖不全，花时间调规则不如换掉它。
