javac -d 参数用于按包结构组织字节码文件，指定.class输出根目录并自动创建匹配包路径的子目录；它保障JVM正确加载、分离源码与编译产物、支持类路径运行及jar打包。
javac -d 参数用于指定编译生成的 .class 文件存放的根目录，核心作用是**按包结构组织字节码文件**，而非简单地把所有类扔进一个文件夹。
需要按 Java 包路径生成对应目录结构时
Java 要求类文件必须存放在与包声明匹配的目录层级中。例如源文件 src/com/example/Utils.java 声明了 package com.example;，那么编译后 Utils.class 必须位于 output/com/example/Utils.class 才能被 JVM 正确加载。
此时用 javac -d output src/com/example/Utils.java，编译器会自动创建 output/com/example/ 并把字节码放进去。
构建多模块或大型项目时分离源码与字节码
工程中通常将源码（src/）和编译产物（classes/ 或 build/）分开管理。
使用 -d 可明确指定输出到 build/classes，避免 class 文件污染源码目录，也方便后续打包或清理。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
配合类路径（-cp）运行或依赖其他模块时
当运行程序需引用已编译的类（如 java -cp build/classes Main），这些类必须满足包路径规则。
若不使用 -d，直接编译可能把所有 .class 放在当前目录，导致 JVM 找不到带包名的类（报 NoClassDefFoundError）。
正确做法是：
• 编译时： javac -d build/classes src/com/app/*.java
• 运行时： java -cp build/classes com.app.Main
生成可被 jar 工具直接打包的目录结构
jar 命令期望输入的是符合包路径的目录树。用 -d 输出的结构无需额外整理，可直接压缩：jar -cf app.jar -C build/classes .
这样生成的 jar 内部路径与 Java 类加载机制完全兼容。
不复杂但容易忽略
立即学习“Java免费学习笔记（深入）”；
