launch.json的args字段必须是字符串数组，如["--port", "8080"]；F5调试才生效，“Run Java”等快捷方式忽略该配置；mainClass需全限定名且类已编译；参数在main(String[] args)中按索引直接获取，不含程序名。
launch.json 的 args 字段必须是字符串数组
Java 调试时传参只认 launch.json 里 args 字段，而且它必须是合法的 JSON 字符串数组——不是空格拼接的字符串，也不是逗号分隔的单个字符串。
常见错误写法："args": "--port 8080" 或 "args": ["--port,8080"]，这两种都会让参数解析失败，程序收到的 args 是空或错乱的。
-
"args": ["--port", "8080"]✅ 每个参数独立成项，含空格的路径也直接整个写进去："args": ["--config", "./conf/app settings.json"] - 参数本身含双引号（比如 JSON 字符串），需手动转义：
"args": ["--opts", "{\"timeout\":30}"] - 如果参数值以短横线开头（如
-Xmx2g），照常放进数组，VS Code 不会误判为配置项
“Run Java”按钮和右键菜单不读 args
VS Code 内置的 “Run Java” 按钮、右键 “Run Java File”，走的是默认 launch 配置，完全忽略你写的 args。这不是 bug，是设计如此。
想让参数生效，只有两个可靠路径：
- 按
F5启动调试（前提是当前配置在launch.json中已正确定义并选中） - 在 “Run and Debug” 面板顶部下拉菜单里，手动选中你配好
args的那个配置，再点 ▶️
别依赖快捷按钮——哪怕配置名是 Java: Current File，只要没显式选中，args 就不会注入。
确保 mainClass 和 projectName 匹配实际编译输出
Java 调试配置里如果写了 mainClass，它必须和 .class 文件的实际全限定名一致，且该类必须已成功编译。否则调试器启动失败，连参数都碰不到。
常见坑：
- 类在
src目录但没被构建到bin或out输出目录 → 先执行一次Build Project（Ctrl+Shift+B） -
mainClass写成Test，但实际是com.example.Test→ 必须写全名 - 项目用 Maven/Gradle 管理，但没启用 VS Code 的 Java 扩展自动导入 → 检查状态栏是否显示 “Java Projects”，没显示就点击它触发重载
参数在代码里必须从 String[] args 正确读取
即使 launch.json 配对了、调试也启动成功，如果 Java 代码里没在 main 方法签名里声明 String[] args，或者把参数逻辑写在静态块、构造器里，那传进去的参数就等于白给。
务必确认：
- 入口方法是标准形式：
public static void main(String[] args) - 参数解析逻辑放在
main方法体内，而不是靠外部静态变量或延迟初始化 - 使用
args前先判空或用Arrays.toString(args)打印验证，避免因索引越界静默失败
最易忽略的一点：Java 的 args 数组不包含程序名（不像 Python 的 sys.argv），第一个元素就是你传的第一个参数——这点和很多人直觉相反，容易错位读取。
