【小白也能看懂的 VSCode 配置 Java 开发环境】

本文提供了VSCode配置Java开发环境的完整指南，适合零基础用户快速上手。主要内容包括：1）安装JDK 17并配置环境变量；2）安装VSCode和Java扩展包；3）配置JDK路径；4）创建首个Java项目并运行；5）设置Google风格的代码自动格式化；6）提高效率的实用技巧。50分钟内即可完成配置并运行第一个Java程序，文中包含Windows、macOS和Linux系统的详细步骤，以及常

TIF星空

1371人浏览 · 2025-07-31 11:20:47

TIF星空 · 2025-07-31 11:20:47 发布

小白也能看懂的 VSCode 配置 Java 开发环境

🚀 小白也能看懂的 VSCode 配置 Java 开发环境完整指南

🚀 小白也能看懂的 VSCode 配置 Java 开发环境完整指南

⚠️ 零基础？没关系！跟着这篇教程一步步操作，50分钟内就能用 VSCode 写出你的第一个 Java 程序！

Visual Studio Code（简称 VSCode）是一款免费、轻量又强大的代码编辑器。虽然它不是专门的 Java IDE（像 Eclipse 或 IntelliJ），但只要装对插件，它完全可以胜任 Java 学习和开发工作。

本教程从 安装 JDK 开始，手把手教你配置 VSCode，最终实现：
✅ 编写 Java 代码
✅ 自动补全和错误提示
✅ 一键运行程序
✅ 保存时自动格式化（使用 Google 官方代码风格）

💡 适合人群：Java 初学者、学生、转行者、想换编辑器的开发者

第一步：安装 Java 开发工具包（JDK）

Java 程序要运行，必须先安装 JDK（Java Development Kit）。

🔹 推荐版本：JDK 17（长期支持版，免费）

✅ Windows 用户

打开浏览器，访问 OpenJDK 下载网站：
👉 https://adoptium.net/
点击 “Download” → 选择 “Temurin 17” → 下载 .msi 安装包（如 x64 MSI Installer）
双击安装包，一路点击“下一步”完成安装（路径建议不要有中文）
配置环境变量（关键步骤）
- 右键点击“此电脑” → “属性” → “高级系统设置” → “环境变量”
- 在“系统变量”区域，点击“新建”：
  - 变量名：JAVA_HOME
  - 变量值：你安装 JDK 的路径，例如：
```
C:\Program Files\Eclipse Adoptium\jdk-17.0.9.9-hotspot
```
    （请根据实际路径填写）
- 找到系统变量中的 Path，点击“编辑” → “新建” → 输入：
```
%JAVA_HOME%\bin
```
- 点击“确定”保存所有窗口

✅ macOS 用户

使用 Homebrew 安装最方便：

打开终端（Terminal）
输入以下命令安装 Temurin JDK 17：
```
brew install --cask temurin17
```
安装完成后，系统会自动配置好路径，无需手动设置

✅ Linux 用户（Ubuntu/Debian）

打开终端，输入：

sudo apt update
sudo apt install openjdk-17-jdk

🔍 验证 JDK 是否安装成功

打开 命令提示符（Windows） 或 终端（macOS/Linux），输入：

java -version

你应该看到类似输出：

openjdk version "17.0.9" 2023-10-17
OpenJDK Runtime Environment (build 17.0.9+9)
OpenJDK 64-Bit Server VM (build 17.0.9+9, mixed mode)

再输入：

javac -version

输出应为：

javac 17.0.9

✅ 如果都显示版本号，说明 JDK 安装成功！

第二步：安装 Visual Studio Code

打开浏览器，访问官网：
👉 https://code.visualstudio.com/
点击“Download”按钮，下载对应系统的安装包
安装时建议勾选以下选项（Windows）：
- ✅ 添加到 PATH
- ✅ 关联 .js、.json 等文件类型（可选）
安装完成后打开 VSCode

第三步：安装 Java 扩展包

VSCode 本身不支持 Java，需要安装插件。

🛠 安装步骤：

点击左侧边栏的 扩展图标（四个方块组成的图标，或按 Ctrl+Shift+X）
在搜索框中输入：
```
Extension Pack for Java
```
找到由 Red Hat 发布的扩展包（带 Java 图标）
点击“安装”按钮

⏳ 安装过程可能需要几分钟，VSCode 会自动安装以下组件：

Java 语言支持

调试器

单元测试运行器

Maven 支持

项目管理器

安装完成后，重启 VSCode。

第四步：配置 JDK 路径（重要！）

即使你已经安装了 JDK，VSCode 也可能找不到它。我们需要手动告诉它 JDK 在哪。

🔧 配置方法：

按下快捷键 Ctrl+, 打开“设置”
在右上角点击“打开设置 (JSON)”图标（一个花括号 {}）

或者按 Ctrl+Shift+P → 输入 “Preferences: Open Settings (JSON)”
在打开的 settings.json 文件中，粘贴以下内容：

🖥 Windows 用户示例：

{
    "java.home": "C:\\Program Files\\Eclipse Adoptium\\jdk-17.0.9.9-hotspot"
}

⚠️ 注意：路径中的反斜杠要写成 \\

🍎 macOS 用户示例：

{
    "java.home": "/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home"
}

🐧 Linux 用户示例：

{
    "java.home": "/usr/lib/jvm/java-17-openjdk-amd64"
}

保存文件（Ctrl+S）

✅ 保存后，VSCode 会自动重启 Java 语言服务器。稍等片刻，你应该能看到左下角显示“Java Language Server is ready”。

第五步：创建你的第一个 Java 项目

现在我们可以创建并运行 Java 程序了！

🆕 创建项目：

按 Ctrl+Shift+P 打开命令面板
输入并选择：
```
Java: Create Java Project
```
选择项目类型：
- 选择 Simple Project（最简单，适合初学者）
选择项目存放路径（比如桌面新建一个文件夹 java-demo）
输入项目名称，比如 HelloWorld
按回车确认

VSCode 会自动生成项目结构。

📝 编写代码：

展开左侧文件资源管理器，进入：
```
HelloWorld/src/App.java
```
修改代码如下：

public class App {
    public static void main(String[] args) {
        System.out.println("Hello, 我的第一个 Java 程序运行成功啦！🎉");
    }
}

▶️ 运行程序：

将光标放在 App.java 文件中，点击右上角出现的 Run 按钮（绿色三角形），或右键选择“Run Java”。

你应该会在下方“集成终端”看到输出：

Hello, 我的第一个 Java 程序运行成功啦！🎉

🎉 恭喜你！第一个 Java 程序运行成功！

第六步：设置代码格式化（使用 Google 风格）

写代码也要“讲规矩”。Google 提供了一套官方 Java 编码规范，我们可以导入到 VSCode。

🎯 目标：保存代码时自动格式化为 Google 风格

🔧 配置步骤：

确保你的 settings.json 中包含以下配置：

{
    "java.format.settings.url": "https://raw.githubusercontent.com/google/styleguide/gh-pages/eclipse-java-google-style.xml",
    "java.format.settings.profile": "GoogleStyle",
    "editor.formatOnSave": true,
    "editor.formatOnPaste": true
}

✅ 这段配置的意思是：

使用 Google 的 XML 格式化规则

文件名中的 GoogleStyle 是规则名称（来自 XML 文件）

保存和粘贴时自动格式化

保存 settings.json

🧪 测试格式化：

在 App.java 中故意写乱代码，比如：

public class App{
public static void main(String[] args){
System.out.println("test");
}
}

然后保存文件（Ctrl+S），你会发现代码自动变成了整齐的格式！

第七步：提高效率的小技巧

🔥 常用快捷键

快捷键	功能
`Ctrl+Space`	触发代码补全
`F12`	跳转到定义
`Shift+F12`	查找所有引用
`F2`	重命名变量/方法
`Ctrl+.`	快速修复错误
`Alt+Shift+F`	手动格式化代码
`Ctrl+Shift+O`	组织导入（删除无用 import）

💡 自定义代码片段（sout 快捷输入）

按 Ctrl+Shift+P → 输入：
```
Preferences: Configure User Snippets
```
选择 java.json
添加以下代码：

{
    "Print to console": {
        "prefix": "sout",
        "body": [
            "System.out.println(\"$1\");"
        ],
        "description": "输出到控制台"
    }
}

保存后，在 Java 文件中输入 sout，就会自动补全 System.out.println();

❓ 常见问题解答（FAQ）

❌ 问题1：提示“Java Language Server cannot be started”

解决方法：

检查 java.home 路径是否正确
重新启动 VSCode
按 Ctrl+Shift+P → 输入 “Java: Clean Java Language Server Workspace” → 选择“Restart”

❌ 问题2：运行时提示“找不到或无法加载主类”

确保类名和文件名一致（如 App.java 里必须是 public class App）
不要有多余的包声明（初学者建议先不要写 package）

❌ 问题3：代码格式化没有反应

检查 settings.json 是否有 editor.formatOnSave: true
确认 java.format.settings.url 链接能访问
尝试手动按 Alt+Shift+F

📄 完整 settings.json 配置示例

你可以将以下内容复制到你的 settings.json 中，覆盖原有内容：

{
    // JDK 路径（根据你的系统修改）
    "java.home": "C:\\Program Files\\Eclipse Adoptium\\jdk-17.0.9.9-hotspot",

    // 多版本 JDK 支持（可选）
    "java.configuration.runtimes": [
        {
            "name": "JavaSE-17",
            "path": "C:\\Program Files\\Eclipse Adoptium\\jdk-17.0.9.9-hotspot",
            "default": true
        }
    ],

    // 使用 Google Java 代码风格
    "java.format.settings.url": "https://raw.githubusercontent.com/google/styleguide/gh-pages/eclipse-java-google-style.xml",
    "java.format.settings.profile": "GoogleStyle",
    "editor.formatOnSave": true,
    "editor.formatOnPaste": true,

    // 自动组织导入
    "editor.codeActionsOnSave": {
        "source.organizeImports": true
    },

    // 显示 120 字符辅助线
    "editor.rulers": [120],

    // 缩进设置
    "editor.tabSize": 4,
    "editor.detectIndentation": false,

    // 忽略不必要的文件
    "files.exclude": {
        "**/.classpath": true,
        "**/.project": true,
        "**/.settings": true,
        "**/.factorypath": true
    },

    // 终端环境变量（Windows）
    "terminal.integrated.env.windows": {
        "JAVA_HOME": "C:\\Program Files\\Eclipse Adoptium\\jdk-17.0.9.9-hotspot"
    }
}