-D 参数设置的是 JVM 系统属性而非操作系统环境变量，通过 System.getProperty() 读取，System.getenv() 无法获取；典型用途包括功能开关、日志级别和配置路径控制，并可与环境变量按优先级 fallback 协同使用。
Java 的 -D 参数不能注入“系统级环境变量”，它设置的是 JVM 系统属性（System Properties），而非操作系统环境变量（Environment Variables）。这两者在 Java 中完全独立：环境变量通过 System.getenv() 读取，系统属性通过 System.getProperty() 读取。
明确区别：-D 设置的是系统属性，不是环境变量
java -Dfeature.enabled=true -Dapp.env=prod MyApp 这类命令，实际是向 JVM 注册键值对到内部的系统属性表中。程序中需用以下方式获取：
-
System.getProperty("feature.enabled")→ 返回"true"（字符串） -
System.getenv("feature.enabled")→ 返回null（根本不存在该环境变量）
如何在代码中用系统属性实现逻辑开关
典型做法是将 -D 参数作为配置开关，在启动时动态控制行为。例如：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 启用/禁用某项新功能：
if (Boolean.parseBoolean(System.getProperty("feature.new-ui", "false"))) { ... } - 切换日志级别：
String level = System.getProperty("log.level", "INFO"); Logger.setLevel(Level.parse(level)); - 指定配置文件路径：
String confPath = System.getProperty("config.path", "conf/app-default.properties");
与环境变量协同使用的建议
若需同时支持两种来源（更灵活），可按优先级 fallback：
立即学习“Java免费学习笔记（深入）”；
- 先查系统属性：
System.getProperty("app.mode") - 未设置则查环境变量：
System.getenv("APP_MODE") - 都未设置则用默认值：
"dev"
示例代码：
String mode = System.getProperty("app.mode", System.getenv("APP_MODE")); if (mode == null) mode = "dev";注意事项和常见陷阱
-
-D键名不支持点号开头或纯数字，推荐用小写字母+点+单词（如cache.ttl.seconds） - 值始终是字符串，布尔/数字需手动转换（注意空指针和格式异常）
- 系统属性在 JVM 启动后不可修改（除非调用
System.setProperty()，但仅限当前进程且不推荐用于开关控制） - Docker 或脚本中传参要注意 shell 转义，比如含空格的值需加引号：
-Dapp.name="My App"
