XML注释是XML文档中用于添加说明性文字的内容，不会被XML解析器执行或输出，主要用于标注代码逻辑、说明模块功能或者临时屏蔽部分代码。XML注释有统一的语法规范，所有符合规范的XML解析器都能正确识别注释内容。
XML注释的标准语法
XML注释的固定格式为<!-- 注释内容 -->，以<!--开头，以-->结尾，中间的内容就是注释的具体内容。需要注意注释内容不能包含--字符串，否则会导致注释提前结束，引发XML解析错误。
基础注释示例
以下是一个简单的XML文件，其中包含标准的XML注释：
<?xml version="1.0" encoding="UTF-8"?>
<!-- 这是整个用户配置文件的注释说明 -->
<user_config>
<!-- 用户基础信息模块 -->
<basic_info>
<name>张三</name>
<age>25</age>
</basic_info>
<!-- 用户权限配置模块 -->
<permission>
<role>admin</role>
</permission>
</user_config>
XML注释的使用限制
XML注释虽然使用灵活，但是存在几个必须遵守的限制，违反这些限制会导致XML文档不符合规范，解析时出现错误：
- 注释不能出现在XML声明之前，XML声明
<?xml version="1.0"?>必须是XML文档的第一行内容。 - 注释内容中不能包含
--字符串，比如<!-- 用户--信息 -->就是错误的写法，会提前结束注释。 - 注释不能嵌套使用，也就是不能在注释内部再写另一个注释，比如
<!-- 外层注释 <!-- 内层注释 --> -->是非法格式。 - 注释不能出现在标签的内部，比如
<name <!-- 注释 -->>张三</name>这种写法是错误的。
XML注释的常见使用场景
标注代码功能
在复杂的XML配置文件中，通过注释说明每个模块的作用，方便后续维护人员理解代码逻辑，比如Spring框架的XML配置文件中经常会用注释标注每个Bean的作用。
临时屏蔽代码
如果需要临时让某部分XML代码不生效，不需要删除代码，只需要用注释包裹这部分内容即可，后续需要恢复时去掉注释就可以，比如测试时临时屏蔽某个配置项：
<?xml version="1.0" encoding="UTF-8"?>
<config>
<!-- 临时屏蔽日志配置，测试基础功能
<log_level>DEBUG</log_level>
<log_path>/var/log/app</log_path>
-->
<app_name>测试应用</app_name>
</config>
添加开发说明
可以在注释中说明代码的作者、修改时间、修改原因等信息，方便团队协作时追溯代码变更，比如：
<!--
作者：李四
修改时间：2024年3月
修改原因：新增用户权限配置模块
-->
<permission>
<role>user</role>
</permission>
不同场景下的注释注意事项
如果XML文档中需要包含<、>、&等特殊字符，不需要额外转义，因为注释内容不会被解析器解析，直接写入即可，比如：
<!-- 这里的<test>是示例标签，不会被解析 -->
但是要注意不能写入--，如果确实需要说明包含--的内容，可以用文字描述代替，比如把用户--信息写成用户减减信息或者用户与信息之间的分隔符是双短横线。