phpstorm 中 html 格式化需单独配置且不随 php 设置联动：路径为 settings → editor → code style → html；保存时自动格式化须在 tools → actions on save 中为 html 单独启用；关键设置包括右边界、属性换行对齐、保留手动换行及空格规则；失效常见于文件类型识别错误、.editorconfig 覆盖或光标位于 script/style 块内；团队统一推荐结合 .editorconfig（基础规则）与 ide 设置（高级排版）。
PhpStorm 默认对 index.html 文件启用 HTML 格式化，但**不会自动保存时格式化**，必须手动开启触发开关；且 HTML 的规则独立于 PHP，不能复用 PHP 的 Code Style 设置。
HTML 格式化规则在哪配
HTML 的格式化配置和 PHP 是分开的，路径固定：
- Windows/Linux：
File → Settings → Editor → Code Style → HTML - macOS：
PhpStorm → Preferences → Editor → Code Style → HTML
别去 Code Style → PHP 或 General 里找——那里改了对 HTML 文件完全无效。
关键设置项建议：
-
Ensure right margin is not exceeded：勾选，设为120（或团队约定值），避免单行过长 -
Wrap attributes：选Align when multiline，多属性时垂直对齐，可读性更好 -
Keep line breaks：勾选，保留你手动加的换行（比如在<div> 内有意换行），防止格式化“抹平”结构意图 <li> <code>Spaces标签页下，确认Within tag和Before / after = in attribute已启用，保证<img src="a.jpg" alt="b">这类写法空格统一 - 进入
Settings → Tools → Actions on Save - 勾选
Reformat code（不是“Optimize imports”） - 点击右侧齿轮图标 → 确保
HTML在勾选列表中（默认可能只开了 PHP） - 文件后缀不是
.html（比如叫index无后缀），PhpStorm 识别为Text类型，规则不加载 - 右下角状态栏显示的是
Plain Text而非HTML，右键文件 →Override File Type → HTML可修复 - 项目启用了
.editorconfig，其中indent_style或max_line_length会覆盖 PhpStorm 设置，此时改 Settings 无效 - 光标落在
<script></script>或<style></style>块内时，PhpStorm 默认调用 JS/CSS 格式器，而非 HTML 规则——哪怕你在写纯 HTML 结构 - 选中了部分文本（哪怕只一个单词），
Ctrl+Alt+L只格式化选区，且可能因语法边界判断不准导致缩进错乱 - 文件编码含 BOM（尤其 Windows 记事本保存的 UTF-8），解析器异常，格式化退化为仅缩进，不处理属性换行或对齐
- 在项目根目录建
.editorconfig - 写入：
为什么保存 index.html 不自动格式化
因为 PhpStorm 的“保存即格式化”是按文件类型单独控制的，HTML 不共享 PHP 的开关。
必须单独开启：
常见失效原因：
Ctrl+Alt+L 对 index.html 失效的典型场景
快捷键本身有效，但行为受上下文严格限制：
验证是否生效：新建空白 index.html，粘贴一段未缩进的 HTML（如 <div><p>test</p></div>），不选中任何内容，直接按 Ctrl+Alt+L —— 应立刻获得标准缩进与换行。
团队同步 HTML 格式规则最稳的方式
靠人手导出 XML 配置容易漏或版本错，推荐用 .editorconfig 统一底层约束：
root = true
[*.{html,htm}]
indent_style = space
indent_size = 2
max_line_length = 120
trim_trailing_whitespace = true
insert_final_newline = true
这样所有成员只要装了 EditorConfig 插件（PhpStorm 默认启用），打开 index.html 就自动遵循同一套基础规则；IDE 内的 Code Style → HTML 设置只需管更细的样式（如属性对齐），不用操心缩进和换行底线。
注意：.editorconfig 不支持“属性多行对齐”这类高级排版，那部分仍得靠 IDE 设置，且必须确保团队 PhpStorm 版本 ≥ 2022.3，旧版对 Wrap attributes 解析不一致。
