VSCode 配置 Java 调试环境

安装必要的扩展是配置 Java 调试环境的第一步。确保已安装以下扩展：

• Java Extension Pack：包含开发 Java 所需的工具链（语言支持、调试器、Maven/Gradle 集成等）。
• Spring Boot Extension Pack：提供 Spring Boot 项目的专用支持（如配置文件识别、快速启动）。
• Lombok Annotations Support：若项目使用 Lombok，需安装此扩展以解决编译时注解问题。

验证扩展安装成功后，重启 VSCode 生效。

---

配置 JDK 和项目路径

在 VSCode 设置中指定 JDK 路径。打开 settings.json（快捷键 Ctrl + , 搜索 "settings.json"），添加以下配置：

"java.home": "/path/to/jdk",  // 替换为实际 JDK 安装路径
"java.configuration.runtimes": [
    {
        "name": "JavaSE-17",
        "path": "/path/to/jdk",
        "default": true
    }
]

对于 Maven/Gradle 项目，通过侧边栏的 Java Projects 视图导入项目根目录（含 pom.xml 或 build.gradle 的文件夹）。VSCode 会自动加载依赖。

---

配置调试启动文件

创建或编辑 .vscode/launch.json，根据项目类型添加调试配置：

Spring Boot 项目调试配置

{
    "type": "java",
    "name": "Debug Spring Boot",
    "request": "launch",
    "mainClass": "com.example.MainApplication", // 替换为实际启动类
    "args": "",
    "vmArgs": "-Dspring.profiles.active=dev"
}

Dubbo 项目调试配置
需确保先启动注册中心（如 Zookeeper），然后配置远程调试：

{
    "type": "java",
    "name": "Attach to Dubbo Provider",
    "request": "attach",
    "hostName": "localhost",
    "port": 5005  // 需与 provider 的 JVM 参数匹配
}

---

解决常见问题

Lombok 编译报错
在项目根目录创建 lombok.config 文件，内容为：

lombok.anyConstructor.suppressConstructorProperties=true

依赖冲突导致调试失败
使用 Maven 的 dependency:tree 命令分析冲突，或通过 VSCode 的 Java Dependencies 视图手动排除冲突依赖。

---

调试技巧

• 条件断点：右键点击断点，设置触发条件（如 param.equals("test")）。
• 热部署：Spring Boot DevTools 支持修改代码后自动重启。需在 pom.xml 中添加依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <optional>true</optional>
</dependency>

• 日志跟踪：结合 application.yml 调整日志级别：

logging:
  level:
    root: debug
    org.springframework.web: trace

---

验证调试环境

启动调试（F5），观察控制台输出是否正常。对于 Spring Cloud 项目，确保微服务注册到正确地址。若遇到端口冲突，修改 application.yml 中的 server.port 或通过 vmArgs 动态指定。