PhpStorm对index.html格式化“视而不见”是因为未手动触发、未启用On Save格式化、文件未被识别为HTML类型、被加入忽略列表或.editorconfig冲突；需检查右下角类型标识、Code Style设置及文件排除规则。
PhpStorm 为什么对 index.html 的格式化检查“视而不见”？
默认情况下，PhpStorm 不会主动对 index.html 执行 HTML 格式化检查——它只在你手动触发（如 Ctrl+Alt+L）或启用了「On Save」自动格式化时才工作，且前提是文件被识别为 HTML 类型、未被排除、且编码/行尾设置无冲突。
常见误判场景包括：index.html 被错误标记为 Text 文件类型；项目根目录下存在 .editorconfig 但其中 html 段落缺失或缩进规则写成 indent_style = space 却没配 indent_size；或者该文件被加进了 Settings > Editor > File Types > Ignore files and folders 列表。
- 检查
File > Properties确认 “HTML” 出现在右下角文件类型标签中 - 打开
Settings > Editor > Code Style > HTML，确认Wrap attributes设为Align when multiline或Chop down if long，避免单行过长 - 若用 Prettier，需额外安装插件并设为 HTML 默认格式化工具，否则 PhpStorm 内置引擎不会读取
.prettierrc
Reformat Code 一键整理后，为什么 <script></script> 里的 JS 还是乱的？
PhpStorm 默认只格式化 HTML 结构层，<script></script> 和 <style></style> 块内的代码是否格式化，取决于对应语言的启用状态。即使你在 HTML 设置里勾了 Process HTML content，JS 部分仍需 JS 引擎介入。
- 进入
Settings > Editor > Code Style > JavaScript，确保Enable formatter已勾选 - 回到
Code Style > HTML，确认Other > Process JavaScript in HTML files和Process CSS in HTML files均已启用 - 若
<script></script>含type="module"或使用了 JSX 语法，需在JavaScript version中选ECMAScript 6+，否则缩进和换行可能异常 - 不建议在
<script></script>内写压缩后的内联代码（如onclick="a();b();"），PhpStorm 无法安全换行，易破坏逻辑
保存时自动格式化 index.html，但部分标签被意外“修复”成自闭合，怎么防？
PhpStorm 在格式化时会依据 HTML5 规范自动转换某些标签为自闭合形式（如把 <meta charset="utf-8"> 改成 <meta charset="utf-8">），这虽合法，但某些老旧构建工具或 CMS 模板解析器会报错。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
立即学习“PHP免费学习笔记（深入）”；
根本控制点在 Settings > Editor > Code Style > HTML > Other：
- 取消勾选
Use self-closing tag for empty elements可禁用所有自闭合行为 - 若只想保留特定标签（如
<img alt="利用PhpStorm的格式化检查保持index.html整洁：HTML代码质量" >、<link>）的自闭合，勾选该选项后，在下方Do not indent children of添加area,base,br,col,embed,hr,img,input,keygen,link,meta,param,source,track,wbr—— 这是 HTML5 明确允许自闭合的标签列表 - 注意：修改后需对已打开的
index.html手动执行一次Reformat Code，否则旧格式残留
团队协作中，index.html 格式化结果不一致，根源在哪？
差异几乎都来自本地 .idea/codeStyles/Project.xml 与共享的 .editorconfig 冲突，或成员 PHPStorm 版本跨大版本（如 2022.3 → 2023.3）导致 HTML 解析器升级，对空格/换行的判断逻辑变化。
- 优先以
.editorconfig为准：确保其包含明确的[*.html]段，并定义indent_style、indent_size、end_of_line、charset、trim_trailing_whitespace和insert_final_newline - 禁用项目级代码风格继承：在
Settings > Editor > Code Style页面点击齿轮图标 →Convert Indentation on Save关闭，避免覆盖 .editorconfig - 若用 Git，建议在
.gitattributes中加入*.html text eol=lf，统一行尾，防止 Windows 用户提交CRLF导致 diff 失真
最易被忽略的是：PhpStorm 的 HTML 格式化依赖 DOM 解析器，如果 index.html 开头缺 或混用 XHTML 语法（如 <code><br>），解析器可能降级为宽松模式，导致缩进策略失效——务必从文档类型声明开始检查。
