在 IntelliJ IDEA 中建立第一個專案

1. 逐步建立新專案

在 IntelliJ IDEA 中的專案不只是檔案夾，而是 IDE 用來儲存與你未來程式相關一切內容的完整容器。專案包含：

• 原始碼（副檔名為 .java 的檔案）；
• 專案設定（例如要使用哪個 Java 版本）；
• 外部函式庫（如有需要）；
• 輔助檔案與資源。

在專案中通常會有資料夾 src —— 這是放置你的 Java 檔案的主要位置。所有與程式碼無關的內容會分開儲存，不會干擾工作。

啟動 IntelliJ IDEA

在起始畫面，按下大型藍色按鈕 New Project。

設定專案參數

讓我們自上而下瀏覽主要欄位：

• Name: 專案名稱。此名稱也會用來在磁碟上建立資料夾。
• Location: 專案在電腦上的儲存路徑。預設 IDEA 會建議資料夾 IdeaProjects。保持預設即可。
• Create Git repository: 可立即為專案初始化 Git 版本控制。此階段為避免複雜化，先不要勾選。
• Build system: 建置系統是自動化編譯程式碼、管理相依與建立可執行應用程式的工具：
  • IntelliJ: IDEA 內建的建置系統。本次建議選用。
  • Maven/Gradle: 功能強大的獨立建置系統，99% 的實際專案會使用其中之一。
• Add sample code: IDEA 會自動為我們建立基本的專案結構以及包含 main 方法的類別。

透過 IntelliJ IDEA 安裝 JDK

現在輪到安裝 JDK 了。

• 由於尚未安裝，清單會是空的。我們的目標是直接在這裡下載它。

1. 點選下拉清單，選擇 Download JDK...

2. 會跳出一個小視窗：

• Version: 選擇 Java 版本。本課程支援 25 版。
• Vendor: 發行商。依我們先前所述，選擇 Amazon Corretto。
• Location: IDEA 下載並安裝此 JDK 的路徑。可保留預設值。

3. 按下 Select。

設定完成。按下 Create。

IntelliJ IDEA 會開始下載所選的 JDK，之後建立專案結構並開啟主編輯器視窗。需要等待幾分鐘。

首次啟動時，你可能會在右下角看到來自 IDEA 的通知，建議你設定防毒軟體，例如「Microsoft Defender may affect IDE performance」。請放心點擊 Exclude folders。IntelliJ IDEA 會自動把專案資料夾與其系統資料夾加入防毒的排除清單。

首次啟動程式時，你會看到一個橫幅通知，告知已啟用 Ultimate 免費試用期。這是 IntelliJ IDEA 新統一版本中的標準歡迎訊息。

此通知僅確認你現在擁有 Ultimate 的臨時存取權限，但對於我們的課程來說，這是一個非必要的附加功能。

2. IDEA 簡介

我們已建立新專案。來看看畫面上有哪些內容。

1. Project 瀏覽專案結構的主要面板。

2. 目前開啟的檔案 Main.java

3. 用於 Run ▶（執行）與 Debug（除錯）程式的按鈕

4. 側邊選單

• Services 分頁用於管理外部服務，入門階段用不到。
• Terminal 是你的作業系統（Windows、macOS、Linux）的命令列（主控台），直接內建在 IDE 中。
• Problems 面板會在撰寫程式碼的同時顯示編譯錯誤與警告。IDEA 會即時分析你的程式碼並以底線標示問題處，經常也會提供自動修正。
• Git 以分叉圖示呈現。此面板用於與 Git 版本控制系統互動。

3. 專案結構

接著仔細看看左側的專案結構。IntelliJ IDEA 為我們建立了數個重要的檔案與資料夾。

• .idea - 這是 IntelliJ IDEA 的工作用資料夾，存放此專案特有的設定。
  不需要手動修改或傳給其他開發者。它對每位使用者都是獨一無二的。
• src - 任何 Java 專案中最重要的資料夾。名稱是「sources」（原始碼）的縮寫。你的所有程式碼都會放在這裡。
  • Main.java 由於我們勾選了「Add sample code」，IDEA 幫我們建立了此檔案。這是一個具有程式「進入點」—— 方法 public static void main(String[] args) 的 Java 類別。任何 Java 程式都從這裡開始執行。
• .gitignore - Git 版本控制的設定檔。
• External Libraries - 這不是實體資料夾，而是專案所連結的所有外部函式庫的虛擬呈現。現在裡面只有一個、也是最重要的函式庫——我們的 JDK。

4. 執行程式

最令人愉快的事情，就是執行程式並看到自己努力的成果（而不只是錯誤）。

在視窗上方按下 Run ▶。其左側會顯示將要執行的檔名（在我們的例子中是 Current File）：

替代方式：在檔案上按右鍵 ▶ Run，選擇 Run 'Main.main()'。

你會看到程式的執行結果

啟動命令（紅色）—— 這是 IntelliJ IDEA 為執行程式而組裝並傳給作業系統的命令。

這是直接呼叫我們下載的 JDK 中的可執行檔 java.exe。正是這個檔案啟動 Java 虛擬機（JVM）。而 java.exe 後面的其餘部分則是服務性參數。

程式輸出（藍色）就是你的程式碼所產生的有用輸出。

結束代碼（綠色）Process finished with exit code 0。這則訊息是關於程式如何結束的最終報告。

• 依慣例，exit code 0 表示程式從頭到尾成功執行並正常結束，沒有任何錯誤。
• 任何其他代碼都表示在執行過程中發生了錯誤。

請務必留意這一行。它是判斷你的程式是「當掉」還是正常結束的主要指標。

此外，首次執行後，左側的專案結構中會出現新的資料夾 out。裡面放的是編譯後的 .class 檔案——也就是 JVM 執行的位元組碼。

恭喜！你剛剛已在專業的 IDE 中用 Java 編寫並執行了你的第一個程式。

IDEA 中程式啟動的運作方式

當你點擊 Run 時，會發生以下步驟：

1. IDEA 會編譯你的程式碼 —— 將 .java 轉為 .class（JVM 的位元組碼）。
2. 啟動 JVM —— Java 虛擬機會從 main 方法開始執行程式。
3. 輸出結果 —— 透過 System.out.println 印出的內容會出現在主控台。

這一切只需點幾下——不必手動呼叫編譯器，也不必四處尋找檔案存在哪裡。

5. IntelliJ IDEA keyboard shortcuts

IntelliJ IDEA 為多數與編輯、導覽、重構、除錯及其他任務相關的命令，都提供了鍵盤快速鍵。記住這些快速鍵能幫助你提高工作效率，雙手不必離開鍵盤。

你可以在 JetBrains 文件中查閱快速鍵組合，並可選擇對應的作業系統。

或直接在 IDEA 內查看。Menu → Help → Keyboard shortcuts PDF。

6. 建立第一個專案時的常見錯誤

在非 src 資料夾中建立了 Java 檔案

在 Java 世界有一條鐵律：資料夾 src —— 是你專案所有原始碼的根目錄。開發環境與建置系統都預期要在此找到程式碼。

類別名稱與檔名不一致
檔名必須與類別相同（包含大小寫）。例如，類別 Main 的檔名應為 Main.java。如果你把檔名寫成 main.java（小寫），編譯器會報錯。

遺漏或錯寫了 main 方法
方法必須精確為 public static void main(String[] args)。即使一個小錯字，程式也無法啟動。

未為專案選擇 JDK
若在建立專案時未選擇 JDK，或選錯路徑，IDEA 將無法編譯專案。請透過 File → Project Structure → Project SDK 檢查設定。

路徑中含有空白或西里爾字母
雖然現代系統寬容度更高，黃金法則依舊：專案與 JDK 的路徑請勿包含西里爾字母、空白或特殊符號。最好僅使用拉丁字母與底線。

啟動了錯誤的類別
如果你有多個包含 main 方法的類別，請確認你執行的是正確的檔案（右鍵 → ▶ Run）。