Java shebang脚本与单文件运行报错：找不到gomad.MyKotlin的main方法

报错原因 #

1. Java单文件运行模式的局限性：java Main.java这种单文件直接运行的模式（JEP 330），默认要求主类是文件中的第一个无包名顶级类。如果主类带有包声明（比如package gomad;），Java在单文件模式下无法正确解析带包名的主类位置，会误以为要找gomad.MyKotlin类却找不到对应的有效类文件（单文件运行时不会生成包结构的类文件），因此抛出找不到main方法的错误。
2. Shebang脚本的运行逻辑：通过shebang执行脚本时，本质还是调用Java的单文件运行模式，同样受限于上述包名解析问题，无法定位带包名主类的main方法。
3. 编译运行与IntelliJ的正常逻辑：javac gomad/Main.java && java gomad.Main编译后会生成符合包结构的类文件，Java能通过包名正确找到主类；IntelliJ注释shebang后，是按照标准项目结构编译运行，包结构被正确识别，所以不会报错。

无需放弃包名特性的解决办法 #

办法1：单文件运行时明确指定主类全限定名 #

• 修改Shebang行：把脚本开头的shebang改成以下形式，明确指定主类的全限定名：

  #!/usr/bin/env java --source 17 --main-class gomad.MyKotlin
  

  注意替换17为你实际使用的Java版本，gomad.MyKotlin为你的主类全限定名。
• 直接用java命令运行单文件：执行命令时加上--main-class参数指定主类：

  java --source 17 --main-class gomad.MyKotlin Main.java
  

办法2：保持包结构，用编译+运行的方式执行 #

如果习惯这种模式，继续使用javac gomad/Main.java && java gomad.Main命令即可，这种方式不受单文件模式的限制，完全兼容包名特性。

补充说明 #

如果你的主类是Kotlin类（比如错误提示中的gomad.MyKotlin），需要确保Kotlin类编译后生成的字节码包含public static void main(String[] args)方法：可以在Kotlin类的main函数上添加@JvmStatic注解，或者使用fun main(args: Array<String>)的标准入口写法，Kotlin编译器会自动生成对应的Java兼容main方法。

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