intellij idea 对 xml 注释校验更严格，禁止注释中出现 --、单独 > 或 ]]>，且受 dtd/xsd 约束限制注释位置；ctrl+/ 快捷键易生成非法注释，多行注释需注意换行符兼容性。
XML注释里写了--或>导致IDEA报红
IntelliJ IDEA 对 XML 注释的合法性校验比很多解析器更严格。它会直接拒绝含 --（连续两个短横）、>（单独右尖括号）或 ]]>（非 CDATA 结束位置）的注释，哪怕其他工具能容忍——这不是 bug，是 IDEA 在帮你提前暴露潜在解析失败风险。
常见错误现象：XML document structures must start and end within the same entity 或 Comment not closed 这类提示，其实根本没少写 -->，只是中间混进了非法字符。
- 注释正文里别手滑打
--，比如<!-- 配置项：--开关 -->→ 改成<!-- 配置项：-开关 -> >不能单独出现在注释内，<!-- 大于号 > 表示阈值 -->会触发报错 → 改用>或删掉符号- CData 块外别出现
]]>，哪怕它看起来像“结束”：注释里写<!-- ]]> 是非法的 -->就不行
IDEA 把合法注释也标红，其实是 DTD/XSD 校验在作怪
有时候你确认注释语法完全正确，但 IDEA 仍标黄/标红，大概率不是注释问题，而是当前 XML 文件绑定了 DTD 或 XSD，并且该 Schema 明确禁止注释出现在某些元素下（比如 Spring 的 beans.xsd 规定 <bean></bean> 内部不允许注释）。
使用场景：Spring、MyBatis、Maven 的 pom.xml 等带 schema 的配置文件最常中招。
- 检查右下角状态栏是否显示
DTD或XSD校验已启用；点开它可看到具体绑定路径 - 临时禁用校验：右键文件 →
Validate XML→ 取消勾选Validate using DTD/XSD - 真要保留注释又不想关校验？把注释移到 Schema 允许的位置，比如挪到根元素外、或
<!-- ... -->包裹整个配置块（需 Schema 支持）
Ctrl+/ 快捷注释生成了非法格式
IDEA 默认的 XML 注释快捷键 Ctrl+/（Windows/Linux）或 Cmd+/（macOS）会自动加 --，但它不检查光标所在位置是否允许注释——比如你在属性值中间按了快捷键，就可能切出 <!-- value="<!-- -->" --> 这种嵌套结构，直接破坏 XML 层级。
参数差异：这个快捷键的行为受 Settings → Editor → Code Style → XML → Commenting 控制，但默认不防呆。
- 别在标签内部、属性值里、CDATA 块中用
Ctrl+/ - 手动写注释时，确保
<!--和-->在同一行逻辑层级，前后无标签干扰 - 如果总误触，可在设置里关掉 XML 的
Line comment快捷键，改用纯手工输入
注释跨多行时换行符引发编码/解析歧义
XML 标准规定注释内容里的换行符会被原样保留，但某些老版本解析器（如 JDK 6 的 DOM 解析器）会把 \r\n 当成两个字符处理，导致 --> 被拆开，注释无法闭合。IDEA 检测到这种潜在风险就会预警。
性能影响不大，但兼容性隐患真实存在——尤其你的 XML 要被 Android、旧版 WebLogic 或嵌入式设备读取时。
- 多行注释尽量用 Unix 换行
\n，避免\r\n（检查 IDEA 右下角换行符显示，设为LF） - 不要在注释末尾空格后直接换行，
<!-- abc >\n-->容易被误判 → 改成<!-- abc -->\n - 超长注释建议拆成多个单行注释，比硬撑一个多行更稳妥
真正麻烦的不是语法对不对，而是不同工具对“容忍边界”的定义差得远。IDEA 红着，不代表运行时报错；但等它真不红了，基本就过得了绝大多数生产环境解析器。
