GitHub Copilot Commit Message 中文生成：自動化提交訊息設定教學

你是否曾經打開專案的 Git 歷史紀錄，卻發現同事寫的 fix: update logic 完全看不出改了什麼？這篇文章教你設定 GitHub Copilot，讓它自動生成符合中文語法的提交訊息，從安裝到團隊規範配置一次搞定。

查看相關日報

程式碼的提交紀錄早已不只是技術人員的個人筆記，而是團隊協作、專案審計與版本回溯的核心資產。過去許多開發者習慣用英文寫 Commit Message，這在國際化專案中是標準做法，卻常讓非英語母語的團隊成員在回顧歷史紀錄時看得一頭霧水，拖慢專案維護的溝通效率。

GitHub Copilot commit message 中文生成功能成熟後，情況不一樣了。不用再手動翻譯或硬翻，AI 能直接把程式碼的變更邏輯轉換成流暢、符合中文語法習慣的提交訊息，讓每一次提交都成為清楚的專案里程碑。

什麼是 GitHub Copilot Commit Message 中文生成？

GitHub Copilot commit message 中文生成，本質上是利用大型語言模型的語意理解能力，自動分析程式碼倉庫中的變更內容（Diff），轉化成自然語言的中文描述。這不是簡單的關鍵字替換，而是 AI 對程式邏輯的「翻譯」與「重述」。

當你修改了一段邏輯複雜的函式，或新增了一個資料庫模組，Copilot 會掃描這些變更，理解它「做了什麼」「為什麼做」以及「影響範圍」，接著自動產出符合 Git 規範（如 Conventional Commits）的中文提交訊息。舉例來說，fix: update user auth logic 會被轉化為 修正：更新使用者身份驗證邏輯，解決登入逾時問題。

軟體開發的迭代速度快，若團隊成員來自不同語言背景，或專案主要面向中文使用者，純英文的提交紀錄常常變成溝通瓶頸。設定好 GitHub Copilot commit message 中文，能讓非技術背景的專案經理、測試人員甚至客戶，直接看懂 Git 歷史紀錄，不用另外找人翻譯。版本控制從此不再是「技術黑盒子」，而是一本人人能讀的專案日誌。

事前準備：環境與需求檢查

開始設定前，要先確認開發環境具備必要的軟硬體基礎，少一個環節都可能讓 AI 功能無法運作。

系統需求：安裝 VS Code 與 GitHub Copilot 擴充功能

建議使用 Visual Studio Code 作為主要開發環境，因為它是 GitHub Copilot 最原生支援的 IDE。支援的平台請以官網最新公告為準。

支援的平台請以官網最新公告為準。安裝後確認擴充功能狀態顯示為「已啟用」。若專案使用特定語言（如 Python、Go、TypeScript），建議一併安裝對應的語言支援擴充功能，讓 AI 更精準解析程式碼語法。

需要的帳號：GitHub 訂閱與 Copilot 授權狀態確認

除了軟體安裝，帳號授權是GitHub Copilot commit message 中文能否生效的決定性因素。你必須擁有有效的 GitHub 帳號，並訂閱 GitHub Copilot 服務。

登入 GitHub 官方網站，進入帳號設定頁面檢查「Copilot」相關選項。若使用企業版（GitHub Enterprise），請確認組織管理員已為你開啟 Copilot 授權。

依 GitHub 官方文件，目前的方案有 Copilot Free（免費）、Copilot Student（驗證學生免費）、Copilot Pro（每月 10 美元）、Copilot Pro+（每月 39 美元）、Copilot Max（每月 100 美元），以及組織用的 Copilot Business（每席每月 19 美元）與 Copilot Enterprise（每席每月 39 美元）。Copilot Free 是常設方案，不是試用期，但額度有限：每月 2000 次程式碼補全、AI credit 有上限、只能用自動模型選擇。定價與額度會調整，實際以官網公告為準。

Step 1：安裝與基本設定

環境檢查完成後，接下來設定 Copilot 支援中文語境，確保生成的提交訊息符合你的語言偏好。

安裝步驟：在 VS Code 中啟用 GitHub Copilot 擴充功能

開啟 VS Code，點擊左側的擴充功能圖示（或按 Ctrl+Shift+X / Cmd+Shift+X），搜尋「GitHub Copilot」。確認開發者為「GitHub」後點擊「安裝」。

支援的平台請以官網最新公告為準。授權成功後，VS Code 會自動載入 Copilot 的語言模型，狀態列會出現 Copilot 圖示。可以嘗試在編輯區輸入 // TODO: 測試 AI 是否自動補全程式碼，補全功能正常運作就代表基礎安裝成功。

初始設定：配置語言偏好為中文以生成中文訊息

這是設定GitHub Copilot commit message 中文的核心步驟，也是網路上教學最常寫錯的地方——設定鍵名打錯，VS Code 不會報錯，設定只是靜靜地不生效。

這裡要分清楚兩個不同的東西：

• github.copilot.chat.localeOverride：官方描述是「Specify a locale for chat responses, such as en or fr」，預設值 "auto"（跟著 VS Code 顯示語言）。它管的是聊天視窗的回覆語言。
• github.copilot.chat.commitMessageGeneration.instructions：官方描述是「(Experimental) Custom instructions for generating commit messages with AI」，預設 []。它管的是提交訊息。

⚠️ 這兩個是分開的。曾有使用者回報把 localeOverride 設成 zh-TW 之後，Source Control 的「Generate Commit Message with Copilot」仍然只吐英文（microsoft/vscode-copilot-release issue #1307）。所以要中文提交訊息，真正的槓桿是 commitMessageGeneration.instructions，localeOverride 只是順便讓聊天視窗也講中文。

在專案的 .vscode/settings.json（或使用者層級設定）加入：

{
  "github.copilot.chat.localeOverride": "zh-TW",
  "github.copilot.chat.commitMessageGeneration.instructions": [
    { "text": "一律使用繁體中文撰寫提交訊息。" },
    { "text": "遵循 Conventional Commits 格式，type 保留英文（feat、fix、docs 等），冒號後的描述用繁體中文。" }
  ]
}

instructions 陣列裡的每個物件可以是 text（直接寫指示）或 file（指向一份 Markdown 檔的路徑），兩種擇一。

這三個鍵不存在，寫了不會生效：github.copilot.editor.enableChat、github.copilot.chat.language、github.copilot.editor.commitMessageFormat。VS Code 官方的 Copilot 設定清單裡沒有它們。

另外 github.copilot.enable 確實存在，但它的值是物件不是布林值——用途是「依語言別開關行內建議」，官方預設是：

{
  "github.copilot.enable": {
    "*": true,
    "plaintext": false,
    "markdown": false,
    "scminput": false
  }
}

小提醒：改完設定若還是英文，先確認鍵名沒打錯（VS Code 設定 UI 搜尋「Locale Override」找得到就是對的），再確認 instructions 有存進去。臨時要中文，也可以直接在 Chat 視窗打「請使用繁體中文重寫這則提交訊息」。

Step 2：第一個實作範例

設定完成後，實際操作一次，感受 GitHub Copilot commit message 中文的生成過程，理解 AI 如何從程式碼變更中提取資訊並轉化為中文描述。

操作步驟：修改程式碼並觸發 Copilot 生成中文提交訊息

假設你修改了一段「使用者登入」邏輯，將原本硬編碼的密碼驗證改為呼叫 API。

1. 儲存變更：在 VS Code 中完成程式碼修改後，按下 Ctrl+S 儲存檔案。
2. 開啟 Git 面板：點擊左側的 Git 圖示（或按 Ctrl+Shift+G），變更的檔案會出現在「變更」列表中。
3. 觸發生成：將滑鼠游標移至變更的檔案名稱上，或點擊「提交」按鈕旁的輸入框，Copilot 通常會在輸入框上方或側邊顯示預覽建議，標題為「生成提交訊息」。
4. 確認語境：若未自動顯示，在輸入框中輸入 @Copilot 生成中文提交訊息，或點擊 Copilot 圖示選擇「生成提交訊息」。
5. 選擇語言：彈出的對話框中確認語言設定為「繁體中文」，若未自動選擇，手動輸入「請用繁體中文描述以下變更」。

預期結果：成功生成符合語法的中文提交訊息

執行上述步驟後，提交訊息輸入框應出現一段自動生成的中文文字，通常包含：

• 類型：如 修正 (fix)、新增 (feat)、文件 (docs)。
• 描述：清楚描述變更內容，例如「修正使用者登入 API 呼叫邏輯」。
• 細節：簡要說明變更原因或影響，例如「解決了密碼驗證逾時問題」。

例如系統可能生成：

feat: 新增使用者登入 API 整合，解決密碼驗證逾時問題

若生成的內容語意不通或格式錯誤，先別急著提交，可以點擊「重新生成」，或手動修改部分文字確保符合團隊規範。這個過程正是 GitHub Copilot commit message 中文的價值所在：把技術邏輯轉化為自然語言，讓提交紀錄真正可讀。

Step 3：進階技巧與最佳實踐

熟悉基礎操作後，可以進一步優化設定，符合團隊的專案規範，同時避開常見的提交陷阱。

效率提升：自訂規則以符合團隊規範

每個團隊的 Git 提交規範可能不同，有的要求用 feat:，有的要求 feature:。要讓 GitHub Copilot commit message 中文自動符合團隊規範，可以建立專案級的設定檔。

⚠️ 這裡要再強調一次：沒有 github.copilot.editor.commitMessageFormat 這個設定，也沒有任何設定能讓 Copilot 去讀 .gitmessage 或 .commitlint.config.js 當生成模板。那兩個檔案分別是 git 的提交訊息樣板與 commitlint 的檢查規則，跟 Copilot 生成提交訊息這件事沒有連動關係。

正確做法是把團隊規範寫成指示，餵給 github.copilot.chat.commitMessageGeneration.instructions。指示可以直接內嵌，也可以抽成一份 Markdown 檔讓整個團隊共用：

{
  "github.copilot.chat.commitMessageGeneration.instructions": [
    { "file": ".github/instructions/commit-message.md" }
  ]
}

然後在 .github/instructions/commit-message.md 寫下規範，例如：

- 提交訊息一律使用繁體中文。
- 格式為 `<type>: [JIRA-編號] 中文描述`，type 使用 feat / fix / docs / refactor / test / chore。
- 描述要交代「改了什麼」與「為什麼改」，不要只寫「更新程式碼」。

把這份檔案 commit 進版控，團隊成員 clone 下來就套用同一套規範。

提醒兩點：一是這個設定官方仍標示為 Experimental；二是 Copilot 只是照著指示生成建議，不會強制檢查。真的要擋掉不合規的提交，還是得靠 commitlint 這類工具在 pre-commit hook 或 CI 攔下來。

順帶一提，.github/copilot-instructions.md（或 AGENTS.md）是整個 repo 通用的指示檔，也會被納入。當多種指示同時存在時，官方說明的優先序是：個人層級指示最高，其次是 repo 指示，組織指示最低。

常見陷阱：避免語意錯誤與格式不一致

AI 能力再強，還是可能出現語意錯誤或格式不一致。常見陷阱有三種。

過度簡化是最常見的問題：AI 有時為了簡潔而省略關鍵技術細節，讓後續維護者看不懂變更原因。生成後務必檢查描述是否交代了「為什麼做」，若太籠統就手動補充背景資訊。

語法錯誤也偶爾發生，AI 可能生成不符合 Git 規範的訊息，例如缺少冒號或用錯關鍵字。用 commitlint 之類的工具在提交前檢查，發現錯誤就手動修正。

中文語意不自然則是另一個常見狀況，尤其在特定技術術語上，AI 生成的文字可能顯得生硬。建議團隊建立一份「術語表」，把「微服務」「API Gateway」這類技術詞彙固定為標準中文譯名，並在設定檔中引用，確保生成內容的一致性。

常見問題 FAQ

Copilot 為什麼不生成中文訊息？

第一個要查的是鍵名有沒有打錯。github.copilot.chat.language 這個設定不存在，寫了也不會生效；正確的是 github.copilot.chat.localeOverride（預設 "auto"，跟著 VS Code 顯示語言走）。

但 localeOverride 管的是聊天回覆，不保證提交訊息跟著變中文——曾有使用者回報設了 zh-TW 之後提交訊息仍是英文（microsoft/vscode-copilot-release issue #1307）。要提交訊息講中文，得另外設 github.copilot.chat.commitMessageGeneration.instructions，在裡面明講「一律使用繁體中文」。

其餘可能：Copilot 依賴雲端模型，網路不穩會失敗；以及檢查 Copilot 授權狀態，Copilot Free 每月有 2000 次補全的額度上限。

如何手動修正自動生成的內容？

Git 提交訊息輸入框是標準的文字編輯區，可以直接刪除錯誤部分重寫，或在 AI 生成的內容後追加技術細節、Jira 編號。對於複雜變更，建議使用多行提交格式，第一行寫摘要，後續行寫詳細說明，方便日後查閱。

是否支援非英文專案的中文提交？

支援。無論程式碼語言是 Python、Go 還是 Java，只要專案設定或個人設定中指定了中文語言偏好，Copilot 都能生成中文提交訊息。這對跨國團隊或主要面向中文市場的專案特別重要，能確保專案紀錄的統一性與可讀性。

下一步：延伸學習與團隊整合

學會 GitHub Copilot commit message 中文的基礎設定與實作後，可以往三個方向延伸。

第一是團隊規範整合，把設定檔推送到團隊的 Git 倉庫，讓所有成員自動繼承相同的提交規範。第二是 CI/CD 整合，在持續整合流程中加入 commitlint 檢查，不符合團隊規範的提交訊息就拒絕合併。第三是進階提示工程，學習撰寫更精確的提示，指定特定語氣或格式，取得更精準的中文描述。

持續優化設定與實踐，你會建立一套高效、專業且符合中文語境的 Git 提交流程。技術終究只是工具，真正的價值在於用它提升團隊的協作效率與專案品質。