根本原因是linter框架未安装或未启用，且htmlhint CLI未正确安装或路径配置错误；需先装steelbrain的linter，再全局或项目级安装htmlhint，正确配置路径并关闭“Lint JavaScript in Script Tags”，最后添加.json格式的.htmlhintrc规则文件。

为什么装了 linter-htmlhint 却不报错？

根本原因不是插件没装上，而是 linter 框架本身没装或没启用——linter-htmlhint 只是“检查器”，它依赖 linter 提供的接口才能把错误画出来。没这个基础框架，插件压根注册不上。

• 先确认是否已安装并启用 linter（作者必须是 steelbrain），否则所有 linter-xxx 插件都无效
• linter-htmlhint 不自带 HTML 解析引擎，它调用的是本地全局或项目级的 htmlhint CLI；如果没装，会静默失败，控制台可能只显示 Failed to spawn htmlhint
• Windows 用户常见 PATH 问题：GUI 启动的 Atom 找不到全局 htmlhint，建议终端执行 atom --new-window 启动，继承 shell 环境

怎么装 htmlhint CLI 并让 linter-htmlhint 找到它？

linter-htmlhint 插件本身不带校验逻辑，它只是包装器，必须靠外部 htmlhint 命令行工具干活。装错位置或路径不对，就完全不触发。

• 全局安装（推荐初学者）：npm install -g htmlhint，然后在 linter-htmlhint 设置页填 htmlhint（不带路径）
• 项目级安装（更稳妥）：npm install htmlhint --save-dev，设置页填 node_modules/.bin/htmlhint（Mac/Linux）或 node_modules\.bin\htmlhint.cmd（Windows）
• 验证是否可用：终端运行 htmlhint --version，有输出才说明 CLI 可用

HTML 文件打开就卡顿或报 Unexpected token？

这是 linter-htmlhint 默认把 .html 当 JS 解析导致的典型错误，尤其遇到 <script> 块里的模板字符串、Vue/React 语法时直接崩溃。

html-deploy

使用 htmlcode.fun 将 HTML 内容或文件部署到网页，适用于用户要求“部署到网页”“托管此 HTML”“生成此前端...的实时链接”等场景。

下载

• 进 linter-htmlhint 设置页，关闭 Lint JavaScript in Script Tags（默认开启，但极易误报）
• 如果项目含大量注释、条件注释（<!--[if IE]>）或内联 CSS/JS，建议改用 emerald-html 配合 linter + linter-ui-default，它对 HTML 结构解析更鲁棒
• 大文件（>500 行）容易假死，可临时禁用 linter-htmlhint，或改用命令行 npx htmlhint src/*.html 手动跑一次

如何让 htmlhint 规则生效而不是只报基础语法？

linter-htmlhint 默认只启用极简规则集（比如标签闭合、属性引号），想查语义化、无障碍、SEO 等高级项，必须手动配 .htmlhintrc。

立即学习“前端免费学习笔记（深入）”；

• 项目根目录新建 .htmlhintrc，内容示例：

  {
    "tagname-lowercase": true,
    "attr-lowercase": true,
    "attr-value-double-quotes": true,
    "doctype-first": true,
    "id-unique": true
  }

• 规则名必须和 HTMLHint 官方规则列表 完全一致，拼错或大小写不对就忽略
• Atom 不支持 .htmlhintrc.js，只认 JSON 或 YAML 格式；若用 VS Code 迁移配置，记得转成 JSON

真正卡住人的地方，往往不是插件装没装，而是 htmlhint CLI 路径填错、规则文件放错位置，或者 linter 框架根本没启。尤其 Win10 上 GUI 启动 Atom 时，npm global 的 bin 目录常不在 PATH 里——这点不验证，后面所有配置都是白忙。