You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

设置htmlhint的doctype-first为false后所有规则检查失效,求解决办法

HTMLHint 配置问题排查:关闭单个规则后所有检查失效

我刚安装了htmlhint,当前使用的配置文件为.htmlhintrc(注:原描述中.htmlinitrc应为拼写错误),内容如下:

{
  "doctype-first": false
}

由于项目大多由不包含DOCTYPE的引入文件组成,因此关闭了该规则。但问题是,设置该规则后执行npx htmlhint时仅显示已加载.htmlhintrc,却无任何错误报告;不设置该规则时,能正常报告各类其他错误。

以下是解决思路:

  • 确认配置文件名正确性:HTMLHint默认识别.htmlhintrc作为配置文件,若文件名写成.htmlinitrc会导致配置未被正确读取,先检查文件名是否拼写无误。
  • 显式继承推荐规则集:仅单独关闭某条规则时,HTMLHint不会自动启用其他默认规则。可在配置文件中先继承官方推荐规则,再覆盖需要关闭的规则:
{
  "extends": "htmlhint:recommended",
  "doctype-first": false
}
  • 指定检查文件路径:执行命令时明确指定要检查的HTML文件,避免因路径匹配问题导致无文件被检查:
npx htmlhint ./path-to-your-files/*.html
  • 验证配置有效性:临时添加一条明确的规则(比如"tagname-lowercase": true),并创建一个包含大写标签的测试HTML文件,运行检查看是否能触发错误,以此确认配置是否正常生效。

内容的提问来源于stack exchange,提问作者QF0

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.29 15:23:16