VS Code Java 项目调试配置 launch.json-java教程-PHP中文网

在 vs code 中调试 java 项目需正确配置 .vscode/launch.json，推荐通过运行视图齿轮图标自动生成基础配置；须安装 extension pack for java，多模块或 maven/gradle 项目应确保在根目录打开且已编译。

vs code java 项目调试配置 launch.json

在 VS Code 中调试 Java 项目，关键在于正确配置 .vscode/launch.json 文件。它告诉调试器如何启动 JVM、加载类路径、设置参数和连接源码。配置不当会导致“找不到主类”“类路径错误”或“断点不生效”等问题。

确认已安装必要扩展

确保已安装官方 Extension Pack for Java（含 Debugger for Java、Language Support for Java 等）。仅装 Java Extension Pack 就够用，无需手动装单独的调试器插件。可通过 VS Code 扩展市场搜索并启用该合集。

自动生成 launch.json（推荐初学者）

VS Code 支持一键生成基础配置：

Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。

下载

打开一个含 main 方法的 Java 文件（如 App.java）
按 Ctrl+Shift+D（Windows/Linux）或 Cmd+Shift+D（macOS）进入运行视图
点击左上角齿轮图标（“创建 launch.json 文件”）→ 选择 Java 环境 → 选择 Java Program
VS Code 会自动检测主类并生成类似如下内容：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "java",
      "name": "Launch App",
      "request": "launch",
      "mainClass": "com.example.App",
      "projectName": "my-java-project"
    }
  ]
}

常用手动配置项说明

生成后可根据需要补充以下字段：

mainClass：必须指定完整类名（含包名），如 "com.myapp.Main"；若未识别可右键 Java 文件 → “Debug As Java Application” 让 VS Code 自动填入
args：传给 main(String[] args) 的字符串数组，例："args": ["--env=dev", "input.txt"]
vmArgs：JVM 启动参数，如内存设置或调试选项："vmArgs": "-Xmx512m -Dfile.encoding=UTF-8"
classPaths：显式指定类路径（一般不需要，Maven/Gradle 项目由插件自动处理）
sourcePaths：源码路径（多模块项目中用于定位断点源文件）

多模块或 Maven/Gradle 项目注意事项

只要项目根目录有 pom.xml 或 build.gradle，且 Java 插件已正确导入（状态栏右下角显示 JDK 版本和项目名），通常无需修改 launch.json。插件会自动解析依赖和输出路径。若调试时提示“Source not found”，检查：

是否已执行过 mvn compile 或 gradle classes
是否在项目根目录打开 VS Code（而非只打开某个子文件夹）
是否在设置中启用 java.configuration.updateBuildConfiguration 为 interactive 或 always

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南