文檔維護痛點 傳統模式：代碼與文檔分離 → 修改代碼後須同步更新文檔 → 極易脫節、過時、遺漏。 Javadoc 解決方案 代碼與文檔「鏈接」：置於同一檔案

基本格式 起始：/** 結束：*/ 僅此格式被 Javadoc 識別，普通 /* */ 或 // 會被忽略 兩種內容形式 嵌入 HTML：直接撰寫 HT

核心能力 Javadoc 直接將 HTML 標籤傳遞至生成的 HTML 文檔，充分發揮 HTML 排版威力。 常用範例 代碼區塊：<pre>

三種引用格式 @see 類名 // 同包內類 @see 完整類名 // 跨包類，含包路徑

@version：版本資訊 @version 版本資訊字串 // 如：@version 1.2.3, 2024-01-15 執行 javadoc -ver

@param：參數說明 @param 參數名 說明文字 // 可跨多行，遇到下一標籤結束 每個參數一個標籤，順序建議與方法簽名一致。 @return：返回

類名：PascalCase（大駝峰） 首字母大寫 多單詞緊湊連接，無下劃線 每個嵌入單詞首字母大寫 class AllTheColorsOfTheRain

運算符本質 接受一個或多個運算元 產生一個新值（如 a + b 產生和） 形式不同於方法呼叫，效果相同 副作用 運算符可能改變運算元的值，這稱為「副作用」

核心原則 運算符優先級決定多運算符表達式的計算順序。Java 有明確規定，但規則繁多，程式設計師應主動使用括號明確意圖，而非依賴記憶。 最基礎且關鍵的規則

基本類型：值複製，相互獨立 int a = 4; int b = a; // 複製值 4 b = 7; // a 仍為 4，不受影響 基本類型儲

基本五大運算 +、-、*、/、%（取模/餘數） 整數除法：直接截斷小數位，不四捨五入 複合賦值運算符 +=、-=、*=、/=、%=：x += 4 等同 x

兩種形式，關鍵差異在「取值時機」 形式語法操作順序表達式值 前綴++i / --i先運算，後取值運算後的值 後綴i++ / i--先取值，後運算運算前的值

基本關係運算符 產生 boolean 結果：<、>、<=、>=、==、!=。 ==/!= 適用所有內建類型，其他比較不適用 boolea

基本規則 僅適用於 boolean 型別 C/C++ 允許非零整數作真值，Java 嚴格禁止，編譯期直接報錯 關係運算產生 boolean，再進行邏輯運算 b

核心邏輯（雙輸入位運算） 運算符名稱輸出 1 的條件 &按位 AND兩輸入位皆為 1 |按位 OR至少一輸入位為 1 ^按位 XOR（異或）兩輸入位恰

三種移位運算符 運算符名稱行為高位填充 <<左移向左移動指定位數低位補 0 >>有號右移向右移動指定位數符號擴展：正補 0、負補 1

語法結構 布林表達式 ? 值0 : 值1 條件為 true → 計算並返回「值0」 條件為 false → 計算並返回「值1」 與 if-else 的

特殊用途：字串連接 Java 中 + 運算符被賦予字串連接特殊語義。雖與數學加法不同，但語感自然。C++ 透過「運算符重載」實現類似功能，但過於複雜；Java

括號使用的重要性 運算符優先級複雜，即使對表達式求值順序有一絲不確定，也應主動加上括號，確保語義明確、程式碼可讀。 Java 編譯器阻擋的兩大經典陷阱 1.

什麼是造型？ 造型（Cast）意為「與一個模型匹配」。Java 會在適當時機自動轉換類型（如 int → float），但開發者可透過造型明確指定或強制進行轉換