读不在三更五鼓,功只怕一曝十寒。

创建项目

  • 使用快捷键 Ctrl+Shift+E 进入资源管理器面板,选择 Java Projects 分类,点击分类工具栏中的「Create Java Project…」工具,进入项目创建向导
  • 依次选择 Maven / maven-archetype-quickstart / 1.4(请根据自己的需求选择构建工具和相应配置,示例以 Maven 为例)
  • 选择项目保存的位置后,如果你是第一次使用上一步选择的原型创建项目,Maven 将从远程镜像库下载该原型依赖
  • 依次填写 groupId / artifactId / version / package 后,输入 y 确定完成项目创建

如果你使用的是 Ubuntu 平台,快捷键 Ctrl+Shift+E 将会存在冲突,以下提供两种解决方案。

  1. 修改系统快捷键(推荐):
    在终端输入 ibus-setup 打开 IBus 首选项,选择「表情符号」,修改或删除「表情符号注释」快捷键
  2. 修改 VS Code 快捷键:
    使用快捷键 Ctrl+K Ctrl+S 打开快捷键设置窗口,在搜索框中输入 View: Show Explorer,然后在搜索结果中双击修改快捷键

第二章的验证:
在完成创建项目的第三个步骤以后,Maven 将从远程镜像库下载原型依赖。这时可以看到终端中有 Downloading from nexus-aliyun 的信息输出,正是我们配置的 nexus-aliyun 镜像库。
打开 /var/local/lib/maven/repo 目录,可以看到已经下载了诸多项目依赖(生效前是空目录),证明本地存储库配置成功。


导入项目

完成项目创建以后 VS Code 并没有导入刚刚创建的项目,这时需要我们手动进行导入。

  • 使用快捷键 Ctrl+K Ctrl+O 打开文件夹选择窗口,选择刚刚创建的项目。此时 VS Code 会自动识别导入的项目类型,并运行相应的扩展插件。

读者思考
手动创建的项目,VS Code 会自动识别吗?


导出项目

对于 Java 项目 VS Code 只提供了以 Jar 形式的导出。如果需要其他形式的导出,请自行参考所用的构建工具。

  • 进入资源管理器面板,选择 Java Projects 分类,点击分类工具栏中的「Export Jar…」工具,进入项目导出向导
  • 依次选择 主类 / 导出内容 点击 OK,VS Code 将导出项目。导出的 Jar 文件存放在项目根目录中

运行项目

这里简单的讲解一下怎样运行项目,详细的运行与调试配置将在后续章节中详细说明。

  • 进入资源管理器面板,选择 Java Projects 分类,在项目的工具栏上点击「Run」工具,VS Code 将自动识别项目类型并找到主类运行

配置 JDK

在第一章中,简单的讲解了 JDK 的配置,接下来我们将在这一小节详细说明 JDK 的配置。VS Code 将 JDK 分为两种使用场景,一种为支持 Java 扩展运行的 JDK,一种为支持项目运行的JDK。

1. 支持扩展的 JDK

支持扩展的 JDK 有三种配置方式,优先级顺序为:

  • 在 VS Code 配置文件中的 java.home
  • 系统变量 JDK_HOME
  • 系统变量 JAVA_HOME

2. 支持项目的 JDK

支持项目的 JDK 需要在 VS Code 配置文件中进行配置,我们先来看一下具体的配置。

"java.configuration.runtimes": [
	{
		"name": "JavaSE-1.8",
		"path": "/usr/local/lib/java/jdk1.8.0_202",
		"sources": "/usr/local/lib/java/jdk1.8.0_202/src.zip",
		"javadoc": "https://docs.oracle.com/javase/8/docs/api",
		"default": true
	},
	{
		"name": "JavaSE-15",
		"path": "/usr/local/lib/java/jdk-15.0.1"
	}
]

上面的示例中配置了两个版本的 JDK,分别为 JavaSE-1.8 和 JavaSE-15。当然如果你还需要其他版本的 JDK,可以在 java.configuration.runtimes 数组中追加配置。每一个 JDK 配置中可以有五个属性,每个个属性的说明如下:

  • name:JDK 版本名称,必须配置。且必须是 J2SE-1.5 / JavaSE-1.6 /JavaSE-1.7 /JavaSE-1.8 /JavaSE-9 / JavaSE-10 / JavaSE-11 / JavaSE-12 / JavaSE-13 /JavaSE-14 /JavaSE-15 的其中之一
  • path:JDK 安装路径,必须配置
  • sources:JDK 源码位置,可选配置
  • javadoc:JKD 文档位置,可选配置
  • default:是否为默认 JDK,可选配置,但在所有的 JDK 配置中只能存在一个为 true。

当配置好所有的 JDK 版本后,VS Code 将自动调用相应的版本,调用优先级如下:

  • 如果项目使用构建工具并在构建工具中配置了 JDK 版本,VS Code 将使用相应的 JDK 版本来运行项目
  • 其他的项目或 Java 源码,VS Code 将使用具有 default 为 true 的 JDK 版本运行
  • 如果配置中不存在 default 为 true 的 JDK 版本,VS Code 将使用支持扩展的 JDK 版本运行,并遵循支持扩展的 JDK 优先级

加载模式

VS Code 支持两种模式加载项目,可以通过 java.server.launchMode 在 VS Code 配置文件中进行配置。

  • LightWeight:轻型模式。只解析源文件和 JDK,不支持构建、运行、调试、检测方法等功能
  • Standard:标准模式(推荐)。
  • Hybrid:混合模式(默认)。首先以轻型模式加载项目,VS Code 会询问是否切换到标准模式。