VsCode搭建Java开发环境（Spring Boot项目创建、运行、调试）

雨点打透心脏的1/2处 2021-10-08 05:16 480阅读 0赞

# [VsCode搭建Java开发环境（Spring Boot项目创建、运行、调试）][VsCode_Java_Spring Boot] #

安装如下两个主要扩展即可，这两个扩展已关联java项目开发主要使用的maven、springboot等所需要的扩展。

![format_png][]

开始步骤：

1.  在 Visual Studio Code 中打开扩展视图(Ctrl+Shift+X)。
2.  输入“java”搜索商店扩展插件。
3.  找到并安装 [Java Extension Pack (Java 扩展包)][Java Extension Pack _Java]，如果你已经安装了 [Language Support for Java(TM) by Red Hat][Language Support for Java_TM_ by Red Hat]，也可以单独找到并安装 [Java Debugger for Visual Studio Code][] 扩展。
4.  输入“Spring Boot Extension”搜索商店扩展插件。
5.  找到并安装 “Spring Boot Extension Pack”。安装过程中可能会比较慢，耐心等待即可。

配置Maven：

点左下角的设置图标->设置，打开设置内容筛选框，输入maven，然后点击右侧的打开json格式setting：

![format_png 1][]

然后把maven的可执行文件路径配置、maven的setting路径配置、java.home的路径配置，拷贝到右侧的用户设置区域并且设置为自己电脑的实际路径

![format_png 2][]

设置内容如下：

{
        "workbench.iconTheme": "vscode-icons",
        "workbench.startupEditor": "newUntitledFile",
        "java.errors.incompleteClasspath.severity": "ignore",
        "workbench.colorTheme": "Atom One Dark",
        "java.home":"D:\\software\\Java\\jdk1.8.0_60",
        "java.configuration.maven.userSettings": "D:\\software\\apache-maven-3.3.3-bin\\apache-maven-3.3.3\\conf\\settings.xml",
        "maven.executable.path": "D:\\software\\apache-maven-3.3.3-bin\\apache-maven-3.3.3\\bin\\mvn.cmd",
        "maven.terminal.useJavaHome": true,
        "maven.terminal.customEnv": [
            {
                "environmentVariable": "JAVA_HOME",
                "value": "D:\\software\\Java\\jdk1.8.0_60"
            }
        ],
    }

如果你的mvn更新包速度很慢，建议使用阿里云的镜像速度会快点（修改maven的setting配置如下）：

<mirror>
                <id>alimaven</id>
                <mirrorOf>central</mirrorOf>
                <name>aliyun maven</name>
                <url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
            </mirror>
            <mirror>
                <id>nexus-aliyun</id>
                <mirrorOf>*</mirrorOf>
                <name>Nexus aliyun</name>
                <url>http://maven.aliyun.com/nexus/content/groups/public</url>
            </mirror>
            
            <mirror>
                <id>repo1</id>
                <mirrorOf>central</mirrorOf>
                <name>Human Readable Name for this Mirror.</name>
                <url>http://repo1.maven.org/maven2/</url>
            </mirror>
        
            
            <mirror>
                <id>repo2</id>
                <mirrorOf>central</mirrorOf>
                <name>Human Readable Name for this Mirror.</name>
                <url>http://repo2.maven.org/maven2/</url>
            </mirror>

配置完成重启 VSCode。

创建Spring Boot项目

使用快捷键(Ctrl+Shift+P)命令窗口，输入 Spring 选择创建 Maven 项目。 效果如下：

![format_png 3][]

选择需要使用的语言、Group Id、项目名称等，这里选择Java：

![format_png 4][]

![format_png 5][]

![format_png 6][]

选择Spring Boot版本：

![format_png 7][]

选择需要引入的包，引入如下几个包即可满足web开发：

DevTools（代码修改热更新，无需重启）、Web（集成tomcat、SpringMVC）、Lombok（智能生成setter、getter、toString等接口，无需手动生成，代码更简介）、Thymeleaf （模板引擎）。

选择好要引入的包后直接回车，在新弹出的窗口中选择项目路径，至此Spring Boot项目创建完成。

![format_png 8][]

创建好后vscode右下角会有如下提示，点击Open it 即可打开刚才创建的Spring Boot项目。

![format_png 9][]

项目运行跟调试

项目创建后会自动创建DemoApplication.java文件，在DemoApplication 文件目录下新建文件夹 Controller，新建文件HomeController.java。效果如下：

![format_png 10][]

Ps:SpringBoot项目的Bean装配默认规则是根据DemoApplication类所在的包位置从上往下扫描。所以必须放在同一目录下否则会无法访问报如下所示错误：

![format_png 11][]

启动工程之前还需要配置下运行环境，如下图，点左边的小虫子图标，然后点上面的下拉箭头，选择添加配置，第一次设置时VS Code会提示选择需要运行的语言环境，选择对应环境后自动创建 launch.json 文件。

![format_png 12][]

launch.json 调试配置文件如下，默认不修改配置也可使用：

![format_png 13][]

选择对应的配置环境调式项目如下，默认端口为8080。

![format_png 14][]

启动后可在控制台输出面板查看启动信息，显示如下后，访问：http://localhost:8080即可。

![format_png 15][]

最终效果如下：

![format_png 16][]

访问HTML页面

在spring boot 中访问html需要引入Thymeleaf （模板引擎）包，在创建项目时已引用该包这里不需在重复引用。在resources-->templates目录下创建Index.html文件，效果如下：

![format_png 17][]

html内容：

<!DOCTYPE html>
    <html lang="en" xmlns:th="http://www.w3.org/1999/xhtml">
    <head>
        <meta charset="UTF-8"/>
        <title>第一个HTML页面</title>
    </head>
    <body>
    <h1>Hello Spring Boot!!!</h1>
    <p th:text="${hello}"></p>
    </body>
    </html>

在controller目录下新建TestController.java文件，代码如下：

@Controller
    public class TestController {
    
        /**
         * 本地访问内容地址 ：http://localhost:8080/hello
         * @param map
         * @return
         */
        @RequestMapping("/hello")
        public String helloHtml(HashMap<String, Object> map) {
            map.put("hello", "欢迎进入HTML页面");
            return "/index";
        }
    }

Ps:如果要访问html页面注解必须为Controller不能为RestController。否则无法访问。

**RestController和Controller的区别：**

@RestController is a stereotype annotation that combines @ResponseBody and @Controller.  
意思是：  
@RestController注解相当于@ResponseBody ＋ @Controller合在一起的作用。  
1)如果只是使用@RestController注解Controller，则Controller中的方法无法返回jsp页面，配置的视图解析器InternalResourceViewResolver不起作用，返回的内容就是Return 里的内容。

例如：本来应该到success.html页面的，则其显示success.

2)如果需要返回到指定页面，则需要用 @Controller配合视图解析器InternalResourceViewResolver才行。

3)如果需要返回json或者xml或者自定义mediaType内容到页面，则需要在对应的方法上加上@ResponseBody注解

效果展示如下：

![format_png 18][]

到处基础配置结束，可以愉快的玩耍Spring Boot!

[VsCode_Java_Spring Boot]: https://www.cnblogs.com/miskis/p/9816135.html
[format_png]: /images/20211008/afc0c632061347a59665c7725ef13270.png
[Java Extension Pack _Java]: https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack
[Language Support for Java_TM_ by Red Hat]: https://marketplace.visualstudio.com/items?itemName=redhat.java
[Java Debugger for Visual Studio Code]: https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-debug
[format_png 1]: /images/20211008/48884e55e5d748ad882aa8ab5d676dcb.png
[format_png 2]: /images/20211008/c1a03921e353484795449775926e32d6.png
[format_png 3]: /images/20211008/b945a511fd624e618b5b41d96e5aa7b9.png
[format_png 4]: /images/20211008/a9cb6ac8e9d74eb2a5ed3b599174a65e.png
[format_png 5]: /images/20211008/6eeb894cf74a41aea0d5c4f191b51d3a.png
[format_png 6]: /images/20211008/c183ea77322148bfaf207c20878ebe16.png
[format_png 7]: /images/20211008/902a162f3fe4407cb6c201e9f6cc28e6.png
[format_png 8]: /images/20211008/0eb785071e8c41ba8e1bfe7426f66ded.png
[format_png 9]: /images/20211008/3b2d1d8ebe594109bff7a9786240bfa4.png
[format_png 10]: /images/20211008/30fd4913a93e42078886d08c28c1d2c4.png
[format_png 11]: /images/20211008/4bf7e26ea1ac42d8a016b54e8b045772.png
[format_png 12]: /images/20211008/f9a0734ef0054c60af3789ea0ef7ab50.png
[format_png 13]: /images/20211008/b16251b7f3954fd180813839ac039e1a.png
[format_png 14]: /images/20211008/9e2b49f667d043f5a1b69944dff8f14a.png
[format_png 15]: /images/20211008/3d7019058e0d4b3ebd3c75e6071d22f5.png
[format_png 16]: /images/20211008/1327d4f113f6486bbad9c676179d6897.png
[format_png 17]: /images/20211008/784578f456df4f1cae6e69af5ecc5ba6.png
[format_png 18]: /images/20211008/6c16054026ad460cbec2b1a67953012a.png