VSCode 配置 Java JDK 与 Maven 环境
开发 Java 应用需要配置 JDK 和 Maven 环境,VSCode 通过插件支持可以高效完成相关配置,适用于 Spring Boot、Spring Cloud 和 Dubbo 等框架的开发。
安装 JDK
-
下载 JDK
- 访问 Oracle JDK 或 OpenJDK 下载适用于当前操作系统的版本(推荐 JDK 11 或 17)。
- 安装后验证是否成功:
java -version
-
配置环境变量
- Windows:
- 在系统环境变量中添加
JAVA_HOME(指向 JDK 安装路径)。 - 在
Path中添加%JAVA_HOME%\bin。
- 在系统环境变量中添加
- macOS/Linux:
在~/.bashrc或~/.zshrc中添加:export JAVA_HOME=/path/to/jdk export PATH=$JAVA_HOME/bin:$PATH
- Windows:
安装 Maven
-
下载 Maven
- 从 Apache Maven 下载最新版本并解压。
-
配置环境变量
- Windows:
- 添加
MAVEN_HOME指向 Maven 解压路径,并在Path中添加%MAVEN_HOME%\bin。
- 添加
- macOS/Linux:
在~/.bashrc或~/.zshrc中添加:export MAVEN_HOME=/path/to/maven export PATH=$MAVEN_HOME/bin:$PATH - 验证安装:
mvn -v
- Windows:
-
配置 Maven 本地仓库
- 修改
conf/settings.xml,设置本地仓库路径:<localRepository>/path/to/local/repo</localRepository>
- 修改
VSCode 插件配置
-
安装必要插件
- Java Extension Pack(包含 Java 语言支持、调试器等)。
- Maven for Java(提供 Maven 项目支持)。
- Spring Boot Extension Pack(适用于 Spring Boot 开发)。
-
配置 JDK 路径
- 在 VSCode 设置(
settings.json)中添加:"java.home": "/path/to/jdk"
- 在 VSCode 设置(
-
创建 Maven 项目
- 使用快捷键
Ctrl+Shift+P,输入Maven: Create Maven Project,选择 Spring Boot 或其他模板。
- 使用快捷键
运行与调试
-
启动 Spring Boot 应用
- 打开
src/main/java下的主类,点击Run或Debug按钮。
- 打开
-
调试 Dubbo 服务
- 确保
dubbo-spring-boot-starter依赖已添加,通过@DubboReference注入服务。 - 在
application.yml中配置注册中心地址。
- 确保
-
打包与部署
- 执行以下命令生成可运行 JAR:
mvn clean package - 运行生成的 JAR 文件:
java -jar target/your-app.jar
- 执行以下命令生成可运行 JAR:
常见问题排查
-
JDK 版本不兼容:确保项目
pom.xml中的<java.version>与本地 JDK 一致。 - Maven 依赖下载失败:检查网络或更换镜像源(如阿里云 Maven 镜像)。
- 插件未生效:重启 VSCode 或重新加载 Java 项目。
通过以上步骤,VSCode 可完全支持 Java 开发,包括 Spring Boot、Spring Cloud 和 Dubbo 等框架的构建与调试。