How to start in Windows - AP-CSA-Practice/website-backend GitHub Wiki

Spring Boot 後端開發環境設置指南

1. 確認 Java 安裝

java -version
javac -version

2. 安裝開發工具

推薦選項:IntelliJ IDEA Community Edition

  • 前往 JetBrains 官網
  • 下載免費的 Community Edition
  • 安裝後會自動支援 Spring Boot

替代選項:Visual Studio Code

# 需要安裝 Java 相關擴充套件
- Extension Pack for Java
- Spring Boot Extension Pack

3. 建立 Spring Boot 專案

方法一:使用 Spring Initializr(推薦)

設定如下:

  • Project: Maven
  • Language: Java
  • Spring Boot: 3.2.x(最新穩定版)
  • Group: com.example
  • Artifact: demo
  • Packaging: Jar
  • Java: 17 或 21

新增依賴項:

  • Spring Web
  • Spring Boot DevTools
  • Spring Data JPA(如果需要資料庫)
  • H2 Database(測試用資料庫)

點擊「Generate」下載專案。

螢幕擷取畫面 2025-05-30 222208


4. 匯入並執行專案

# 解壓縮下載的檔案
cd demo

# 檢查 wrapper 資料夾內容
ls .\.mvn\wrapper\

# 應該看到兩個檔案:
# - maven-wrapper.properties
# - maven-wrapper.jar

# 下載如果缺少的maven-wrapper.jar
$url = "https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar"
Invoke-WebRequest -Uri $url -OutFile ".\.mvn\wrapper\maven-wrapper.jar"

# 測試 Maven Wrapper 是否正常
.\mvnw.cmd --version

# 清理並編譯專案 
# 如果成功,會看到 "BUILD SUCCESS"
.\mvnw.cmd clean compile

# 執行專案
# 網址是: http://localhost:8080
./mvnw spring-boot:run
# 按下CTRL+C即可停,若要重啟則再次輸入以上

5.Installing MongoDB on Windows

  1. Download the MongoDB Community Server from the official website:
    https://www.mongodb.com/try/download/community

  2. Run the installer and follow the setup wizard:

    • Choose “Complete” installation.
    • Select “Install MongoDB as a Service”.
    • (Optional but recommended) Check the box to install MongoDB Compass, the GUI for MongoDB.
  3. (Optional) Add MongoDB’s bin folder to your system PATH:
    Typically located at:
    C:\Program Files\MongoDB\Server\<version>\bin

  4. Open a new terminal (Command Prompt or PowerShell) and run:

    mongod --version
    

    to confirm MongoDB is installed.

  5. Launch MongoDB Compass to visually explore and manage your MongoDB databases.

⚠️ **GitHub.com Fallback** ⚠️