Java 命令行参数

学习目标

理解 Java 命令行参数的基本概念与传递机制
掌握如何在 main 方法中接收和处理命令行参数
能够安全地访问参数并避免常见错误（如数组越界）
了解命令行参数在自动化脚本和工具开发中的实际价值

什么是命令行参数？

命令行参数（Command-Line Arguments） 是在运行 Java 程序时，通过终端或命令提示符动态传入的输入值。这些参数会被 JVM 自动封装成一个字符串数组，并传递给程序的 main(String[] args) 方法。

java ClassName arg1 arg2 arg3 ...

其中：

arg1, arg2, ... 是以空格分隔的字符串
JVM 将它们按顺序存入 args[0], args[1], args[2], ...

注意：所有命令行参数在 Java 中始终是字符串类型，即使你输入的是数字（如 123），也需手动转换为 int、double 等类型。

示例 1

打印第一个参数

// 文件：HelloUser.java
public class HelloUser {
    public static void main(String[] args) {
        System.out.println("你好，" + args[0] + "！");
    }
}

编译与运行：

javac HelloUser.java
java HelloUser 张三

输出：

你好，张三！

风险提示：如果未传入任何参数（即 java HelloUser），程序会抛出 ArrayIndexOutOfBoundsException，因为 args 数组为空。

示例 2

安全地处理任意数量的参数

// 文件：ArgPrinter.java
public class ArgPrinter {
    public static void main(String[] args) {
        if (args.length > 0) {
            System.out.println("接收到的命令行参数如下：");
            for (String arg : args) {
                System.out.println("- " + arg);
            }
        } else {
            System.out.println("未提供任何命令行参数。");
        }
    }
}

运行示例：

java ArgPrinter Java Python C++

输出：

接收到的命令行参数如下：
- Java
- Python
- C++

无参数运行：

java ArgPrinter

输出：

未提供任何命令行参数。

最佳实践：始终先检查 args.length 再访问具体元素，避免程序崩溃。

命令行参数原理

用户在终端输入命令，例如：
```
java MyApp config.txt output.log debug
```
操作系统将整个命令传递给 JVM
JVM 解析空格分隔的参数，并创建一个 String[] args 数组：
```
args[0] = "config.txt"
args[1] = "output.log"
args[2] = "debug"
```
JVM 调用 main(String[] args) 方法，传入该数组
程序内部可遍历、解析或使用这些参数

为什么使用命令行参数？

优势	说明
无需修改代码	同一程序可处理不同输入，提高复用性
支持自动化	可被 Shell 脚本、CI/CD 流水线调用
配置灵活	允许指定文件路径、模式开关、环境变量等
轻量高效	无需图形界面或复杂输入机制

实际应用场景

批处理工具：java FileProcessor input.csv output.json
启动模式控制：java Server --port=8080 --debug
测试框架：java TestRunner TestCase1 TestCase2

注意事项

1. 参数包含空格怎么办？

使用引号包裹：

java MyApp "Hello World" "C:\My Documents\file.txt"

此时：

args[0] = "Hello World"
args[1] = "C:\My Documents\file.txt"

2. 数字参数需手动转换

if (args.length >= 1) {
    int number = Integer.parseInt(args[0]); // 字符串转整数
    System.out.println("数值的平方是: " + (number * number));
}

3. 参数数量校验

if (args.length != 2) {
    System.err.println("用法: java Calculator <num1> <num2>");
    System.exit(1); // 非零退出码表示错误
}

重点总结

命令行参数通过 main(String[] args) 传入，类型为 String[]
参数以空格分隔，可用双引号包裹含空格的值
必须检查 args.length 防止 ArrayIndexOutOfBoundsException
所有参数都是字符串，数值需显式转换
广泛用于脚本化、配置化和自动化场景

思考题

如果你在运行 java App "a b" c d，args 数组的内容是什么？长度是多少？
如何设计一个程序，使其既能从命令行参数读取输入，也能在无参数时从控制台交互式读取？
在 DevOps 环境中，为什么命令行参数比硬编码配置更受青睐？请结合持续集成（CI）场景说明。

源本科技 | 码上会

学习目标

什么是命令行参数？

示例 1

示例 2

命令行参数原理

为什么使用命令行参数？

注意事项

1. 参数包含空格怎么办？

2. 数字参数需手动转换

3. 参数数量校验

重点总结

思考题