Java程序main方法的String[] args是唯一标准入口参数，JVM仅按空格分割命令行参数且不解析引号、通配符或等号，需手动或借助picocli等库解析。
main 方法的 String[] args 是唯一标准入口参数
Java 程序启动时，JVM 只会把命令行中 java 命令之后、类名之后的所有内容，以空格为分隔，原样塞进 main(String[] args) 的 args 数组里——不解析引号、不展开通配符、不处理等号。这意味着 java MyApp -f config.json --debug true 会被拆成 ["-f", "config.json", "--debug", "true"]，而非自动识别为键值对。
常见错误是误以为 args 支持类似 Python 的 argparse 或 Node.js 的 yargs 行为。它只是字符串切片，连短选项合并（如 -abc）都不支持，必须手动解析。
- 带空格的参数必须用英文双引号包裹：
java MyApp "hello world"→args[0] == "hello world" - 反斜杠转义在 shell 层生效，JVM 不处理；Windows 下路径建议用正斜杠或双反斜杠：
"C:\conf\app.properties"或"C:/conf/app.properties" - 如果参数本身含双引号，需由 shell 转义，例如 bash 中写成
java MyApp '"quoted value"'
需要结构化参数时，必须引入第三方库或手写解析逻辑
直接操作 args 数组写 if-else 判断选项，容易出错且难以维护。生产项目几乎都依赖成熟库，其中 picocli 是目前最推荐的选择：零依赖、支持注解、自动生成帮助文本、兼容子命令和 Shell 自动补全。
对比其他方案：
立即学习“Java免费学习笔记（深入）”；
-
Apache Commons CLI：老但稳定，API 略冗长，不支持自动帮助格式化 -
JCommander：注解驱动，但已多年未更新，泛型支持有问题 - 纯手写：适合极简场景（如仅 1–2 个布尔开关），但一旦加参数就迅速失控
import picocli.CommandLine;
import picocli.CommandLine.Option;
public class MyApp implements Runnable {
@Option(names = {"-f", "--file"}, required = true)
String configFile;
@Option(names = {"--debug"}, defaultValue = "false")
boolean debug;
public void run() {
System.out.println("Config: " + configFile + ", Debug: " + debug);
}
public static void main(String[] args) {
new CommandLine(new MyApp()).execute(args);
}
}
系统属性（-Dkey=value）和环境变量是补充手段，不是命令行参数
很多人混淆 java -Dport=8080 MyApp 中的 -D 和 args。这是 JVM 启动参数，通过 System.getProperty("port") 读取，不属于 args 数组。它适合配置全局行为（如日志级别、编码），但不适合业务级输入（如文件路径、用户 ID）。
环境变量则完全独立于 JVM 启动过程，用 System.getenv("HOME") 获取。它的优势是无需修改启动命令即可切换配置，劣势是无法被 picocli 等工具统一管理，也缺乏类型校验。
-
-D参数优先级高于环境变量，但低于显式传入的args（需代码里自己约定覆盖逻辑） - 敏感信息（如密码）不应放在
-D或命令行中，因可能被ps或进程列表泄露 - Docker 场景下，常用
ENV+ARG配合-D实现多环境注入
IDE 运行配置和构建工具传参容易漏掉引号或空格处理
IntelliJ / Eclipse 的「Program arguments」框看似直观，但粘贴含空格或特殊字符的参数时，IDE 不会自动加引号。比如填入 -f /path/to my.conf，实际传给程序的是三个字符串：["-f", "/path/to", "my.conf"]，而非预期的两个。
Maven 执行时也类似：mvn exec:java -Dexec.args="-f config.json"，这里的 -Dexec.args 是 Maven 属性，最终由 exec-maven-plugin 拆解并转给 JVM，中间多了一层解析，引号易丢失。
- IDE 中建议对每个含空格参数单独用英文双引号包裹：
"-f" "/path/to my.conf" - Maven 推荐改用
exec:exec并配合<arguments>XML 配置，避免 shell 层干扰 - CI/CD 脚本中，始终用
"$@"（bash）或${@Q}（zsh）安全传递全部参数
echo 或日志打印原始 args 内容验证。 
