VSCode中需在launch.json的vmArgs字段配置绝对路径的-javaagent参数，否则premain不会触发；必须确保jar内MANIFEST.MF正确、JDK兼容且无符号链接。
VSCode 里怎么给 Java 项目加 -javaagent 参数？
VSCode 默认不支持直接在 Run 按钮或右键菜单里传 -javaagent，必须通过配置 launch.json 手动注入。光改 java.home 或装插件没用。
常见错误现象：明明写了 -javaagent:myagent.jar，但 agent 的 premain 方法完全没执行，控制台也无输出——大概率是参数根本没进 JVM。
- 打开项目根目录下的
.vscode/launch.json（没有就新建），确保配置类型为java - 在
configurations数组中添加或修改vmArgs字段：{ "type": "java", "request": "launch", "name": "Launch with Agent", "mainClass": "com.example.Main", "projectName": "myproject", "vmArgs": "-javaagent:/path/to/myagent.jar=arg1,arg2" } -
/path/to/myagent.jar必须是绝对路径（Windows 用C:\xxx\myagent.jar，Linux/macOS 用/home/user/.../myagent.jar）；相对路径会被忽略 - 如果 agent 需要读取自身 jar 内资源（比如
META-INF/MANIFEST.MF），vmArgs中的路径必须指向实际 jar 文件，不能是符号链接
为什么 premain 不触发？检查 MANIFEST.MF 和 JDK 兼容性
premain 失效最常因为 MANIFEST.MF 缺失关键属性或 JDK 版本不匹配。VSCode 启动的 JVM 对 MANIFEST 要求比命令行更严格。
典型报错：java.lang.ClassNotFoundException: com.example.MyAgent 或静默失败无日志。
立即学习“Java免费学习笔记（深入）”；
- 确认 jar 包内
META-INF/MANIFEST.MF存在且换行符是jar -tf myagent.jar | grep MANIFEST验证 -
Premain-Class值必须是全限定类名，且该类必须在 jar 的根路径下（如com/example/MyAgent.class），不能在嵌套 jar 或 module-info.class 后面 - JDK 17+ 默认禁用
sun.misc.Unsafe和部分 JVMTI 接口，若 agent 依赖 ASM 或 Byte Buddy 的旧版本（如 ASM 8 以下），需加--add-opens java.base/java.lang=ALL-UNNAMED到vmArgs - VSCode 的 Java 扩展启动 JVM 时可能启用
--illegal-access=deny，导致 agent 反射失败；临时解决可在vmArgs加--illegal-access=warn（仅调试用）
运行期动态 attach agent：VSCode 能否调用 VirtualMachine.attach()？
可以，但不是通过 VSCode 界面操作，而是写 Java 代码调用 Attach API —— 这和 launch.json 静态注入是两条路。适合测试 agent 的 agentmain 方法。
容易踩的坑：Attach 失败常被误判为 agent 问题，其实是权限或进程隔离导致。
- 目标 JVM 必须开启
com.sun.management.jmxremote（默认 JDK 17+ 已关闭），或确保目标进程与 attach 进程同用户、同容器（Docker 内需共享/tmp） - attach 代码必须运行在独立 JVM 中（不能在被测应用内部），例如：
public class AttachTest { public static void main(String[] args) throws Exception { VirtualMachine vm = VirtualMachine.attach("12345"); // PID vm.loadAgent("/absolute/path/to/myagent.jar", "runtime_arg"); vm.detach(); } } - VSCode 调试这个
AttachTest时，要确保它用的 JDK 和目标进程一致（否则attach会抛AttachNotSupportedException） - 不要用
ProcessHandle.current().pid()获取自己 PID 去 attach 自己——JVM 不允许 self-attach
Test Runner for Java 能跑带 agent 的单元测试吗？
不能直接支持。VSCode 的 Test Runner 本质是启动一个独立 JVM 运行 JUnit Platform Launcher，它不继承 launch.json 的 vmArgs，也不会自动加载你配的 agent。
想验证 agent 在测试场景下的行为，得绕过 Test Runner，走真实 JVM 启动流程。
- 写一个含
@Test的类，再写一个普通main方法调用JUnitCore.runClasses(...)，然后对这个main配置 launch.json +vmArgs，才能让 agent 生效 - 如果必须用 Test Runner 界面触发，唯一办法是把 agent 逻辑打包进测试依赖（比如用
byte-buddy-agent的ByteBuddyAgent.install()），并在@BeforeAll中显式安装——但这已脱离-javaagent机制，属于运行时手动注入 - 注意：JUnit 5.10+ 默认使用模块化 classloader，agent 修改的字节码可能被隔离在 unnamed module，导致监控失效；加
--add-opens java.base/java.lang=ALL-UNNAMED和--add-modules ALL-SYSTEM通常能缓解
真正难的不是配参数，而是 agent 修改后的字节码是否被测试类加载器看见——这取决于你用的是 Maven Surefire 还是 Gradle Test，以及它们各自的 fork 策略和 classpath 隔离级别。
