main方法必须声明为public static void,JVM仅识别该签名;Maven标准结构简化构建;推荐用Commons CLI解析参数;需显式用System.exit控制退出码。

main 方法必须声明为 public static void
命令行工具的入口就是 main 方法,JVM 只认这个签名。写成 private static void main(String[] args) 或漏掉 static 都会报错 java.lang.NoSuchMethodError: main。
- 必须是
public:JVM 要从外部调用它 - 必须是
static:不依赖实例就能启动 - 参数名可以不是
args,但类型必须是String[](或String...) - 返回类型必须是
void;返回int不会被识别为入口
项目结构用 Maven 标准布局最省事
不用手动管理 classpath 或 jar 依赖,Maven 默认结构让编译、打包、运行一气呵成。
-
src/main/java/放所有源码,比如com.example.cli.CliApp -
src/main/resources/放配置文件、提示文案等非代码资源 -
pom.xml里加maven-jar-plugin并配置Main-Class,才能用java -jar xxx.jar直接运行 - 如果跳过 Maven,手写
javac和java -cp容易漏掉依赖路径,尤其用了 Apache Commons CLI 这类库时
解析命令行参数别硬写 if-else,用 Commons CLI 更可靠
自己用 args 数组做字符串切分,很快会遇到空格、引号、短选项连写(如 -abc)、长选项带值(--output=file.txt)等边界问题。
- 引入
commons-cli依赖后,用Options+DefaultParser+CommandLine三步就搞定解析 - 支持自动打印帮助(
parser.printHelp(...)),还能校验必填项、类型转换(如把--port=8080转成int) - 注意:
DefaultParser不处理--之后的非选项参数,要透传给业务逻辑时得手动截取cmd.getArgList()
退出状态码要用 System.exit(int) 显式控制
Java 程序默认成功退出是 0,但没显式调用 System.exit(1) 的异常崩溃,可能返回随机负数(如 -1 或 -6),导致 shell 脚本里 if [ $? -eq 1 ] 判断失效。
立即学习“Java免费学习笔记(深入)”;
- 正常结束:不用写
System.exit(0),main 返回即隐式成功 - 错误退出:捕获异常后,统一用
System.exit(1)(或按 POSIX 习惯,1–125 表示错误,126+ 留给系统保留) - 避免在 finally 块里调用
System.exit,否则 try 中的 return 会被忽略 - 单元测试里不要真调
System.exit,可用SecurityManager拦截或改用SystemExitSecurityManager类模拟










