17370845950

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 连基本语法都覆盖不全，花时间调规则不如换掉它。