이 가이드는 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

메서드, 시그니처, 그리고 getter/setter 같은 Java 보일러플레이트를 위한 스마트 자동완성.

Agent Mode

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

Inline Edit

흐름 끊김 없이 메서드 인라인 수정, 오류 수정, 단위 테스트 생성.

Chat

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

예시 워크플로우

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