이 가이드는 Cursor에서 Java 개발을 준비하는 방법을 알려줘. JDK 설정, 필요한 확장 설치, 디버깅, Java 애플리케이션 실행, Maven·Gradle 같은 빌드 도구 연동까지 다뤄. IntelliJ나 VS Code와 비슷한 워크플로 기능도 포함돼.
시작하기 전에 Cursor가 설치되어 있고 최신 버전으로 업데이트되어 있는지 확인해.

Cursor에서 Java 설정하기

Java 설치

Cursor를 설정하기 전에 네 머신에 Java가 설치되어 있어야 해.
Cursor에는 Java 컴파일러가 포함되어 있지 않으니까, 아직 설치하지 않았다면 JDK를 설치해야 해.

Windows 설치

JDK(예: OpenJDK, Oracle JDK, Microsoft Build of OpenJDK)를 다운로드해 설치해.
JAVA_HOME을 설정하고 PATH에 JAVA_HOME\bin을 추가해.

macOS 설치

Homebrew로 설치해(brew install openjdk) 또는 설치 프로그램을 다운로드해.
JAVA_HOME이 설치된 JDK를 가리키는지 확인해.

Linux 설치

패키지 매니저를 사용해(sudo apt install openjdk-17-jdk 또는 동등한 명령) 또는 SDKMAN으로 설치해.
설치를 확인하려면 다음을 실행해:
java -version
javac -version
Cursor가 JDK를 찾지 못하면 settings.json에서 수동으로 설정해:
{
  "java.jdt.ls.java.home": "/path/to/jdk",
  "java.configuration.runtimes": [
    {
      "name": "JavaSE-17",
      "path": "/path/to/jdk-17",
      "default": true
    }
  ]
}
변경 사항을 적용하려면 Cursor를 재시작해.

Cursor 설정

Cursor는 VS Code 확장을 지원해. 다음을 수동으로 설치해:

빌드 도구 구성

Maven

Maven이 설치되어 있는지 확인해(mvn -version). 필요하면 maven.apache.org에서 설치해:
  1. 바이너리 아카이브 다운로드
  2. 원하는 위치에 압축 해제
  3. 압축 해제한 폴더를 MAVEN_HOME 환경 변수로 설정
  4. PATH에 %MAVEN_HOME%\bin(Windows) 또는 $MAVEN_HOME/bin(Unix) 추가

Gradle

Gradle이 설치되어 있는지 확인해(gradle -version). 필요하면 gradle.org에서 설치해:
  1. 바이너리 배포판 다운로드
  2. 원하는 위치에 압축 해제
  3. 압축 해제한 폴더를 GRADLE_HOME 환경 변수로 설정
  4. PATH에 %GRADLE_HOME%\bin(Windows) 또는 $GRADLE_HOME/bin(Unix) 추가
또는 Gradle Wrapper를 사용하면 올바른 Gradle 버전을 자동으로 다운로드해 사용해:

실행 및 디버깅

이제 설정이 끝났으니 Java 코드를 실행하고 디버깅해 보자. 필요에 따라 다음 방법을 쓸 수 있어:

Run

어떤 main 메서드 위에 표시되는 “Run” 링크를 클릭해 프로그램을 빠르게 실행해

Debug

Run and Debug 사이드바 패널을 열고 Run 버튼으로 애플리케이션을 시작해

Terminal

Maven 또는 Gradle 명령어로 커맨드 라인에서 실행해

Spring Boot

Spring Boot Dashboard 확장 기능에서 Spring Boot 애플리케이션을 바로 실행해

Java x Cursor 워크플로우

Cursor의 AI 기능은 Java 개발 워크플로우를 크게 끌어올려줘. 아래는 Java에 맞춰 Cursor를 활용하는 몇 가지 방법이야:

Tab Completion

메서드, 시그니처, getters/setters 같은 Java 보일러플레이트까지 똑똑한 자동 완성.

Agent Mode

디자인 패턴 구현, 코드 리팩터링, 올바른 상속 구조를 갖춘 클래스 생성.

Inline Edit

흐름을 끊지 않고 메서드 인라인 빠른 수정, 오류 해결, 단위 테스트 생성.

Chat

Java 개념 도움받기, 예외 디버깅, 프레임워크 기능 이해하기.

예시 워크플로우

  1. Java 보일러플레이트 생성
    Tab Completion을 사용해 생성자, getters/setters, equals/hashCode 메서드 등 반복적인 Java 패턴을 빠르게 생성해.
  2. 복잡한 Java 예외 디버깅
    난해한 Java 스택 트레이스를 마주하면 해당 부분을 선택하고 Ask로 근본 원인 설명과 가능한 수정안을 받아봐.
  3. 레거시 Java 코드 리팩터링
    Agent Mode를 사용해 오래된 Java 코드를 현대화해봐 — 익명 클래스를 람다로 바꾸고, 최신 Java 언어 기능으로 업그레이드하거나, 디자인 패턴을 적용해.
  4. 프레임워크 개발
    @docs로 너의 문서를 Cursor 컨텍스트에 추가하고, Cursor 전반에서 프레임워크 특화 코드를 생성해.