git diff 无法直接提取“真正需要编译”的Java文件，因静态分析调用链需结合AST或class索引；实操中应先用git diff --name-only过滤.java文件，再按package兜底或借助javap/Spoon反向查调用方，同时规避绕过Maven导致的Lombok、注解处理器等缺失问题。
git diff 怎么准确提取「真正需要编译」的 Java 文件
直接用 git diff --name-only 很容易漏掉继承链上受影响的类，比如只改了 Utils.java 里的一个 static 方法，但多个 Service 类都调用了它——这些 Service 类不在这次 diff 里，却必须重新编译。
实操建议：
- 优先用
git diff --name-only HEAD^ HEAD获取本次提交变更文件，再过滤出*.java后缀 - 对每个变更的
.java文件，用javap -s或 AST 解析（如 Spoon）提取其 public 方法签名，反向查所有调用该签名的类（需已有全量编译产物或 classpath 索引） - 若无调用链分析能力，保守策略是：把变更类所在 package 下所有
.java文件加入编译队列（避免漏编，代价可控） - 注意排除
test/、resources/目录下的文件，它们不参与 Java 编译
绕过 Maven 直接调用 javac 的坑在哪
跳过 Maven 虽快，但 javac 不会自动处理依赖、annotation processor、lombok 插件或 module-info.java，容易编译失败或生成错误字节码。
实操建议：
- 必须显式传入完整 classpath：
javac -cp "$(mvn dependency:copy-dependencies -DoutputDirectory=/tmp/deps -Dmdep.stripVersion=true -q -Dsilent=true; echo /tmp/deps/* | tr '\n' ':')" ... - 若项目含
lombok，得加-processor lombok.launch.AnnotationProcessorHider$AnnotationProcessor（版本需匹配） - 遇到
package xxx does not exist，不是路径错，而是没把target/classes加进-cp——增量编译时，未变更类仍需从这里加载 - 禁止使用
-sourcepath指向整个src/main/java，否则会误编译未变更文件，破坏增量语义
retransform 失败报 “attempt to add a method” 怎么解
Java Agent 的 Instrumentation.retransformClasses() 不允许新增/删除方法或字段，只支持修改已有方法体。只要 class 文件结构有变更（哪怕只是加了个 @Deprecated），就会触发这个错误。
实操建议：
- 检查变更类是否用了 Lombok 的
@Data、@Builder等注解——它们会在编译期注入方法，导致 class 结构变化，必须禁用或改用纯手写 getter/setter - 确认
javac编译参数与原构建一致：特别是-target和-source版本，JDK 17 编译的 class 在 JDK 11 运行时 retransform 必然失败 - 避免在变更类中新增
static final常量，JVM 会内联该值，retransform 后旧值仍被缓存 - 最稳妥方式：对含结构变更的类，放弃 retransform，走热替换（如 JRebel）或重启模块
增量部署包里漏文件或路径错怎么办
git diff --name-only 默认输出相对路径，而 git archive 或 xcopy 脚本若没统一根目录，会导致打包时路径断裂，线上解压后找不到 class。
实操建议：
- 始终用
git -C $PROJECT_ROOT diff --name-only $OLD $NEW，确保路径基准一致 - 生成 zip 前先执行
git archive --format=zip --prefix=app/ $COMMIT_ID $(git diff --name-only $OLD $NEW) > update.zip，--prefix强制统一前缀 - Windows 批处理里用
xcopy时，源路径末尾加\（如%src_dir%\），否则xcopy a\b c\d会把 b 当文件名拷，而非目录 - 中文文件名务必提前运行
git config core.quotepath false，否则git diff输出乱码路径，后续脚本无法识别
真实场景里，最难的不是拿到 diff 列表，而是判断“哪些类因间接依赖必须连带编译”。没有调用链分析，就只能靠 package 粒度兜底；有了，又得维护索引一致性。这两头的权衡点，往往比工具链本身更消耗工程精力。
