在 PyCharm 中编辑 HTML 文件时，回车换行后光标缩进位置异常是不少前端开发者会遇到的困扰。按下 Enter 键后，光标有时会直接跳到行首，有时又会保留上一行的缩进而没有根据标签层级自动增加一级。这个问题通常与 PyCharm 对 HTML 文件的缩进策略有关，并且可能被 EditorConfig、代码样式设置或插件干扰。下面从缩进机制和配置层面来分析原因并给出修复方法。
一、问题现象与常见触发条件
当你在 PyCharm 中新建或打开一个 HTML 文件，输入 <div> 后按回车，正常预期是光标自动缩进到下一行并比上一行多一级缩进。实际可能出现三种异常表现：光标顶格到第一列、光标停在上一行相同缩进位置、或者缩进层级跳跃好几格。这些表现会让手写 HTML 结构时频繁手动调整空格或 Tab，降低编码效率。
触发条件往往不是单一因素。常见情况包括项目根目录存在 .editorconfig 文件且其中 indent_size 或 indent_style 与 PyCharm 设置不一致；或者 HTML 文件被错误关联到纯文本类型，导致 IDE 不启用 HTML 智能缩进；还有一些插件如 Prettier、EditorConfig 插件会覆盖默认行为。另一个容易忽略的点是 PyCharm 的 Detect and use existing file indents for editing 选项，当它读取到文件里已有的不规则缩进后，会沿用错误策略。
要准确判断原因，可以先观察回车后光标位置是否在纯文本文件中也异常。如果只有 HTML 文件异常，优先检查文件类型和代码样式；如果所有文件都异常，则可能是全局编辑器设置被修改。后文按从简到繁的顺序排查，基本能覆盖大多数场景。
二、检查并调整 HTML 代码样式与缩进设置
首先打开 PyCharm 的设置窗口，Windows 或 Linux 使用 File → Settings，macOS 使用 PyCharm → Preferences。在左侧导航展开 Editor → Code Style → HTML。这里能看到几个直接影响回车缩进的选项：Indent 下方的 Use tab character、Tab size、Indent 和 Continuation indent。如果 Tab size 与 Indent 不一致，PyCharm 可能会用 Tab 补齐层级但视觉缩进错乱。建议把 Tab size 和 Indent 都设置为 4，并保持 Use tab character 关闭，这样每个缩进层级由 4 个空格组成，行为更稳定。
同一页面中有一个关键开关叫 Smart tabs，当它启用时，PyCharm 会尝试用 Tab 对齐属性位置，容易在 HTML 标签里出现回车后光标定位到奇怪列。对于普通 HTML 编辑，可以关闭 Smart tabs。接着看 Keep indents on empty lines 选项，如果开启，空行也会保留缩进，虽然不影响回车后光标，但会让空行出现多余空格。建议按团队规范决定，一般关闭可减少视觉噪音。
下面这段 HTML 是预期中的正常缩进表现，每个子元素比父元素多一级缩进：
<div>
<p>这是正常缩进的段落</p>
</div>
如果回车后光标出现在 <p> 标签的同一列而不是多缩进 4 个空格，说明自动缩进没有按层级计算。此时继续检查 Editor → General → Smart Keys 下的 HTML 相关设置。确保 Insert closing tag on tag completion 和 Auto-indent on Enter 处于启用状态。Auto-indent on Enter 就是按下回车后自动计算下一行缩进的核心开关。如果它被关闭，回车后光标直接回到行首。展开 Smart Keys 里的 HTML 子项，确认 Adjust indents on paste 和 Indent on Backspace 也可以按需开启。
修改完这些设置后点击 Apply，再回到 HTML 文件测试。如果问题依然存在，不要急着修改更多全局配置，继续检查项目级 EditorConfig 是否覆盖了这些选项。
三、处理 EditorConfig 与项目级配置文件
EditorConfig 是跨编辑器维护代码风格的工具，项目根目录下的 .editorconfig 文件优先级高于 PyCharm 的 Code Style 设置。当 .editorconfig 中为 HTML 文件指定了 indent_size = 2 或者 indent_style = tab，而 PyCharm 界面里设置的是 4 空格，回车后 PyCharm 会按照 EditorConfig 的规则缩进，看起来就像异常。此时不要在 IDE 设置里反复修改，应该直接查看项目根目录是否有 .editorconfig 文件。
一个典型的 .editorconfig 配置如下，它会让所有 HTML 文件使用 2 空格缩进：
root = true [*.html] indent_style = space indent_size = 2
如果你希望 HTML 文件使用 4 空格缩进，可以把 indent_size 改成 4；如果想彻底由 PyCharm 控制，可以在 EditorConfig 插件设置中禁用对 HTML 的覆盖，或在 .editorconfig 中删除对应段落。注意修改 .editorconfig 后需要重新打开文件或执行 File → Reload All from Disk，PyCharm 才会重新读取配置。
另一种情况是项目中有 .idea 目录，里面保存了工作区级代码风格。如果团队成员共用了 .idea 配置，而某份配置把 HTML 缩进改成了异常值，也会影响回车后的光标。可以打开 Editor → Code Style → HTML 页面，右侧有一个 Set from 按钮，尝试从其他语言或预定义风格恢复，但不建议直接删除 .idea 目录，因为里面还有其他重要配置。更稳妥的方式是在设置页面点击 Reset 恢复默认值，再根据项目要求调整。
四、排查插件冲突与重置编辑器状态
PyCharm 插件市场里有许多会参与代码格式化和缩进计算的插件，例如 Prettier、EditorConfig、HTML Tools、Save Actions 等。它们的执行时机有所不同，但都可能在你按下回车时触发格式化或覆盖缩进。判断方法很简单：打开 File → Settings → Plugins，暂时禁用与格式化和 HTML 相关的插件，然后重启 IDE 测试。如果问题消失，逐个启用插件来定位冲突来源。
Prettier 插件的优先级机制值得注意。如果项目中安装了 prettier 依赖并配置了 .prettierrc，同时 PyCharm 启用了 Prettier 插件，那么回车后的缩进可能先由 PyCharm 计算，随后被 Prettier 的 on save 或 on typing 格式化修正，出现光标已经移动但缩进被改写的情况。建议在 Editor → Prettier 设置中关闭 Format on save 或 Run on save for files，只在手动格式化时使用 Prettier。保存操作插件 Save Actions 也可以在保存时重新格式化缩进，要避免同时启用多个格式化工具。
如果以上排查都没有解决问题，可以尝试重置 PyCharm 的编辑器缓存和配置。关闭 PyCharm 后，备份并删除配置目录中的 options 子目录，或者使用 File → Manage IDE Settings → Restore Default Settings 恢复默认设置。恢复前请确认不重要的项目已保存，因为这会清除所有自定义快捷键和外观设置。恢复后重新打开 HTML 文件，输入 <div> 再按回车，一般能恢复正常缩进。此时再逐步恢复之前需要的插件和配置，找到真正影响缩进的那个开关。