如何跨Windows与Linux组织可执行.jar文件？

场景与问题 #

在多用户共用的多个仓库中，存在需要执行.jar文件来实现自动化的脚本。这些仓库不一定是Java项目仓库，具体来说，部分脚本需要在用户本地机器执行类似java -jar plantuml.jar "{repositoryfolder}/reference/model.plantuml" -tsvg的命令，可假设所有机器都已配置好java命令。

问题：是否存在适用于Windows与Linux的标准文件夹路径，能以跨平台方式定位.jar文件？或者是否存在类似Pythonrequirements.txt的依赖定义标准，无需硬编码统一文件夹路径或设置专用环境变量即可安装命令行工具？

一、跨平台标准路径方案 #

没有完全通用的跨Windows/Linux标准文件夹路径能直接无缝定位jar，但可以采用两种实用方式：

• 用户级标准目录：
  • Linux下可使用~/.local/bin或~/.local/share，脚本中用java -jar ~/.local/bin/plantuml.jar调用；Windows对应路径为%USERPROFILE%\.local\bin，脚本写成java -jar %USERPROFILE%\.local\bin\plantuml.jar。这种方式需要脚本做简单的平台判断来替换路径变量，或用跨平台脚本语言（如Python、PowerShell Core）统一解析路径。
  • Windows的%LOCALAPPDATA%（对应AppData\Local）也是用户级标准目录，逻辑上和Linux的~/.local一致，但两者路径语法不同，仍需适配。
• 仓库内本地存放：将jar文件放在仓库固定子目录（如scripts/lib/），脚本用相对路径调用：java -jar ./scripts/lib/plantuml.jar。这种方式无需依赖外部路径，用户克隆仓库后直接可用，缺点是多仓库会重复存储jar，适合体积较小的文件。

二、类似requirements.txt的依赖管理方案 #

以下几种方案可实现无需硬编码路径或环境变量的jar依赖管理：

• Maven Wrapper + 极简pom.xml：即使非Java项目，也可在仓库中添加简单的pom.xml声明依赖（如plantuml），通过Maven Wrapper（mvnw脚本）自动下载jar到本地仓库。脚本中可调用mvnw dependency:copy将jar复制到指定本地目录，再执行java -jar命令。用户无需预先安装Maven，Wrapper会自动处理环境。
• Gradle Wrapper：和Maven Wrapper逻辑类似，用build.gradle声明依赖，通过Gradle Wrapper自动拉取依赖，再通过脚本调用Gradle任务获取jar路径并执行命令。
• 自定义依赖清单脚本：编写轻量脚本（Python/Shell均可），维护类似dependencies.txt的文件，记录jar的下载地址和目标存储路径。脚本运行时自动检查jar是否存在，不存在则自动下载到仓库内固定目录（如./lib），后续命令用相对路径调用即可。
• 系统包管理器安装：若目标jar对应的工具已被系统包管理器收录，Linux下用apt install plantuml、Windows下用Chocolatey执行choco install plantuml，安装后可直接用plantuml命令代替java -jar ...，无需处理jar路径，但需用户预先配置对应包管理器。

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