如何配置AsciidocFX 1.7.4以使用本地安装的最新PlantUML版本

我之前也碰到过一模一样的情况——AsciidocFX默认自带了一个旧版PlantUML Jar包，完全无视本地安装的新版本，咱们可以从这两个方向搞定：

方法一：直接替换内置的PlantUML Jar包（最简便） #

这是最快的解决方案，直接把AsciidocFX自带的旧版替换成你本地的新版：

• 找到AsciidocFX的安装目录：
  • Windows一般在C:\Program Files\AsciidocFX
  • Linux可能在/opt/AsciidocFX
  • macOS右键点击AsciidocFX应用图标，选择「显示包内容」，进入Contents/Java目录
• 在该目录的lib文件夹里，找到形如plantuml-1.2021.2.jar的旧版本Jar文件
• 从你本地PlantUML安装路径里找到plantuml-1.2022.3.jar，也可以直接下载对应版本的Jar文件
• 把旧Jar替换成新的，尽量保持文件名格式一致（比如还是命名为plantuml-1.2022.3.jar）
• 重启AsciidocFX，测试PlantUML图，此时就会使用你替换后的新版本了

方法二：通过启动参数指定本地PlantUML路径（适合不想改动内置文件的情况） #

如果不想碰AsciidocFX的内置文件，可以修改启动脚本的类路径，让程序优先加载本地的PlantUML：

• 找到AsciidocFX的启动脚本：
  • Windows是安装目录下的AsciidocFX.bat
  • Linux/macOS是AsciidocFX.sh（macOS在应用包的Contents/MacOS目录里）
• 编辑脚本，找到Java启动的那一行（类似java -jar AsciidocFX.jar ...）
• 在java后面添加-cp参数，指定本地PlantUML的Jar路径：
  • Linux/macOS示例：

    java -cp "/your/local/path/plantuml-1.2022.3.jar":AsciidocFX.jar com.asciidocfx.Main
    

  • Windows示例：

    java -cp "C:\your\local\path\plantuml-1.2022.3.jar";AsciidocFX.jar com.asciidocfx.Main
    

• 保存脚本后重启AsciidocFX，程序就会优先使用你指定的本地PlantUML版本

验证是否生效 #

重启后，故意写一段旧版不支持的PlantUML语法触发错误提示，看看提示里的PlantUML版本是不是变成1.2022.3，如果是就说明配置成功啦～

内容的提问来源于stack exchange，提问作者Andreas Guther