Refactoring重構教學

Refactoring(重構)教學手冊 文件版本:v2.0(2026-10-13) 作者:資深軟體架構師團隊 適用對象:Java/TypeScript 開發人員、Tech Lead、程式碼審查者、使用 AI 程式助理的工程師 技術基準:Java 25 LTS、JUnit 6、Maven 3.9、TypeScript 6/7、IntelliJ IDEA 2026.2(詳見 0.3) 定位:教學手冊——以「把人教會」為目標,每個觀念都有逐步操作、可執行的範例與練習;規則以 RFT-* 編號,可直接當作審查 AI 產出的檢核依據 目錄 0. 文件資訊與學習指南 0.1 為什麼要學重構 0.2 讀者與學習路徑 0.3 技術基準版本 0.4 規則格式與驗證圖示 0.5 範例的閱讀方式 0.6 與其他文件的關係 0.7 名詞約定 1. 重構基本概念 1.1 什麼是重構 1.2 可觀察行為的界定 1.3 重構的目標與效益 1.4 重構與其他變更的區別 1.5 國際標準與業界參考 1.6 實務案例:一次「不是重構」的重構 2. 重構的基本原則 2.1 兩頂帽子 2.2 小步前進與每步驗證 2.3 重構的時機 2.4 何時不該重構 2.5 安全重構的流程 2.6 Tidy First:整理的經濟學 2.7 實務注意事項 3. 識別壞味道(Code Smells) 3.1 什麼是程式碼壞味道 3.2 Fowler 第二版的 24 種壞味道 3.3 膨脹類壞味道 3.3.1 過長函式(Long Function) 3.3.2 過長參數列(Long Parameter List) 3.3.3 過大類別(Large Class) 3.3.4 資料泥團與基本型別偏執(Data Clumps/Primitive Obsession) 3.4 阻礙修改類壞味道 3.5 耦合類壞味道 3.6 可有可無類壞味道與註解 3.7 資料與狀態類壞味道 3.8 壞味道的量化指標 3.9 壞味道識別工具 3.9.1 靜態分析工具 3.9.2 IDE 內建工具 4. 基本重構手法 4.1 提煉函式與內聯函式(Extract Function/Inline Function) 4.2 提煉變數與內聯變數(Extract Variable/Inline Variable) 4.3 改名(Rename Variable/Rename Field) 4.4 改變函式宣告(Change Function Declaration) 4.5 引入參數物件(Introduce Parameter Object) 4.6 封裝變數、以查詢取代暫存變數與拆分變數 4.7 搬移語句與拆分迴圈(Slide Statements/Split Loop) 4.8 以具名常數取代魔術字面值(Replace Magic Literal) 4.9 拆分階段與函式組合(Split Phase/Combine Functions into Class) 4.10 以命令取代函式(Replace Function with Command) 4.11 重構方法選擇流程 4.11.1 重構決策樹 4.11.2 重構優先順序指南 5. 搬移特性與組織資料 5.1 搬移函式(Move Function) 5.2 搬移欄位(Move Field) 5.3 提煉類別與內聯類別(Extract Class/Inline Class) 5.4 隱藏委託與移除中間人(Hide Delegate/Remove Middle Man) 5.5 以物件取代基本型別(Replace Primitive with Object) 5.6 移除無用程式碼(Remove Dead Code) 5.7 封裝集合與封裝記錄(Encapsulate Collection/Encapsulate Record) 5.8 值物件與參照物件、以查詢取代衍生變數 6. 簡化條件邏輯 6.1 分解條件式(Decompose Conditional) 6.2 合併條件式(Consolidate Conditional Expression) 6.3 以衛述句取代巢狀條件式(Replace Nested Conditional with Guard Clauses) 6.4 以多型取代條件式(Replace Conditional with Polymorphism) 6.5 引入特例(Introduce Special Case) 6.6 引入斷言與以 break 取代控制旗標 7. API 與繼承重構 7.1 將查詢與修改分離(Separate Query from Modifier) 7.2 移除旗標參數與函式參數化(Remove Flag Argument/Parameterize Function) 7.3 保留完整物件與以查詢取代參數(Preserve Whole Object/Replace Parameter with Query) 7.4 以工廠函式取代建構式(Replace Constructor with Factory Function) 7.5 以例外取代錯誤碼(Replace Error Code with Exception) 7.6 繼承結構重構:上移、下移、提煉父類別與摺疊階層 7.7 以委託取代繼承(Replace Superclass/Subclass with Delegate) 7.8 公開函式庫的相容性檢查 8. 重構與測試:建立安全網 8.1 重構的安全網:為什麼測試是前提 8.2 特性測試(Characterization Test) 8.3 核准測試(Approval Test) 8.4 覆蓋率與變異測試 8.4.1 覆蓋率的意義與限制 8.4.2 用變異測試檢查安全網 8.5 重構友善的測試設計 8.6 等價性驗證:同一組測試驗證重構前後 8.7 重構測試檢查清單 9. TDD 與重構 9.1 紅燈—綠燈—重構循環詳解 9.2 實際 TDD 重構範例 9.3 重構測試程式碼 10. 遺留程式碼的重構 10.1 遺留程式碼變更演算法 10.2 接縫(Seam) 10.3 Sprout 與 Wrap:讓新程式碼保持可測試 10.4 打破相依的常用手法 10.5 Mikado 方法 10.6 探索性重構(Scratch Refactoring) 11. 大型與架構層級的重構 11.1 漸進式重構與大爆炸重寫 11.2 Strangler Fig 與平行執行 11.3 Branch by Abstraction 11.4 架構守護:用 ArchUnit 把規則寫成測試 11.5 功能旗標的生命週期 12. 資料庫與 API 的演進式重構 12.1 為什麼不能一次改名 12.2 擴充—遷移—收縮(Expand–Migrate–Contract) 12.3 API 的演進 12.4 事件與訊息格式的演進 13. Java 現代化重構 13.1 現代化的原則 13.2 sealed 型別與模式比對 switch 13.3 以 record 取代資料類別 13.4 以管線取代迴圈(Replace Loop with Pipeline) 13.5 Optional 的使用 13.6 文字區塊與其他語法 13.7 用 OpenRewrite 自動化現代化 14. 前端 TypeScript 重構 14.1 TypeScript 重構的安全網 14.2 以可辨識聯集取代型別碼 14.3 || 與 ??、&& 與 ?. 的差異 14.4 Promise 鏈改寫為 async/await 14.5 以 unknown 取代 any 14.6 以 codemod 進行大量修改 15. 重構工具與自動化 15.1 IDE 的自動化重構 15.2 靜態分析與品質門檻 15.3 CI 中的重構守護 15.4 編譯器警告與棄用追蹤 15.5 RefactoringMiner:在審查時辨識重構 15.6 工具選擇與配置 16. 效能與重構 16.1 重構與效能的關係 16.2 用 JMH 量測 16.3 效能監控與回歸 16.4 重構常見的效能退化 17. 團隊規範與最佳實務 17.1 重構的責任分配與協作 17.2 提交與 PR 的規範 17.3 程式碼審查中的重構 17.3.1 審查檢查清單 17.3.2 審查技巧:辨識搬移的程式碼 17.4 重構標準與約定 17.4.1 命名規範 17.4.2 程式碼組織約定 17.5 持續重構的團隊文化 17.5.1 重構意識培養 17.5.2 工具與流程整合 17.5.3 團隊重構最佳實務 17.6 重構培訓計畫 17.6.1 新人重構訓練 17.6.2 技能評估標準 18. AI 輔助重構 18.1 AI 輔助重構的機會與風險 18.2 給 AI 的重構提示 18.3 專案層級的 AI 指示檔 18.4 驗證 AI 產出的流程 18.5 AI 常見的重構錯誤 18.6 AI 代理的批次重構 19. 技術債管理與重構的度量 19.1 技術債與技術債象限 19.2 技術債登錄 19.3 熱點分析:決定先重構哪裡 19.4 重構的時機與投資配置 19.4.1 主動重構與被動重構 19.4.2 重構優先順序矩陣 19.4.3 容量配置 19.5 重構效益的評估與度量 20. 重構的反模式與常見陷阱 20.1 流程上的反模式 20.2 程式碼上的反模式 20.3 測試上的反模式 20.4 AI 協作的反模式 21. 綜合案例:活動票券對帳單 21.1 起點:需求與現有程式碼 21.2 建立安全網 21.3 重構步驟 21.4 重構後的程式碼 21.5 加入新功能 22. 練習與自我評量 22.1 能力評量架構 22.1.1 觀念能力 22.1.2 實作能力 22.2 觀念選擇題 22.3 情境分析題 22.4 程式碼重構實作題 22.4.1 Kata 1:會員點數(Java) 22.4.2 Kata 2:價格標籤(TypeScript) 22.5 AI 產出審查演練 22.6 綜合演練 22.7 評分基準 22.8 學習建議 23. 檢查清單 23.1 重構前檢查清單 23.1.1 環境準備 23.1.2 範圍評估 23.2 重構執行檢查清單 23.2.1 執行原則 23.2.2 常見重構步驟 23.3 重構後檢查清單 23.3.1 功能驗證 23.3.2 品質檢查 23.3.3 交付準備 23.4 緊急應對檢查清單 23.4.1 問題發現 23.4.2 修復策略 23.5 持續改善檢查清單 23.5.1 定期檢視 23.5.2 工具和流程優化 23.6 AI 產出審查檢查清單 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 手法速查表 B.1 Fowler 第二版重構目錄對照 B.2 依壞味道查手法 B.3 IDE 快捷鍵速查 附錄 C 設定檔與腳本 C.1 範例專案的 pom.xml C.2 PMD 規則集 C.3 Checkstyle 設定 C.4 GitHub Actions:重構型 PR 的守護流程 C.5 equivalence-check.sh C.6 refactor-guard.sh C.7 重構提案範本 附錄 D 名詞對照 附錄 E 參考資料 E.1 延伸閱讀:書籍 E.2 國際標準與規範 E.3 研究報告 E.4 線上資源 E.5 工具推薦 附錄 F 修訂紀錄與查證紀錄 F.1 v1.0 章節對照 F.2 v1.0 內容更正紀錄 F.3 查證紀錄 F.4 待確認事項 F.5 技術版本紀錄 0. 文件資訊與學習指南 0.1 為什麼要學重構 重構(refactoring)是「在不改變軟體可觀察行為的前提下,改善其內部結構」的一連串小步驟。它是每位工程師每天都在做的事,卻也最容易做錯: ...

October 31, 2025 · 149 min · 31539 words · Eric Cheng

spec-kit使用教學

Spec-Kit 使用教學手冊 版本: 18.0 最後更新: 2026年10月30日 適用於: Spec-Kit v1.2.5(2026-10-28 發布);指令與旗標以 v1.2.5 原始碼與官方文件為準 文件等級: 企業標準技術白皮書 Created by: Eric Cheng 摘要 Spec-Driven Development(SDD,規格驅動開發)把「規格」從容易過時的輔助文件,重新定位為驅動實作的主要工件:程式碼是規格的產物,規格不再只是事後補寫的說明。Spec-Kit 是 GitHub 以此理念開源的工具組。它的官方定位已從「SDD 工具」擴大為「讓 AI 編碼代理遵循結構化流程、可重用模板並留下可稽核成果的工具組」。目前內建三條彼此獨立的流程入口: 你要做的事 流程 成果 建立功能或應用程式 Spec-Driven Development(核心內建) 一份規格,經計畫、實作到收斂檢查 診斷並修復錯誤行為 Bug fixing(bug 擴充,選用) 有證據的根因、受控範圍的修正與驗證紀錄 判斷某個想法值不值得投入 Idea assessment(assess 擴充,選用) go/needs-clarification/kill 的證據化決策 此外,團隊可以透過 Extension、Preset、Workflow、Bundle 與 Catalog 五種機制,改造既有流程或組裝自己的流程。 本手冊面向在企業共用平台(多資料庫、微服務、微前端、批次與檔案傳輸整合)導入 AI 輔助開發的技術團隊。內容依「方法論 → 安裝與升級 → 守則與模板 → 核心流程 → 修錯與評估流程 → 客製化 → 企業治理 → 實務案例 → 常見陷阱 → 附錄」的順序展開。每一個環節都附上範例,以及「AI 產出後,人要如何審查與驗證」的具體檢查方法。全書以 Spec-Kit v1.2.5 為基準,逐項核對官方 README、spec-driven.md、docs/upgrade.md、CHANGELOG、文件站(github.github.io/spec-kit)與 v1.2.5 tag 的原始碼。核對過程與修正清單記錄在附錄 F。 ...

October 31, 2025 · 91 min · 19185 words · Eric Cheng

spec-kit使用教學

Spec-Kit 使用教學手冊 版本: 1.0 最後更新: 2025年10月29日 適用於: Spec-Kit v0.0.79+ Created by: Eric Cheng 📚 目錄 前言 目的與適用對象 背景說明:為何採用 SDD + Spec-Kit → AI 助手流程 本手冊使用假設 第一章:概念理解 1.1 SDD 是什麼? 1.2 Spec-Kit 概覽 1.3 SDD 中的關鍵 artefacts(工件) 1.4 流程概覽:SDD 的階段/步驟 1.5 為什麼這對我們團隊/共用平台開發特別有價值 第二章:環境準備 2.1 前置條件 2.2 安裝 Spec-Kit CLI 2.3 建立專案與初始化 2.4 建立團隊守則 (Constitution) 2.5 模板與提示文件說明 2.6 GitHub 倉庫分支與版本控制建議 第三章:使用流程詳細說明 3.1 Step 1:撰寫 Spec (/speckit.specify) 3.2 Step 1a:澄清模糊需求 (/speckit.clarify) 3.3 Step 2:撰寫 Plan (/speckit.plan) 3.4 Step 3:拆分 Tasks (/speckit.tasks) 3.5 Step 4:預實作檢查 (/speckit.analyze + /speckit.checklist) 3.6 Step 5:實作 (/speckit.implement) 3.7 Step 6:迭代維護 第四章:實務案例與應用指引 4.1 案例一:Greenfield 開發 - 新建交易記錄微服務 4.2 案例二:Brownfield 整合 - 為既有系統新增功能 4.3 團隊協作:多人開發 4.4 AI 助手最佳實踐 4.5 平台導入建議 第五章:常見問題與陷阱 5.1 常見問題(FAQ) 5.2 常見陷阱與避免方法 第六章:附錄 6.1 完整模板範例 6.2 檢查清單 6.3 參考資源 6.4 術語表 6.5 快速指令參考 結語 前言 目的與適用對象 本手冊旨在幫助開發團隊快速掌握 Spec-Driven Development (SDD) 方法論,並透過 Spec-Kit 工具組與 AI 助手協作,建立高品質、可維護的軟體系統。 ...

October 31, 2025 · 76 min · 16041 words · Eric Cheng

Spring Boot 教學

Spring Boot 教學手冊 文件資訊 作者: 技術團隊 版本: 1.0 更新日期: 2025-08-31 目標對象: 新進開發同仁、Spring Boot 初學者、認證考試準備者 目錄 Spring Boot 簡介 1.1 什麼是 Spring Boot? 1.2 Spring Boot 的核心特點 1.3 Spring Boot vs Spring Framework 1.4 專案常見應用場景 1.5 Spring Boot 版本選擇 1.6 章節小練習 1.7 實務注意事項 開發環境建置 2.1 系統需求 2.2 JDK 安裝與設定 2.3 Maven 安裝與設定 2.4 IDE 設定 2.5 Spring Initializr 使用 2.6 開發工具設定 2.7 專案建立實作 2.8 執行與測試 2.9 章節小練習 2.10 實務注意事項 Spring Boot 基礎 3.1 專案結構 3.2 Application Properties 設定 3.3 依賴注入 (Dependency Injection) 3.4 Spring Boot Starter 3.5 Bean 生命週期與作用域 3.6 Profile 環境管理 3.7 章節小練習 3.8 實務注意事項 RESTful API 開發 ...

October 31, 2025 · 52 min · 10928 words · Eric Cheng

Spring Framework教學

Spring Framework 教學手冊 目錄 Spring Framework 概述 1.1 什麼是 Spring Framework 1.2 Spring 生態系統 1.3 為什麼使用 Spring Framework 1.4 認證考點提示 1.5 實務案例 核心概念 2.1 控制反轉 (Inversion of Control, IoC) 2.2 依賴注入 (Dependency Injection, DI) 2.3 Bean 的概念 IoC 容器與依賴注入 3.1 IoC 容器深入解析 3.2 BeanFactory vs ApplicationContext 3.2.1 BeanFactory 3.2.2 ApplicationContext 3.3 Bean 定義與註冊 3.3.1 註解驅動的配置 3.3.2 Java 配置方式 3.4 依賴注入的進階特性 3.4.1 條件式注入 3.4.2 Qualifier 與 Primary 3.5 Bean 生命週期 3.6 ApplicationContext 事件機制 3.6.1 內建事件 3.6.2 自定義事件 3.7 認證考點提示 3.8 實務案例 Bean 管理 4.1 Bean 的作用域 4.1.1 Singleton 作用域 4.1.2 Prototype 作用域 4.1.3 Web 作用域 4.2 Bean 的初始化和銷毀 4.2.1 初始化方法 4.2.2 銷毀方法 4.3 Bean 的延遲初始化 4.4 條件式 Bean 創建 4.4.1 內建條件註解 4.4.2 自定義條件 4.5 Profile 環境配置 4.6 Factory Bean 模式 4.7 認證考點提示 4.8 實務案例 面向切面程式設計 (AOP) ...

October 31, 2025 · 73 min · 15420 words · Eric Cheng

SQL使用教學

SQL 使用教學手冊 目錄 1. SQL 基礎入門 1.1 什麼是 SQL? 1.2 SQL 的特點 1.3 SQL 語句分類 1.4 第一個 SQL 查詢 2. 資料庫基本概念 2.1 關聯式資料庫模型 2.2 基本概念解釋 2.3 資料類型 2.4 正規化(Normalization) 3. 基本查詢語法 3.1 SELECT 語句基礎 3.2 查詢所有欄位 3.3 查詢特定欄位 3.4 WHERE 條件查詢 3.5 排序 ORDER BY 3.6 限制結果筆數 3.7 去除重複 DISTINCT 4. 進階查詢技巧 4.1 聚合函數 4.2 GROUP BY 分組查詢 4.3 HAVING 分組篩選 4.4 JOIN 表格連接 4.5 子查詢(Subquery) 4.6 WITH 公用表格表達式(CTE) 4.7 視窗函數(Window Functions) 5. 資料操作語言 (DML) 5.1 INSERT - 新增資料 5.2 UPDATE - 更新資料 5.3 DELETE - 刪除資料 5.4 UPSERT - 插入或更新 5.5 批次處理最佳實務 6. 資料定義語言 (DDL) 6.1 CREATE - 建立資料庫物件 6.2 ALTER - 修改資料庫物件 6.3 DROP - 刪除資料庫物件 6.4 TRUNCATE - 清空表格 6.5 資料類型選擇指南 6.6 表格設計最佳實務 6.7 效能考量 7. 交易處理與併發控制 7.1 交易基本概念 7.2 交易控制語句 7.3 交易隔離等級 7.4 併發問題與解決方案 7.5 鎖定機制 7.6 實務交易處理模式 8. 索引與效能優化 8.1 索引基本概念 8.2 索引類型 8.3 索引設計策略 8.4 查詢效能分析 8.5 查詢優化技巧 8.6 分割與分片 8.7 效能監控與維護 9. 儲存程序與函數 9.1 儲存程序基礎 9.2 函數 9.3 控制流程結構 9.4 例外處理 10. 安全性與防護 10.1 SQL Injection 防護 10.2 存取控制與權限管理 10.3 資料加密 10.4 稽核與監控 11. 專案實務案例 11.1 電商系統資料庫設計 11.2 常用業務查詢 11.3 效能優化實作 12. 認證考試準備 12.1 Oracle SQL 認證要點 12.2 Microsoft SQL Server 認證要點 12.3 PostgreSQL 認證要點 12.4 IBM DB2 認證要點 12.5 認證考試技巧 13. 最佳實務與故障排除 13.1 常見錯誤與解決方案 13.2 效能優化建議 13.3 開發最佳實務 13.4 資源推薦 前言 歡迎來到 SQL 的世界!SQL(Structured Query Language,結構化查詢語言)是與資料庫溝通的標準語言。無論您是新進的開發同仁,還是希望深化資料庫技能的工程師,這份教學手冊都將帶您從零開始,循序漸進地掌握 SQL 的精髓。 ...

October 31, 2025 · 72 min · 15202 words · Eric Cheng

Thymeleaf使用教學

Thymeleaf 使用教學手冊 目錄 基礎概念 1.1 什麼是 Thymeleaf? 1.2 核心特色 1.2.1 自然模板特性 1.2.2 表達式豐富性 1.3 與其他模板引擎比較 1.3.1 詳細比較表 1.4 適用場景 1.5 工作流程 1.6 實務注意事項 環境建置 2.1 Spring Boot 專案整合 2.1.1 Maven 設定 2.1.2 Gradle 設定 2.2 目錄結構設定 2.3 應用程式設定 2.3.1 基本設定 (application.yml) 2.3.2 生產環境設定 (application-prod.yml) 2.4 IDE 設定 2.4.1 IntelliJ IDEA 設定 2.4.2 VS Code 設定 2.5 驗證安裝 2.5.1 建立控制器 2.5.2 建立模板 2.5.3 啟動應用程式 2.6 開發環境最佳化 2.6.1 熱重載設定 2.6.2 除錯設定 2.7 常見安裝問題 語法教學 3.1 基本標籤語法 3.1.1 文字輸出 (th:text) 3.1.2 HTML 輸出 (th:utext) 3.1.3 條件判斷 (th:if, th:unless) 3.1.4 迴圈遍歷 (th:each) 3.1.5 條件選擇 (th:switch, th:case) 3.2 屬性處理 3.2.1 設定屬性 (th:attr) 3.2.2 常用屬性快捷方式 3.2.3 CSS 類別處理 (th:classappend) 3.3 表達式語法 3.3.1 變數表達式 (${…}) 3.3.2 選擇表達式 (*{…}) 3.3.3 連結表達式 (@{…}) 3.3.4 訊息表達式 (#{…}) 3.3.5 片段表達式 (~{…}) 3.4 內建工具物件 3.4.1 日期工具 (#dates) 3.4.2 數字工具 (#numbers) 3.4.3 字串工具 (#strings) 3.4.4 集合工具 (#lists, #sets, #maps) 3.5 實務注意事項 3.6 模板繼承與片段 3.6.1 片段定義與使用 (th:fragment) 3.6.2 片段插入方式 3.6.3 佈局模板系統 3.6.4 參數化片段 3.6.5 片段選擇器 3.7 實務注意事項 3.8 表單處理 3.8.1 基本表單綁定 3.8.2 下拉選單處理 3.8.3 核取方塊處理 3.8.4 單選按鈕處理 3.8.5 檔案上傳處理 3.8.6 表單驗證錯誤處理 3.9 國際化 (i18n) 支援 3.9.1 設定國際化 3.9.2 訊息資源檔案 3.9.3 在模板中使用國際化 3.9.4 Java 程式碼中的國際化 3.9.5 日期和數字本地化 3.9.6 進階國際化實作 3.9.7 多語言最佳實務 3.10 實務注意事項 實務應用範例 ...

October 31, 2025 · 45 min · 9455 words · Eric Cheng

Vim使用教學

Vim 使用教學手冊 目錄 前言 Vim 在專案中的角色 為什麼要學習 Vim 本手冊的學習方式與使用建議 第一篇:Vim 基礎入門 1. Vim 簡介 2. 安裝與環境設定 3. Vim 的操作模式 4. 文字編輯基礎 5. 檔案操作 第二篇:進階編輯技巧 6. 搜尋與取代 7. 巨集與自動化 8. 多檔案編輯與快速導覽 9. 文本處理進階 第三篇:專案開發實務 10. Vim 與程式開發 11. 插件管理 12. Git 與版本控制整合 13. 日常開發案例 第四篇:考試與認證準備 14. Vim 認證簡介 15. 模擬練習題 16. 學習路線圖 附錄 Vim 常用快捷鍵速查表 常見錯誤排解 推薦書籍與網站 練習建議 檢查清單(Checklist) 新進成員 Vim 技能檢查清單 團隊協作檢查清單 系統管理檢查清單 持續改進檢查清單 前言 Vim 在專案中的角色 在現代軟體開發專案中,Vim 扮演著重要的角色: Linux 伺服器管理必備工具:在產品環境中進行設定檔編輯、日誌查看、緊急修復 高效率文字編輯器:相較於圖形界面編輯器,Vim 在純文字環境下具有絕對優勢 跨平台一致性:無論在 Linux、macOS 或 Windows 環境,Vim 都能提供相同的操作體驗 與開發工具整合:許多現代 IDE 都提供 Vim 模式,學會 Vim 能提升整體開發效率 為什麼要學習 Vim mindmap root((為什麼學 Vim)) 效率提升 快速編輯 鍵盤操作 減少滑鼠依賴 專業需求 Linux 系統管理 遠端作業 伺服器維護 認證考試 LPIC RHCE CompTIA Linux+ 技能發展 文字處理專精 自動化能力 工具整合 本手冊的學習方式與使用建議 循序漸進:建議按章節順序學習,每章都有實作練習 動手實作:理論與實務並重,務必完成每章的練習題 日常應用:將學會的技巧應用到實際專案開發中 認證導向:標註的認證重點可作為考試準備參考 第一篇:Vim 基礎入門 1. Vim 簡介 簡介 Vim(Vi IMproved)是基於經典的 Vi 編輯器所改良的文字編輯器,是 Unix/Linux 系統中最重要的編輯工具之一。 ...

October 31, 2025 · 35 min · 7268 words · Eric Cheng

Visual Studio Code使用教學

Visual Studio Code 使用教學手冊 完整的 VS Code 開發環境設定與實戰指南 涵蓋前端 (Vue 3 + TypeScript) 與後端 (Spring Boot) 開發,適用於團隊協作與企業級專案開發 文件範圍與適用對象:本手冊面向前後端開發人員、平台/DevOps 工程師與 IT 治理團隊,內容涵蓋 VS Code 從安裝設定、日常開發、AI Agent 輔助開發,到團隊協作、企業級治理與部署維運的完整生命週期。文件依據 code.visualstudio.com/docs 官方文件系列查證撰寫,對應版本為 VS Code v1.134(2026 年 8 月);由於 GitHub Copilot/Agent 相關功能迭代速度遠快於核心編輯器(約每月釋出新版),第 3.6 節與第 6.9 節內容請視為該時間點的快照,正式導入前建議對照官方 Release Notes 複核最新異動。 📋 目錄 1. VS Code 安裝與環境設定 1.1 安裝步驟 1.2 推薦字型與主題 1.3 專案必要的 Extensions 清單 1.3.1 基礎開發工具 1.3.2 前端開發 1.3.3 後端開發 1.3.4 Python 開發 1.3.5 AI 輔助開發 1.3.6 一鍵安裝指令 1.4 設定同步功能 1.5 實務案例與注意事項 2. 專案開發環境配置 2.1 如何開啟專案 2.2 前端、後端工作區設定 2.3 編碼規範設定 2.3.1 前端編碼規範 (ESLint + Prettier) 2.3.2 後端編碼規範 (Checkstyle) 2.3.3 Maven 獨立安裝設定 2.4 容器化開發環境 (Dev Containers) 2.5 實務案例與注意事項 3. 日常開發操作 3.1 Git 與 GitHub/GitLab 整合 3.2 常用快捷鍵 3.3 偵錯與斷點設定 3.4 終端機與多工作區使用 3.5 程式碼片段 (Snippets) 使用 3.6 AI 輔助開發 — GitHub Copilot 3.6.1 程式碼自動完成與 Next Edit Suggestions 3.6.2 Copilot Chat 對話式助手 3.6.3 Inline Chat(行內聊天) 3.6.4 智慧動作 3.6.5 Agent 模式與工作階段 (Sessions) 3.6.6 權限與核准控制(含 Autopilot) 3.6.7 Plan Agent(計畫代理) 3.6.8 自訂指示檔 3.6.9 MCP 伺服器整合 3.6.10 Custom Agents(自訂代理) 3.6.11 Agent Skills(代理技能) 3.6.12 Prompt Files(提示檔案) 3.6.13 Hooks(生命週期鉤子) 3.6.14 語言模型選擇 3.6.15 Agent Plugins(代理外掛) 3.7 實務案例與注意事項 4. 專案特定開發流程指引 4.1 前端開發流程 4.2 後端開發流程 4.3 全端開發工作流程 4.4 程式碼品質檢查 4.5 效能監控與分析 4.6 實務案例與注意事項 4.7 Python 開發環境設定 4.7.1 Python 專案結構 4.7.2 Python 環境設定 4.7.3 Python 開發工具設定 4.7.4 Python 偵錯設定 4.7.5 Python 任務設定 4.7.6 Python 專案範例 4.7.7 Python 開發最佳實務 5. 協作開發功能 5.1 Live Share 即時協作 5.2 多人開發設定 5.3 程式碼審查工具 5.3.1 GitHub Pull Request 整合 5.3.2 GitLab Merge Request 整合 5.3.3 程式碼審查檢查清單 5.4 團隊協作最佳實務 6. 進階功能與擴充 6.1 自訂程式碼片段 6.2 擴充功能開發入門 6.3 工作流程自動化 6.3.1 Task 自動化 6.3.2 GitHub Actions 整合 6.3.3 GitLab CI/CD 整合 6.4 效能優化進階技巧 6.5 遠端開發與 SSH 6.6 工作區管理進階技巧 6.7 設定檔 (Profiles) 管理 6.8 Agent Customizations 編輯器 6.9 企業級管理與治理原則 (Enterprise Policies) 7. 最佳實務 7.1 常見問題 (FAQ) 與解決方式 7.2 建議的工作習慣 7.3 效能最佳化 7.4 安全性最佳實務 7.5 團隊協作規範 8. 檢查清單 8.1 新進成員快速上手檢查清單 8.2 日常開發檢查清單 8.3 部署前檢查清單 8.4 故障排除檢查清單 9. 附錄 9.1 參考資源 9.2 版本歷程 1. VS Code 安裝與環境設定 1.1 安裝步驟 1.1.1 下載與安裝 前往 Visual Studio Code 官方網站 點擊 “Download for Windows” 下載安裝檔 執行安裝檔,建議勾選以下選項: ✅ 新增至 PATH (在重新啟動後可用) ✅ 在檔案總管中的檔案上顯示「使用 Code 開啟」動作 ✅ 在檔案總管中的目錄上顯示「使用 Code 開啟」動作 ✅ 將 Code 註冊為支援的檔案類型的編輯器 1.1.2 首次啟動設定 啟動 VS Code 選擇適合的色彩主題 登入 Microsoft 帳戶(可選,用於同步設定) 1.2 推薦字型與主題 1.2.1 推薦字型 建議安裝並使用以下等寬字型: ...

October 31, 2025 · 48 min · 10139 words · Eric Cheng

Visual Studio Code使用教學

Visual Studio Code 使用教學手冊 完整的 VS Code 開發環境設定與實戰指南 涵蓋前端 (Vue 3 + TypeScript) 與後端 (Spring Boot) 開發,適用於團隊協作與企業級專案開發 文件範圍與適用對象:本手冊面向前後端開發人員、平台/DevOps 工程師與 IT 治理團隊,內容涵蓋 VS Code 從安裝設定、日常開發、AI Agent 輔助開發,到團隊協作、企業級治理與部署維運的完整生命週期。文件依據 code.visualstudio.com/docs 官方文件系列查證撰寫,對應版本為 VS Code v1.134(2026 年 8 月);由於 GitHub Copilot/Agent 相關功能迭代速度遠快於核心編輯器(約每月釋出新版),第 3.6 節與第 6.9 節內容請視為該時間點的快照,正式導入前建議對照官方 Release Notes 複核最新異動。 📋 目錄 1. VS Code 安裝與環境設定 1.1 安裝步驟 1.2 推薦字型與主題 1.3 專案必要的 Extensions 清單 1.3.1 基礎開發工具 1.3.2 前端開發 1.3.3 後端開發 1.3.4 Python 開發 1.3.5 AI 輔助開發 1.3.6 一鍵安裝指令 1.4 設定同步功能 1.5 實務案例與注意事項 2. 專案開發環境配置 2.1 如何開啟專案 2.2 前端、後端工作區設定 2.3 編碼規範設定 2.3.1 前端編碼規範 (ESLint + Prettier) 2.3.2 後端編碼規範 (Checkstyle) 2.3.3 Maven 獨立安裝設定 2.4 容器化開發環境 (Dev Containers) 2.5 實務案例與注意事項 3. 日常開發操作 3.1 Git 與 GitHub/GitLab 整合 3.2 常用快捷鍵 3.3 偵錯與斷點設定 3.4 終端機與多工作區使用 3.5 程式碼片段 (Snippets) 使用 3.6 AI 輔助開發 — GitHub Copilot 3.6.1 程式碼自動完成與 Next Edit Suggestions 3.6.2 Copilot Chat 對話式助手 3.6.3 Inline Chat(行內聊天) 3.6.4 智慧動作 3.6.5 Agent 模式與工作階段 (Sessions) 3.6.6 權限與核准控制(含 Autopilot) 3.6.7 Plan Agent(計畫代理) 3.6.8 自訂指示檔 3.6.9 MCP 伺服器整合 3.6.10 Custom Agents(自訂代理) 3.6.11 Agent Skills(代理技能) 3.6.12 Prompt Files(提示檔案) 3.6.13 Hooks(生命週期鉤子) 3.6.14 語言模型選擇 3.6.15 Agent Plugins(代理外掛) 3.7 實務案例與注意事項 4. 專案特定開發流程指引 4.1 前端開發流程 4.2 後端開發流程 4.3 全端開發工作流程 4.4 程式碼品質檢查 4.5 效能監控與分析 4.6 實務案例與注意事項 4.7 Python 開發環境設定 4.7.1 Python 專案結構 4.7.2 Python 環境設定 4.7.3 Python 開發工具設定 4.7.4 Python 偵錯設定 4.7.5 Python 任務設定 4.7.6 Python 專案範例 4.7.7 Python 開發最佳實務 5. 協作開發功能 5.1 Live Share 即時協作 5.2 多人開發設定 5.3 程式碼審查工具 5.3.1 GitHub Pull Request 整合 5.3.2 GitLab Merge Request 整合 5.3.3 程式碼審查檢查清單 5.4 團隊協作最佳實務 6. 進階功能與擴充 6.1 自訂程式碼片段 6.2 擴充功能開發入門 6.3 工作流程自動化 6.3.1 Task 自動化 6.3.2 GitHub Actions 整合 6.3.3 GitLab CI/CD 整合 6.4 效能優化進階技巧 6.5 遠端開發與 SSH 6.6 工作區管理進階技巧 6.7 設定檔 (Profiles) 管理 6.8 Agent Customizations 編輯器 6.9 企業級管理與治理原則 (Enterprise Policies) 7. 最佳實務 7.1 常見問題 (FAQ) 與解決方式 7.2 建議的工作習慣 7.3 效能最佳化 7.4 安全性最佳實務 7.5 團隊協作規範 8. 檢查清單 8.1 新進成員快速上手檢查清單 8.2 日常開發檢查清單 8.3 部署前檢查清單 8.4 故障排除檢查清單 9. 附錄 9.1 參考資源 9.2 版本歷程 1. VS Code 安裝與環境設定 1.1 安裝步驟 1.1.1 下載與安裝 前往 Visual Studio Code 官方網站 點擊 “Download for Windows” 下載安裝檔 執行安裝檔,建議勾選以下選項: ✅ 新增至 PATH (在重新啟動後可用) ✅ 在檔案總管中的檔案上顯示「使用 Code 開啟」動作 ✅ 在檔案總管中的目錄上顯示「使用 Code 開啟」動作 ✅ 將 Code 註冊為支援的檔案類型的編輯器 1.1.2 首次啟動設定 啟動 VS Code 選擇適合的色彩主題 登入 Microsoft 帳戶(可選,用於同步設定) 1.2 推薦字型與主題 1.2.1 推薦字型 建議安裝並使用以下等寬字型: ...

October 31, 2025 · 48 min · 10139 words · Eric Cheng