MacOS下如何安装Saxon 10 HE并通过命令行执行XSLT转换

前置说明 #

你遇到的报错核心由两个问题导致：一是jar包路径引用错误/权限不足，二是Saxon命令的参数格式写错。以下是永久可用的配置方案，配置完成后每次仅需修改XML、XSLT路径即可执行转换：

步骤1：固定存放Saxon jar包 #

• 找一个无权限限制的固定目录存放jar包，推荐在个人用户目录下新建专门的工具目录，比如~/Tools/saxon，将解压得到的saxon-he-10.6.jar移动到该目录下
• 执行权限验证命令，确保文件可被读取：

chmod 644 ~/Tools/saxon/saxon-he-10.6.jar
ls ~/Tools/saxon/saxon-he-10.6.jar

如果上述ls命令正常返回文件路径，说明jar包存放和权限正常

步骤2：验证基础命令可用性 #

先执行完整路径命令测试是否可正常运行，注意将命令中的用户名替换为你自己的实际Mac用户名，同时替换示例中的XSLT、XML路径为你自己的文件路径：

java -jar /Users/你的实际用户名/Tools/saxon/saxon-he-10.6.jar -xsl:/Users/你的实际用户名/Documents/path/to/mystylesheet.xsl -s:/Users/你的实际用户名/Documents/path/to/some.xml

如果命令正常返回转换结果，说明基础配置生效

步骤3：配置别名简化后续使用 #

为了避免每次输入完整的jar包路径，你可以配置全局命令别名：

1. 查看你当前使用的终端shell，执行命令：echo $SHELL
2. 如果返回/bin/bash，编辑配置文件：nano ~/.bash_profile
3. 如果返回/bin/zsh，编辑配置文件：nano ~/.zshrc
4. 在配置文件末尾新增一行，注意替换为你自己的jar包实际绝对路径：

alias saxon='java -jar /Users/你的实际用户名/Tools/saxon/saxon-he-10.6.jar'

5. 按Control+O保存，按Control+X退出编辑器，然后执行命令让配置生效：

• bash用户：source ~/.bash_profile
• zsh用户：source ~/.zshrc

步骤4：日常使用方式 #

配置完成后，你每次执行转换仅需输入简化命令，按需修改文件路径即可：

• 直接输出转换结果到终端：

saxon -xsl:你的XSLT文件绝对路径 -s:你的XML文件绝对路径

• 输出转换结果到指定文件：

saxon -xsl:你的XSLT文件绝对路径 -s:你的XML文件绝对路径 -o:输出文件的绝对路径

常见问题排查 #

• 如果依旧报找不到jar包的错误，检查你写的jar包绝对路径是否正确，路径中如果有空格需要用引号包裹整个路径，或者在空格前加\转义
• 如果报参数错误，检查-xsl:、-s:、-o:前缀是否写完整，不要遗漏前缀直接跟路径

内容的提问来源于stack exchange，提问作者y.arazim