[IDE] VSCode Springboot 개발환경 설정 (MacOS M1)

💡 본 문서는본 문서는 'VSCode Springboot 개발환경 설정 (MacOS M1)'에 대해 정리해놓은 글입니다.
Springboot에 공부하기에 앞서 Macbook M1에서 개발환경을 설정하는 과정을 정리하였으니 참고하시기 바랍니다.

1. VSCode Extension

VS Code는 기본이 텍스트에디터이므로, VS코드를 이클립스나 IntelliJ 같은 IDE처럼 사용하기 위해서 확장기능(Extensions)을 설치하여야 합니다.

1.1 Extension Pack for Java

1.2 Spring Boot Extension Pack

+ Gradle for Java

Maven으로 빌드를 한다면 Extension Pack for Java에서 이미 Extension이 설치 되었지만, Gradle로 빌드할 거라면 다음과 같은 Extension을 설치해주어야 합니다.

2. 환경 설정 및 설치 확인

2.1 Java 환경 설정

VSCode 환경설정(File -> Preferences -> Settings)으로 가서 java.home 이라고 검색해줍니다. 이후 'Edit in settings.json' 을 클릭하여, 설정 JSON 파일을 열어줍니다.(이러한 User Setting이 없다면, Default Setting을 따릅니다.)

2.2 Java 설치 확인

이후 프로젝트 내 Hello.java를 생성 후 컴파일 및 실행을 해봅니다.

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello VS Code + Java");
    }
}

정상적으로 실행 결과를 확인할 수 있습니다.

Hello VS Code + Java

2.3 Springboot 환경 설정

2.3.1 Springboot 프로젝트 생성

Ctrl+Shift+ P를 누르면, 이런 커맨드 창이 하나 뜨는데, 'Spring initializer : Generate a Maven(or Gradle) Project' 를 선택합니다. 이후 다양한 옵션을 선택할 수 있는데, 저는 다음과 같은 옵션으로 지정해주어 프로젝트를 만들었습니다.

Specify Spring Boot version: 2.77
Specify project language: Java
Input Group Id for your preject: com.example
Input Artifact Id for your preject: demo
Specify packaging type: Jar
Specify Java version: 11

여기서 Java version은 다음과 같이 확인할 수 있습니다.

$ java -version
openjdk version "11.0.12" 2021-07-20
OpenJDK Runtime Environment Microsoft-25199 (build 11.0.12+7)
OpenJDK 64-Bit Server VM Microsoft-25199 (build 11.0.12+7, mixed mode)

java와 javac의 차이점에 대해 알고 싶으면 다음의 링크를 참고해주시기 바랍니다.

[JAVA] JVM vs JDK vs JRE? (java와 javac의 버전 및 설치경로 알아보기)

이후 'Search for dependency'를 설정해주는 다음 사진과 같이 다양한 Dependencies 옵션이 나오는데... 여기서 저는 'Spring Web', 'Spring Boot DevTools', 'Lombok'를 추가해주었으며, 이를 넣어주면 기본 tomcat이 내장된 jar로 환경구성을 할 수 있습니다.

이렇게 하면 프로젝트가 모두 생성 되었으며 구조는 다음과 같습니다.

% tree -L 7 ./demo
./demo
├── HELP.md
├── mvnw
├── mvnw.cmd
├── pom.xml
└── src
    ├── main
    │   ├── java
    │   │   └── com
    │   │       └── example
    │   │           └── demo
    │   │               └── DemoApplication.java
    │   └── resources
    │       └── application.properties
    └── test
        └── java
            └── com
                └── example
                    └── demo
                        └── DemoApplicationTests.java

2.3.2 빌드 환경 설정

Maven으로 프로젝트를 생성했기에 Maven을 사용할 수 있는 환경을 설정해주자면? 먼저 apache maven 홈페이지 내 다운로드 페이지로 들어갑니다.

Apache Downloads

We suggest the following site for your download: https://dlcdn.apache.org/ Alternate download locations are suggested below. It is essential that you verify the integrity of the downloaded file using the PGP signature (.asc file) or a hash (.md5 or .sha* f

maven.apache.org

이후 binary 파일 중 tar.gz 파일(apache-maven-3.8.7-bin.tar.gz)을 다운로드 받습니다(버전은 달라도 무관하며 나중에 환경설정에서 등록해주면 됩니다.).

압축파일을 푼 다음, 해당 폴더를 /opt 폴더 아래에 둡니다.

% cd /Users/choiseongjun/Downloads
% mv ./apache-maven-3.8.7 /opt
% pwd
/opt/apache-maven-3.8.7

% nano ~/.bashrc
...
# MAVEN
export MAVEN_HOME=/opt/apache-maven-3.8.7
export PATH=$MAVEN_HOME/bin:$PATH
% source ~/.bashrc

이후 VSCode 환경설정(File -> Preferences -> Settings)에서 Java > Contifuration > Maven: User Settings에 다음의 경로를 입력해줍니다.

/opt/apache-maven-3.8.7/conf/settings.xml

이후 다시 VSCode를 재실행하면 프로젝트 밑 사이드바에 MAVEN이 추가된 것을 확인할 수 있습니다.

2.4 Springboot 설치 확인

2.4.1 Test

기본 HTML을 만들어 테스트해보도록 하겠습니다. !<tab>하여 생성된 템플릿에 <h1>Hello</h1>만 추가해주었습니다.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>
    <h1>Hello</h1>
</body>
</html>

이제 Maven으로 빌드를 한 후 실행시켜보도록 하겠습니다. 빌드를 할 때는 clear 후 compile을 하면 됩니다. 이후 'DemoApplication.java'를 우클릭 후 'run java'를 클릭하면 아래의 화면이 보입니다.

이제 localhost:8080으로 접속해보면 다음과 같은 화면이 뜰 것입니다.

이후 package를 할 때에도 'clear' -> 'install' -> 'package' 순서를 지켜주어야 합니다!

꽤 오래걸렸네요;; 수고하셨습니다!

참고

[Blog] VS Code로 Java, SpringBoot 개발환경 세팅(1/2 - Java): https://1nnovator.tistory.com/45
[Blog] VS Code로 Java, SpringBoot 개발환경 세팅(2/2 - SpringBoot): https://1nnovator.tistory.com/46
[Blog] 스프링부트 개발환경 구축하기 -1: https://ddioniii.tistory.com/6

저작자표시 비영리 변경금지

'Study: DeveloperTools(DevTool) > DevTool: IDE' 카테고리의 다른 글

[IDE] VSCode Golang 개발환경 설정 (feat. ChatGPT, HTTP/2) (0)	2023.02.16
[IDE] Intellij Springboot 개발환경 설정(feat. spring initializr) (0)	2023.02.14
[IDE] VSCode React + .Net 개발환경 설정 (MacOS M1) (0)	2023.01.16
[IDE] VSCode C++ 디버깅 환경 세팅(task.json, launch.json): Clang on MacOS (0)	2022.12.15
[IDE] VSCode C++ 디버깅 환경 세팅(task.json, launch.json): GCC on Linux (feat. 모든 중단점에서 멈추도록) (1)	2022.07.08

« 2025/05 »
일	월	화	수	목	금	토
				1	2	3
4	5	6	7	8	9	10
11	12	13	14	15	16	17
18	19	20	21	22	23	24
25	26	27	28	29	30	31