读不在三更五鼓,功只怕一曝十寒。
创建项目
- 使用快捷键 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 将会存在冲突,以下提供两种解决方案。
- 修改系统快捷键(推荐):
在终端输入 ibus-setup 打开 IBus 首选项,选择「表情符号」,修改或删除「表情符号注释」快捷键- 修改 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 会询问是否切换到标准模式。