XML处理指令（PI）是格式的标记，用于向特定处理器传递信息，不改变文档结构；目标名需合法且非“xml”，data由处理器定义；必须位于XML声明后、根元素前，解析器通过target识别并响应。
XML中的处理指令（Processing Instruction，简称PI）是用来向特定应用程序传递处理信息的标记，它不会影响XML文档的结构或内容，只是为解析器或后续处理器提供额外的指导。
处理指令的基本语法
处理指令以 开头，以 ?>结尾，中间包含一个目标（target）和可选的内容（data），格式如下：
其中：
-
target 是一个名称，必须是合法的XML名称（不能是
xml、XML等，大小写敏感），用于标识处理该指令的应用程序或处理器（如php、xslt、xml-stylesheet）； - data 是任意字符串，通常以空格分隔的键值对形式出现，具体格式由目标处理器定义，XML本身不解析它。
常见用途与示例
处理指令最常用于关联样式表或嵌入动态内容：
- 关联CSS样式表：
- 关联XSLT转换：
- 嵌入PHP代码（在支持的环境中）：
（注意：这依赖于服务器配置，并非XML标准行为）
这些PI通常放在XML声明之后、根元素之前，位置很重要——多数处理器只识别文档开头附近的PI。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
使用时的注意事项
处理指令不是XML元素，不能嵌套，也不能出现在元素内部或属性中：
- ✅ 正确位置：XML声明后、根元素前；
- ❌ 错误用法：
<book><?pi data?></book>（位于元素内，多数解析器会报错或忽略）； - ❌ 目标名不能是
xml（如<?xml version="1.0"?>是XML声明，不是PI）； - ⚠️ 处理器是否响应某PI，完全取决于该处理器是否识别对应target——XML规范本身不定义任何PI的含义。
在程序中读取处理指令
主流XML解析器（如Java的DOM/SAX、Python的xml.etree.ElementTree或lxml）通常能识别并暴露PI节点：
- DOM中，PI是
ProcessingInstruction类型的节点，有target和data属性； - SAX中，通过
processingInstruction()回调方法接收； - ElementTree默认忽略PI，需使用
XMLParser(target=...)自定义目标或改用lxml（支持parser.set_element_class()等扩展）。
如果你需要自定义逻辑（比如根据PI切换输出格式），就得在解析阶段主动捕获并处理它们。
基本上就这些。处理指令轻量灵活，但作用范围有限——它只是“提示”，不是指令；能否生效，全看谁在读它。
