VSCode에서 Java 개발 환경 설정하기 (Spring Boot 프로젝트 생성, 실행 및 디버깅)

GitHub 저장소 주소: Spring-Boot-Demo

확장 기능 설치

Java 개발에 필요한 Maven과 Spring Boot 관련 확장 기능을 포함하는 두 가지 주요 확장을 설치하면 됩니다.

  1. Visual Studio Code에서 확장 창(Ctrl+Shift+X)을 엽니다.
  2. 상점에서 "java"를 검색하여 확장 기능을 찾습니다.
  3. "Java Extension Pack"을 찾아 설치합니다. 이미 "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 형식의 설정 파일을 엽니다:


{
    "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"
        }
    ]
}

Maven 업데이트 속도가 느리다면 아래와 같이 Alibaba Cloud 미러를 사용해보세요:


<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>

설정 완료 후 VSCode를 재시작합니다.

Spring Boot 프로젝트 생성

(Ctrl+Shift+P) 명령 창을 열고 "Spring"을 입력하여 Maven 프로젝트를 생성합니다. 언어, Group Id, 프로젝트 이름 등을 선택하고 Java를 선택합니다:

  • Spring Boot 버전 선택
  • 필요한 패키지 선택 (DevTools, Web, Lombok, Thymeleaf 등)

프로젝트 경로를 선택하면 Spring Boot 프로젝트 생성이 완료됩니다. VSCode 하단 오른쪽에 "Open it" 메시지가 표시되면 클릭하여 생성된 프로젝트를 엽니다.

프로젝트 실행 및 디버깅

생성된 DemoApplication.java 파일이 있는 디렉토리에 Controller 폴더를 만들고 HomeController.java 파일을 추가합니다:


@Controller
public class HomeController {

    @RequestMapping("/hello")
    public String helloHtml(HashMap<String, Object> map) {
        map.put("hello", "환영합니다!");
        return "/index";
    }
}

런타임 환경을 설정하려면 좌측의 버그 아이콘을 클릭하고 드롭다운 메뉴에서 "Add Configuration"을 선택합니다. 처음 설정 시 해당 언어 환경을 선택하면 자동으로 launch.json 파일이 생성됩니다.


{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "Debug (Launch)-DemoApplication",
            "request": "launch",
            "mainClass": "com.example.demo.DemoApplication"
        }
    ]
}

디버깅 환경을 선택하고 실행하면 기본 포트 8080에서 애플리케이션이 시작됩니다.

HTML 페이지 접근

resources/templates 디렉토리에 Index.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 {

    @RequestMapping("/hello")
    public String helloHtml(HashMap<String, Object> map) {
        map.put("hello", "HTML 페이지에 오신 것을 환영합니다.");
        return "/index";
    }
}

HTML 페이지에 접근하려면 반드시 @Controller 어노테이션을 사용해야 합니다.

태그: java Spring Boot maven vscode debugging

7월 20일 03:44에 게시됨