本指南會帶你把 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,並將 JAVA_HOME\bin 加入你的 PATH。

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. 將 %MAVEN_HOME%\bin(Windows)或 $MAVEN_HOME/bin(Unix)加入 PATH

Gradle

確認已安裝 Gradle(gradle -version)。如需安裝,請從 gradle.org 取得:
  1. 下載二進位發行版
  2. 解壓縮到目標位置
  3. 將 GRADLE_HOME 環境變數設定為解壓後的資料夾
  4. 將 %GRADLE_HOME%\bin(Windows)或 $GRADLE_HOME/bin(Unix)加入 PATH
或者,使用 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 程式碼——將匿名類別改為 lambda、升級到較新的 Java 語言功能,或實作設計模式。
  4. 框架開發
    用 @docs 把你的文件加入 Cursor 的脈絡,並在 Cursor 中生成各框架專屬的程式碼。