首先安装JDK并配置环境变量,再在VS Code中安装“Extension Pack for Java”,最后创建Java文件运行测试。确保JDK路径无中文或空格,必要时手动设置java.home,等待初始化完成即可正常使用。

在VS Code中搭建Java开发环境并不复杂,只要正确安装JDK并配置必要的扩展,就能快速开始编写和运行Java程序。以下是详细步骤。
安装JDK并配置环境变量
Java开发的前提是系统中已安装JDK(Java Development Kit)。推荐使用LTS版本,如JDK 11或JDK 17。
- 前往Eclipse Adoptium下载对应操作系统的JDK安装包并完成安装。
- 安装完成后,设置环境变量:
-
Windows:在“系统属性 → 高级 → 环境变量”中添加
JAVA_HOME,指向JDK安装路径(如C:\Program Files\Java\jdk-17),并将%JAVA_HOME%\bin加入Path。 -
macOS/Linux:在终端执行
export JAVA_HOME=/path/to/jdk,并把$JAVA_HOME/bin加入PATH,可写入~/.zshrc或~/.bashrc永久生效。
-
Windows:在“系统属性 → 高级 → 环境变量”中添加
- 验证安装:打开终端输入
java -version和javac -version,若显示版本信息则配置成功。
安装VS Code Java扩展包
VS Code本身不支持Java,需通过扩展实现完整功能。
- 打开VS Code,点击左侧活动栏的扩展图标(或按
Ctrl+Shift+X)。 - 搜索“Extension Pack for Java”,这是由Microsoft提供的官方扩展集合,包含以下核心组件:
- Language Support for Java™ by Red Hat:提供语法高亮、代码补全、重构等功能。
- Debugger for Java:支持断点调试。
- Test Runner for Java:运行JUnit测试。
- Maven for Java:项目管理与依赖支持。
- Project Manager for Java:方便切换和管理多个Java项目。
- 点击“Install”一键安装整个扩展包。
创建并运行第一个Java程序
配置完成后,可以立即创建一个简单的Java项目来测试环境是否正常。
立即学习“Java免费学习笔记(深入)”;
- 新建一个文件夹作为项目目录,例如
HelloJava。 - 在VS Code中打开该文件夹。
- 右键资源管理器空白处,选择“New File”,命名为
HelloWorld.java。 - 输入以下代码:
public class HelloWorld { public static void main(String[] args) { System.out.println("Hello, Java in VS Code!"); } } - 保存文件后,点击右上角的“Run”按钮,或使用快捷键
Ctrl+F5运行程序。 - 如果底部终端输出了问候语,说明环境搭建成功。
常见问题与注意事项
即使步骤正确,有时也会遇到问题,注意以下几点可避免多数错误。
- 确保JDK路径没有中文或空格,否则可能导致扩展无法识别。
- 如果启动时提示“Cannot find Java runtime”,检查
java.home设置:在VS Code设置中搜索“java home”,手动填写JDK路径。 - 首次打开Java文件时,VS Code可能会提示“Setting up the Java development environment”,等待初始化完成即可。
- 使用Maven或Gradle项目时,建议安装对应插件以获得更好的依赖管理和构建支持。
基本上就这些。只要JDK装好,扩展配齐,VS Code就能成为轻量又高效的Java开发工具。不复杂但容易忽略细节,尤其是环境变量和路径设置。










