linter-csslint无法正常工作是因为其依赖的csslint项目已冻结开发，npm包废弃且与Node.js 14+不兼容，内部使用过时的glob v5和esprima v1.x导致ERR_REQUIRE_ESM错误，加之Atom终止支持加剧兼容性问题。
Atom 的 linter-csslint 插件早已停止维护，官方仓库在 2020 年归档，npm 包也标记为 deprecated。直接安装或更新会失败，强行启用可能报 csslint is not found 或 Failed to spawn csslint 错误——这不是配置问题，是底层依赖已失效。
为什么 linter-csslint 现在无法正常工作
该插件依赖全局安装的 csslint CLI 工具，而原项目（github.com/CSSLint/csslint）已冻结开发，csslint npm 包自 v1.0.5 起不再发布新版本，且与 Node.js 14+ 兼容性差；Atom 本身也于 2022 年终止支持，Electron 版本滞后导致现代 npm 模块加载失败。
-
csslint内部使用已废弃的globv5 和esprimav1.x，会在 Node.js ≥14 下抛ERR_REQUIRE_ESM - Atom 的
atom-package-deps机制无法自动降级安装兼容版本 - 即使手动
npm install -g csslint@1.0.5，也可能因权限、PATH 或 Atom 运行环境路径隔离而找不到命令
替代方案：用 stylelint + atom-ide-ui 实现等效功能
推荐切换到仍在活跃维护的 stylelint，它支持现代 CSS 语法（如自定义属性、嵌套、@layer）、可配置兼容性目标（如 IE11），且 Atom 可通过 atom-ide-ui + linter-stylelint 集成。
- 先卸载旧插件：
apm uninstall linter-csslint - 全局安装
stylelint：npm install -g stylelint@15（v15 支持 Node.js 16–20） - 安装 Atom 插件：
apm install linter-stylelint atom-ide-ui - 在项目根目录添加
.stylelintrc.json，例如指定兼容 IE11：
{
"extends": ["stylelint-config-standard"],
"rules": {
"at-rule-no-unknown": [true, { "ignoreAtRules": ["extend", "include"] }],
"no-descending-specificity": null,
"property-no-unknown": { "ignoreProperties": ["-ms-transform"] }
}
}
注意：linter-stylelint 默认只 lint .css 文件，若需检查 .scss 或 .vue 中的样式块，需额外配置 stylelint.config.js 并启用 customSyntax。
立即学习“前端免费学习笔记（深入）”；
常见报错与绕过技巧
如果必须保留 linter-csslint（如遗留项目强依赖其特定规则），可尝试极简回退方案，但仅限 Node.js ≤12 环境：
- 用
nvm切换到 Node.js 12：nvm use 12 - 强制安装旧版：
npm install -g csslint@0.10.0 - 在 Atom 设置中手动填写
Executable Path为$(which csslint)的绝对路径（如/Users/xxx/.nvm/versions/node/v12.22.12/bin/csslint） - 禁用所有非必需规则，因部分规则（如
box-sizing）在新版浏览器中已过时，反而干扰判断
这个路径容易写错，且每次 nvm 切换后需重新填；which csslint 在 macOS/Linux 有效，Windows 需用 where csslint 并转为正斜杠路径。
真正影响 CSS 质量的不是 lint 工具名字，而是规则集是否匹配你的目标环境。用 stylelint 配 stylelint-config-recommended 加 stylelint-no-unsupported-browser-features 插件，比硬扛已死的 csslint 更省时间、更准——尤其当你需要检查 gap 是否在 Safari 14.1 中可用这类细节时。
