VSCode怎么写JAVA项目_VSCode创建与开发Java项目完整教程

雪夜

发布时间：2025-08-28 13:56:01

1044人浏览过

来源于php中文网

原创

答案是：配置vscode写java需三步——装jdk、配环境变量、装java扩展包；创建项目用命令面板选maven/gradle；通过设置jdk路径、代码格式化、调内存提升效率；常见问题如语言服务器失败可清缓存或重启解决；依赖管理靠pom.xml或build.gradle，vscode侧边栏提供maven/gradle任务快捷运行，结合命令行更灵活。

vscode怎么写java项目_vscode创建与开发java项目完整教程

在VSCode里写Java项目，说白了，核心就是三步走：先确保你的电脑有Java开发环境（JDK），然后给VSCode装上Java扩展包，最后就是利用这些工具创建、编写和运行你的Java代码。听起来简单，但里头门道不少，尤其是要写得顺手、高效，还得有点心得。

VSCode本身是个轻量级的代码编辑器，它能玩转Java，全靠强大的扩展生态。所以，与其说VSCode“怎么写”Java，不如说是“怎么用VSCode的扩展”来写Java。这和那些重量级的IDE（比如IntelliJ IDEA或Eclipse）直接内置所有功能的路子不太一样，但灵活性和启动速度是它的优势。

解决方案

要让VSCode成为你的Java开发利器，一套标准的流程和一些关键配置是必不可少的。我个人是这么一步步来的：

1. 准备Java开发环境（JDK）

立即学习“Java免费学习笔记（深入）”；

这是基础中的基础，没有JDK，Java代码就没法编译和运行。

安装JDK： 我通常推荐安装LTS（长期支持）版本，比如Java 11或Java 17。可以从Oracle官网下载，或者使用OpenJDK发行版，比如Adoptium（以前的AdoptOpenJDK）。安装后，记得配置
```
JAVA_HOME
```
环境变量，并把
```
%JAVA_HOME%\bin
```
（Windows）或
```
$JAVA_HOME/bin
```
（macOS/Linux）添加到
```
Path
```
环境变量里。这一步很重要，VSCode的Java扩展会依赖它。
验证安装： 打开终端或命令提示符，输入
```
java -version
```
和
```
javac -version
```
，如果能正确显示版本信息，那就没问题了。

2. 配置VSCode Java扩展包

这是让VSCode“认识”Java的关键。

安装“Extension Pack for Java”： 在VSCode的扩展视图（
```
Ctrl+Shift+X
```
）里搜索“Extension Pack for Java”，这是微软官方提供的一个扩展包，包含了Java开发所需的核心组件，比如Java语言支持、调试器、测试运行器、Maven/Gradle支持等。一键安装，省心省力。
可选但推荐的扩展：
- Lombok: 如果你的项目使用了Lombok，安装“Lombok Annotations Support for VS Code”会让你在代码提示和编译时少很多麻烦。
- Spring Boot Extension Pack: 如果你做Spring Boot项目，这个扩展包能提供很多便利，比如启动器生成、配置提示等。

3. 创建并初始化Java项目

现在环境都齐活了，可以开始搞项目了。

使用VSCode命令面板： 按下
```
Ctrl+Shift+P
```
（macOS是
```
Cmd+Shift+P
```
）打开命令面板，输入“Java: Create Java Project”。
选择项目类型：
- No Build Tools: 适用于非常简单的、单个文件的Java程序，或者你只想快速测试一些代码片段。
- Maven: 这是企业级Java项目最常用的构建工具。选择它，VSCode会帮你生成一个标准的Maven项目结构（
```
pom.xml
```
  、
```
src/main/java
```
  等）。
- Gradle: 另一个流行的构建工具，尤其在Android开发中很常见。它使用Groovy或Kotlin DSL来定义构建脚本。
- 我个人更偏爱Maven，因为它的XML配置虽然啰嗦点，但结构清晰，社区资源也多。
选择项目位置和命名： 按照提示选择项目存放的文件夹，并给你的项目起个名字。

4. 编写Java代码

项目创建好后，你会在VSCode的资源管理器中看到一个标准的项目结构。

创建Java文件： 在
```
src/main/java
```
目录下（如果是Maven/Gradle项目），创建你的Java文件，比如
```
HelloWorld.java
```
。
编写代码：
```
package com.example.myproject; // 包名，根据你的项目结构调整

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, VSCode Java Project!");
    }
}
```
你会发现VSCode提供了强大的代码补全、错误检查和重构功能，这些都得益于Java语言服务器（Java Language Server）的加持。

Vidyo.ai
一款将长视频制作成短片的AI工具

下载

5. 运行和调试项目

这是VSCode开发Java最便捷的地方之一。

运行： 在
```
main
```
方法上方，你会看到一个“Run”和“Debug”的链接。点击“Run”可以直接运行你的程序。
调试： 点击“Debug”，程序会在断点处暂停。你可以设置断点、单步执行、查看变量值、调用堆栈等。这体验和传统IDE几乎一样好。
通过Maven/Gradle运行： 如果是Maven项目，你也可以在终端中使用
```
mvn compile exec:java -Dexec.mainClass="com.example.myproject.HelloWorld"
```
来运行。Gradle也有类似的命令。VSCode的Maven/Gradle扩展也会在侧边栏提供对应的任务运行入口。

如何在VSCode中高效配置Java开发环境？

高效配置不仅仅是装上扩展那么简单，更在于让你的开发流程顺畅，减少不必要的摩擦。

首先，关于JDK的管理，我通常会用

sdkman

（Linux/macOS）或者直接手动管理多个JDK版本。VSCode的Java扩展允许你在工作区级别指定JDK路径，这意味着不同项目可以使用不同的JDK版本，这在维护老项目和开发新项目时非常有用。你可以在

.vscode/settings.json

中添加：

{
    "java.configuration.runtimes": [
        {
            "name": "JavaSE-11",
            "path": "/path/to/jdk-11",
            "default": true // 设为默认
        },
        {
            "name": "JavaSE-17",
            "path": "/path/to/jdk-17"
        }
    ],
    "java.project.sourcePaths": ["src/main/java", "src/test/java"] // 确保识别源文件
}

其次，代码格式化和静态分析是提高效率和代码质量的关键。我个人会结合

Prettier

（通过

Prettier - Code formatter

扩展）和

Java Formatter

来统一代码风格。

Prettier

可以处理大部分非Java文件，而

Java Formatter

则专注于Java代码。你可以在

settings.json

中配置：

{
    "[java]": {
        "editor.defaultFormatter": "redhat.java" // 使用Red Hat的Java formatter
    },
    "java.format.settings.url": "https://raw.githubusercontent.com/google/styleguide/gh-pages/eclipse-java-google-style.xml", // 比如使用Google的Java代码风格
    "java.format.settings.profile": "GoogleStyle" // 对应xml中的profile名称
}

再者，对于大型项目，VSCode的默认内存设置可能不够用，导致Java语言服务器卡顿甚至崩溃。你可以调整Java语言服务器的内存限制，同样在

settings.json

中：

{
    "java.jdt.ls.vmargs": "-XX:+UseG1GC -XX:+UseStringDeduplication -Xmx2G -Xms100m" // 调整内存，2G通常够用
}

这里

Xmx2G

表示最大堆内存2GB。根据你的机器配置和项目大小，这个值可以灵活调整。

最后，不要忘了利用VSCode的任务（Tasks）功能。你可以定义自定义任务来运行Maven/Gradle命令，或者执行一些脚本，比如部署到本地测试服务器。通过

Ctrl+Shift+P

搜索“Tasks: Configure Task”就能创建

tasks.json

。这能把一些重复性的操作自动化，比如一键打包、一键运行测试。

VSCode开发Java项目时常遇到的问题与解决方案

即便VSCode的Java支持已经很成熟，但在实际使用中，我们还是会碰到一些小插曲。

一个常见的问题是“Java Language Server”启动失败或运行缓慢。这通常表现为代码补全失效、错误提示不准确，或者CPU占用率飙高。我的经验是，首先检查你的JDK版本是否正确安装并配置在

Path

中。如果JDK没问题，可以尝试以下几点：

重启VSCode： 有时候只是暂时性的小问题，重启一下就好了。
清理Java语言服务器缓存： 在命令面板输入“Java: Clean Java Language Server Workspace”，这会清除语言服务器的内部缓存，强制它重新分析项目。
检查内存设置： 如果项目非常大，或者你同时打开了多个Java项目，语言服务器可能会因为内存不足而崩溃。前面提到的
```
java.jdt.ls.vmargs
```
配置就是解决这个问题的。
禁用冲突扩展： 某些扩展可能会与Java扩展产生冲突。可以尝试暂时禁用其他扩展，看看问题是否解决。

另一个恼人的问题是Maven/Gradle依赖无法解析。当你添加了新的依赖，或者从Git拉取了新代码，VSCode有时不会立即识别。

手动刷新： 在VSCode的资源管理器中，右键点击
```
pom.xml
```
（Maven）或
```
build.gradle
```
（Gradle），选择“Java: Update project configuration”。或者在Maven/Gradle视图中点击刷新按钮。
运行构建命令： 在终端中运行
```
mvn clean install
```
（Maven）或
```
gradle clean build
```
（Gradle）。这会强制下载所有依赖并构建项目，VSCode通常会随之更新。
检查代理设置： 如果你身处需要代理才能访问外部网络的开发环境，确保Maven/Gradle的
```
settings.xml
```
或
```
gradle.properties
```
中配置了正确的代理信息。

还有，偶尔会遇到“Run”或“Debug”按钮不显示在

main

方法上方，或者点击后提示“找不到主类”。

文件保存为
.java
：确保你的文件是以
```
.java
```
扩展名保存的。
public static void main(String[] args)
方法签名正确：仔细检查方法签名是否完全符合标准。
项目结构问题： 如果你没有使用Maven或Gradle，只是创建了一个“No Build Tools”项目，需要确保你的Java文件在VSCode识别的源文件夹内。通常，VSCode会默认识别根目录下的
```
.java
```
文件，但如果你有复杂的文件夹结构，可能需要在
```
.vscode/settings.json
```
中明确
```
java.project.sourcePaths
```
。

结合Maven/Gradle，VSCode如何管理Java项目依赖和构建？

在现代Java开发中，Maven和Gradle几乎是标配。VSCode与它们的集成，虽然不如重量级IDE那样深入，但也足够日常开发使用了。

Maven项目管理： VSCode的Java扩展包中包含了对Maven的良好支持。当你打开一个包含

pom.xml

的Maven项目时，VSCode会自动识别它。

依赖管理：
```
pom.xml
```
文件是Maven项目的核心，它定义了项目的元数据、依赖、构建插件等。在VSCode中编辑
```
pom.xml
```
时，你会得到很好的XML自动补全和验证。当你添加或修改依赖后，VSCode通常会自动下载新的依赖，并在后台更新项目配置。如果没自动更新，可以右键
```
pom.xml
```
选择“Java: Update project configuration”。
Maven视图： VSCode侧边栏会有一个Maven图标，点击后会显示项目的依赖树、插件以及可用的Maven生命周期目标（如
```
clean
```
、
```
install
```
、
```
package
```
、
```
test
```
、
```
deploy
```
等）。你可以直接点击这些目标来运行它们，省去了在终端敲命令的麻烦。这对于快速执行某个构建阶段或者运行测试非常方便。
本地仓库： Maven会将下载的依赖存储在本地仓库（通常在用户目录下的
```
.m2/repository
```
）。VSCode本身不会直接管理这个仓库，但它会利用Maven命令来与仓库交互。

Gradle项目管理： 对于Gradle项目，VSCode同样提供了相应的支持。

构建脚本： Gradle项目使用
```
build.gradle
```
（或
```
build.gradle.kts
```
）作为构建脚本。VSCode对Groovy和Kotlin DSL都有不错的语法高亮和基本补全。
依赖管理： 在
```
build.gradle
```
中添加
```
dependencies
```
块来声明依赖。VSCode的Gradle扩展会尝试解析这些依赖。
Gradle视图： 类似Maven，Gradle也会在侧边栏提供一个视图，展示项目中的所有任务（Tasks），比如
```
build
```
、
```
test
```
、
```
bootRun
```
（对于Spring Boot项目）。你可以直接点击这些任务来运行它们。
Gradle Wrapper： 大多数Gradle项目都会包含一个
```
gradlew
```
脚本（Gradle Wrapper）。VSCode通常会优先使用这个Wrapper来执行Gradle任务，确保所有开发者都使用相同版本的Gradle，避免“在我机器上能跑”的问题。

我个人的感受是，VSCode在处理单模块或结构相对简单的Maven/Gradle项目时，体验非常流畅。它的语言服务器能够很好地解析项目结构和依赖。但对于一些特别复杂的、多模块嵌套很深的项目，或者需要执行一些非常规的Maven/Gradle命令时，我有时还是会倾向于打开终端，直接输入命令来获得更精细的控制和更清晰的输出。毕竟，VSCode的集成是建立在调用这些构建工具的命令行接口之上的，直接使用命令行，总能提供最原始、最强大的控制力。不过，对于日常开发，VSCode提供的图形化界面和快捷操作已经足够高效了。

如何在vscode中搭建Java开发环境_配置JDK与运行项目的完整流程【教程】

如何用vscode写出一手好Markdown_从语法到实时预览的深度解析【教程】

怎样使用VSCode_的Live Server扩展预览网页【教程】

如何用VSCode_搭建Go语言开发环境【教程】

如何为vscode安装适合的扩展以支持嵌入式开发【教程】