17370845950

Java main方法的args是JVM传入的原始String[]数组，不解析选项语法；需手动或借助库处理短选项、键值对等，如java MyApp -v --port 8080 "log file.txt"得["-v","--port","8080","log file.txt"]。

Java 的 main 方法接收的命令行参数是一个 String[] 数组，它不自动解析选项（如 -h、--output=file.txt），需要手动处理或借助工具库。核心在于理解参数传递机制，并选择合适方式提取和验证。

理解 main 方法的 args 参数

public static void main(String[] args) 中的 args 是 JVM 启动时从命令行传入的、空格分隔的字符串数组（引号内空格会被保留）。例如：

• 运行 java MyApp -v --port 8080 "log file.txt"
• 得到 args = ["-v", "--port", "8080", "log file.txt"]

注意：JVM 不做语法解析，不会识别短选项合并（如 -abc）、键值对绑定或类型转换，这些都需自行实现或依赖库。

手动解析基础参数（适合简单场景）

若参数结构固定且数量少，可用循环 + 字符串判断快速处理：

• 用 for (int i = 0; i 遍历，检查 args[i] 是否为标志（如 "-h"）或选项名（如 "--input"）
• 若选项带值（如 --file data.txt），取 args[i+1]，并确保 i+1
• 用 args[i].startsWith("-") 区分选项与位置参数（如输入文件名）
• 建议提前校验必填参数是否缺失，避免运行时报 ArrayIndexOutOfBoundsException

使用 Apache Commons CLI（推荐中等复杂度）

Apache Commons CLI 是轻量、成熟的命令行解析库，支持 POSIX/GNU 风格语法、自动帮助生成、类型转换和错误提示：

• 添加依赖（Maven）：commons-cli
• 定义 Options 对象，声明选项（如 Option.builder("o").longOpt("output").hasArg().argName("FILE").build()）
• 用 DefaultParser 解析 args 得到 CommandLine
• 调用 cmd.hasOption("o") 或 cmd.getOptionValue("o") 安全获取值
• 调用 new HelpFormatter().printHelp(...) 自动生成帮助信息

选用 Picocli（推荐高灵活性与现代特性）

Picocli 支持注解驱动、子命令、自动补全、颜色化帮助页，且零依赖、单文件可嵌入：

• 用 @Option 注解字段（如 @Option(names = {"-v", "--verbose"}) boolean verbose;）
• 用 @Parameters 接收剩余位置参数（如输入文件列表）
• 主类继承 Runnable 或 Callable，调用 new CommandLine(new MyApp()).parseArgs(args)
• 解析失败时自动打印清晰错误和帮助，无需手动异常处理
• 支持生成 Bash/Zsh 补全脚本、Man page 和 HTML 文档