咨询XSLT库函数导入替代方案及多文件编译方法

一、当前使用xsl:include的合理性判断 #

对于10个规模小于500行的XSLT文件，用xsl:include是完全合理的：

• 小文件拆分能提升代码可维护性，每个文件专注一类功能，便于单独修改和测试
• xsl:include是XSLT标准规范的导入方式，兼容性好，所有合规的XSLT处理器都支持，无工具适配风险
• 如果觉得繁琐，可通过设置XSLT处理器的基础URI简化路径写法，比如在Saxon中用-s:.指定基础目录，导入时就能用短相对路径

二、Saxon命名空间自动导入的本质 #

你提到的Saxon通过命名空间自动导入，实际是它的扩展函数库或预注册模块机制：

• 这类库要么是Saxon自带的标准扩展（如http://saxon.sf.net/命名空间下的函数），要么是提前通过API注册的自定义扩展（比如实现net.sf.saxon.lib.ExtensionFunctionDefinition）
• 普通自定义XSLT模板/函数无法直接通过命名空间自动导入，仍需用xsl:include/xsl:import

三、合并多个XSLT文件的可行方案 #

1. 静态合并为单个XSLT文件 #

可以用XSLT脚本自动合并所有导入文件，示例脚本如下：

<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:output method="xml" indent="yes"/>
  
  <!-- 替换include指令为目标文件内容 -->
  <xsl:template match="/xsl:stylesheet">
    <xsl:copy>
      <xsl:copy-of select="@*"/>
      <!-- 插入所有include文件的内容 -->
      <xsl:for-each select="xsl:include">
        <xsl:copy-of select="document(@href)/xsl:stylesheet/node()"/>
      </xsl:for-each>
      <!-- 保留原文件除include外的节点 -->
      <xsl:copy-of select="node()[not(self::xsl:include)]"/>
    </xsl:copy>
  </xsl:template>
  
  <!-- 复制其他所有节点 -->
  <xsl:template match="@*|node()">
    <xsl:copy>
      <xsl:copy-of select="@*|node()"/>
    </xsl:copy>
  </xsl:template>
</xsl:stylesheet>

运行该脚本即可生成包含所有依赖的独立XSLT文件，客户端直接引用即可，Saxon能直接加载使用。

2. 编译为Saxon二进制模块（SEF文件） #

Saxon支持将XSLT编译为**SEF（Saxon Executable Format）**二进制文件，这是预编译格式，加载速度更快，便于打包分发：

• 命令行编译示例：

  java -jar saxon-he-12.x.jar -xsl:main.xsl -export:compiled.sef -target:JVM # 若要在JS环境运行，替换-target:JVM为-target:JS
  

• 客户端引用时，直接加载SEF文件即可，Java环境示例代码：

  Processor processor = new Processor(false);
  XsltCompiler compiler = processor.newXsltCompiler();
  XsltExecutable executable = compiler.compile(new File("compiled.sef"));
  

四、简化导入的小技巧 #

如果不想合并文件，还可通过以下方式优化导入体验：

• 将所有库文件放在同一目录，在Saxon中设置模块目录（命令行用-m:./lib，或API中调用setModuleURIResolver），导入时直接用文件名即可
• 按需用xsl:import替代xsl:include：xsl:import支持模板覆盖，适合有层级关系的库；xsl:include是直接合并，适合无冲突的通用工具类

内容的提问来源于stack exchange，提问作者MrD at KookerellaLtd