单文件源代码程序shebang长类路径超限的解决办法

核心思路 #

绕开shebang的长度限制，通过间接调用的方式传递超长参数与类路径，避免直接在shebang行写入大量内容。

具体实现方案 #

方案1：Shell脚本中间层（最通用） #

编写一个Shell脚本作为入口，把超长的Java启动参数放在脚本内部执行：

#!/bin/bash
# 这里可以写入任意长度的类路径和参数
java --source 11 -cp "foo.jar:bar.jar:baz.jar:...:andsoon.jar" "$0.java"

将Java代码保存为与脚本同名的.java文件（比如脚本叫myapp.sh，Java文件为myapp.sh.java）；也可以直接把Java代码嵌入脚本末尾，用tail截取执行：

#!/bin/bash
java --source 11 -cp "foo.jar:bar.jar:baz.jar:...:andsoon.jar" <(tail -n +4 "$0")
exit $?
# 以下是Java代码
public class Main {
    public static void main(String[] args) {
        // 业务逻辑代码
    }
}

这种方式完全不受shebang长度限制，适配所有Java版本，且无需额外依赖。

方案2：Java模块（Java 9+） #

如果使用Java 9及以上版本，将依赖整理为模块化JAR，通过module-info.java声明依赖关系，启动时无需手动指定超长类路径：

#!/usr/bin/env -S java --source 11 --module mymodule/com.example.Main

还可以用jlink生成包含依赖的自定义运行时镜像，进一步简化启动命令。

方案3：打包为可执行文件 #

使用Java自带的jpackage（Java 16+），或者第三方工具如launch4j、GraalVM的native-image，将单文件程序与依赖打包成独立可执行文件。用户直接运行生成的二进制文件即可，完全无需关注shebang的问题，还能提升启动速度。

方案优先级推荐 #

1. Shell中间层方案：零额外依赖、快速落地，兼容所有Java版本，是当前场景下的最优选择。
2. Java模块方案：适合长期维护的项目，规范依赖管理，减少启动参数复杂度。
3. 可执行文件打包方案：适合需要分发的应用，用户体验更好，但需要额外的打包步骤。

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