Back-End/build Tools

Windows 환경에서 Gradle 설치 및 설정 가이드

봉의일상 2025. 2. 9. 14:34

이번 글에서는 Windows 환경에서 Gradle을 설치하고 설정하는 방법에 대해 처음부터 차근차근 설명해드리겠습니다. Gradle은 Java 기반 프로젝트(특히 Spring Boot)에서 자주 사용하는 빌드 도구로, 올바르게 설치하고 환경 변수를 설정하면 VS Code나 다른 IDE에서 손쉽게 사용할 수 있습니다.

 

1. Gradle 설치 확인

먼저, 터미널(CMD 또는 PowerShell)에서 Gradle이 이미 설치되어 있는지 확인합니다.

gradle -v
  • 정상 출력: Gradle 버전 정보가 표시된다면 설치된 것입니다.
  • 오류 발생: “gradle을(를) 실행할 수 없습니다” 또는 “command not found”와 같은 메시지가 나온다면 설치가 필요합니다.

2. Gradle 설치 (패키지 매니저 사용)

Windows에서는 Scoop 또는 Chocolatey 같은 패키지 매니저를 사용하면 터미널 명령어로 쉽게 설치할 수 있습니다.

Scoop으로 설치하기

Scoop이 설치되어 있지 않다면, 아래 명령어로 설치합니다.터미널을 재시작하세요.

 
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser irm get.scoop.sh | iex
  1. Scoop을 사용해 Gradle을 설치합니다.
scoop install gradle

Chocolatey로 설치하기

  • Chocolatey가 설치되어 있지 않다면, 아래 명령어로 설치합니다.터미널을 재시작하세요.
 
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
  • Chocolatey를 사용해 Gradle을 설치합니다.
choco install gradle -y

3. 환경 변수 설정

Gradle을 압축 파일로 직접 다운로드하여 설치하는 경우, 환경 변수를 설정해야 합니다.

 

 

  • 다운로드한 .zip 파일의 압축을 원하는 폴더에 해제합니다.
    • 예시 경로: C:\dev\gradle\[gradle-version-bin]\bin
  • 환경 변수 설정
    • 내 PC → 속성 → 고급 시스템 설정 → 환경 변수로 이동
    • 시스템 변수에 GRADLE_HOME을 추가하고 값에 경로를 입력합니다.
    • Path 변수에 %GRADLE_HOME%\bin을 추가합니다.

4. VS Code에서 Gradle 사용하기

CMD나 PowerShell에서는 gradle -v로 확인이 되지만, VS Code 터미널에서는 반영되지 않을 수 있습니다. 이 경우:

  1. VS Code 재시작
    환경 변수 변경 사항이 반영되도록 VS Code를 완전히 종료한 후 다시 실행합니다.
  2. 기본 터미널 변경
    VS Code에서 Ctrl + Shift + P를 눌러 Select Default Profile을 선택하고, CMD (또는 PowerShell)로 변경한 후 확인합니다.

직접 환경 변수 추가 (필요시)
settings.json 파일에 다음과 같이 추가하여 VS Code 터미널에 환경 변수를 설정할 수 있습니다.

"terminal.integrated.env.windows": { "Path": "C:\\Gradle\\gradle-8.5\\bin;${env:Path}" }

작업결과

 

5. 프로젝트 초기화: Gradle Init

 

https://bong-day.tistory.com/18