htmlhint配置文件必须命名为.htmlhintrc且置于项目根目录，仅支持json格式；微前端需按子应用路径分别配置files字段，并在构建输出目录（如dist/）中执行检查。
HTMLHint 配置文件该放哪、怎么命名才生效
HTMLHint 只认 .htmlhintrc 这个文件名，且必须放在项目根目录（即 package.json 所在层级）。它不支持 htmlhint.config.js 或 htmlhint.json 等变体，也不读取子目录下的同名文件。
常见错误现象：配置写好了但规则没生效，大概率是文件名拼错（比如 .htmlhint.rc）、路径不对（放在 src/ 下），或用了 YAML 格式（只支持 JSON）。
- 正确做法：运行
npx htmlhint --init自动生成标准.htmlhintrc - 手动创建时，用纯 JSON 语法，结尾不能有多余逗号
- 如果项目有多个子应用（微前端场景），每个子应用需各自根目录放一份
.htmlhintrc
微前端项目里 HTMLHint 怎么避免跨子应用误报
微前端通常由多个独立构建的 HTML 入口组成（如 app1/index.html、app2/index.html），而默认规则如 id-unique 或 title-require 是按单页逻辑设计的。直接全局扫描会把不同子应用里的重复 id 当成错误。
解决思路不是关规则，而是精准限定作用域：
- 在
.htmlhintrc中用"files"字段显式声明待检路径："files": ["app1/**/*.html", "app2/**/*.html"] - 对共用的公共模板（如基座壳层
shell/index.html），单独配一套更宽松的规则，例如禁用id-unique，但保留doctype-html5和meta-charset-require - CI 脚本中分步执行：
npx htmlhint app1/**/*.html和npx htmlhint app2/**/*.html分开跑，失败时能准确定位到哪个子应用
和 Vite / Webpack 构建流程集成时容易忽略的时机问题
很多人把 HTMLHint 塞进构建命令末尾（如 vite build && npx htmlhint src/**/*.html），结果发现检查的是源码，不是最终产出的 HTML —— 而真正上线前需要验证的是构建后产物（含注入的 script、动态生成的 meta 等）。
如果你了解HTML，CSS和JavaScript，您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造，可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序，然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流，并开始构建应用程序，提供更
关键点在于：HTMLHint 必须作用于构建输出目录中的 HTML 文件，而不是源码。
- Vite 场景：在
vite.config.js的buildEnd钩子中调用execSync('npx htmlhint dist/**/*.html')，确保检查的是dist/下真实生成的文件 - Webpack 场景：用
html-webpack-plugin的afterEmit钩子触发检查，而非emit阶段（后者文件可能未写入磁盘） - 本地开发时别强校验：dev server 期间跳过 HTMLHint，否则保存一次就卡住；只在
build或test脚本里启用
CI 流程中 HTMLHint 报错但没人看，怎么让它真正起作用
GitHub Actions 里加了 npx htmlhint "**/*.html" 却没人处理红标，本质是没把“检查失败”和“阻断合并”绑定起来。默认命令即使报错也不会中断 workflow，除非明确设置 set -e 或捕获 exit code。
实操上最简方案就是让命令本身失败：
- 去掉脚本末尾的
|| echo "HTML检查完成"—— 这句会让失败也变成成功状态 - 用
npx htmlhint . --format=unix输出带行号的格式，方便开发者快速定位 - 若需兼容旧版 HTML（如基座壳层含 legacy IE 注释），在对应子目录下放一个空的
.htmlhintrc，HTMLHint 会自动向上查找并继承规则，但遇到空配置就停止，避免污染
微前端基建里最难的从来不是工具装上，而是让每条规则在正确的上下文里被触发、被响应——尤其当 HTML 分散在多个仓库、多个构建流程中时，路径、时机、作用域这三件事漏掉任何一环，检测就形同虚设。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
