最佳 GitHub Copilot 设置

大家好，我是 Will 保哥，我之前开了三堂关于 GitHub Copilot 的课程，为了这些课程，我精心准备了许多 GitHub Copilot 的应用技巧。为了更好的应用这些 GitHub Copilot 这个好用工具，我测试了几乎所有 GitHub Copilot 的选项设置，这个 Repo 就是用来整理我认为的 GitHub Copilot 最佳设置，让学员们能够在课程中更轻松地使用 GitHub Copilot！👍

由于课程内容非常丰富，如果没有报名过我的课程，强烈建议大家可以购买课程的录像回放，这样就能够更深入地了解 GitHub Copilot 的使用方式与技巧。

1. 入门课：适合从未使用过 GitHub Copilot 的新手

   GitHub Copilot 协作开发实战

2. 进阶课：适合有一定基础的开发者

   GitHub Copilot 进阶开发实战

3. 代理人：适合希望深入了解 Agent Mode 的 GitHub Copilot 开发人员

   全面掌握 GitHub Copilot 代理人模式：打造专属 AI 开发助手

如果你不知道自己适合哪一堂课，我的建议一律是都买回去看就对了，因为这三堂课的内容是相辅相成的，内容很少有重叠，这样你就能够更深入地了解 GitHub Copilot 的使用方式与技巧。

1. GitHub Copilot 完整课程 (共三堂)

2. GitHub Copilot 入门到进阶 (共二堂)

   如果你只有报名过 全面掌握 GitHub Copilot 代理人模式：打造专属 AI 开发助手 这堂课，想要补充我的前两堂课程的话，可以购买这个组合票。

安装 GitHub 支持的开发工具

目前 GitHub Copilot 的 Agent Mode 已在 Visual Studio Code v1.99 之后的版本提供。

我个人还是建议安装 Visual Studio Code Insiders 开发工具，因为有些功能可能仅在 Insiders 版本中可用，并且会随着新功能的发布而更新。

切换 Visual Studio Code 显示语言为繁体中文

Visual Studio Code 是一套跨平台的编辑器，支持 Windows、macOS 与 Linux，因此理论上所有人都可以顺利安装与使用，如果你真的有遇到什么困难，欢迎随时到 Discord 课程专属频道中发问。

由于 Visual Studio Code 是一套轻量级的编辑器，它的功能是通过安装「扩展」来增强的。

首先，Visual Studio Code 支持完整的「繁体中文」界面，而且翻译质量非常好，在首次安装并启动 Visual Studio Code 后，该软件就会提醒你安装繁体中文套装，建议英文不太好的朋友可以安装繁体中文版。

如果你的界面没有自动切换到繁体中文版，那就请通过以下步骤手动切换：

1. 按下 F1 并输入 >display language 并选择 Configure Display Language

   

2. 选择 中文(繁体) (zh-tw) 并按下 Enter 键

   

3. 按下 Restart 按钮以重新启动 Visual Studio Code

   

安装 Visual Studio Code 扩展

GitHub Copilot 的功能是通过安装扩展来实现的，你需要安装以下扩展才能顺利地使用 GitHub Copilot 工具：

1. GitHub Copilot

   

2. GitHub Copilot Chat

   

3. VS Code Speech

   

4. Chinese (Traditional, Taiwan) language support for VS Code Speech

   

5. Live Preview

   可以让你在 Visual Studio Code 里面的文件随时都能通过浏览器预览网页。

GitHub Copilot 在 Visual Studio Code 的建议设置

以下是我在精雕细琢之后，觉得最完美的 GitHub Copilot Chat 与 VS Code Speech 设置参数，可以让你在使用 GitHub Copilot 时更加顺畅，也可以让你在使用语音输入时更加自然舒适。

请先找到 Visual Studio Code 的左下角或右下角的 ⚙ 图标，点开之后选择 设置 与 键盘快捷键 这两项，依据以下说明调整设置。

你也可以打开 设置 与 键盘快捷键 后，找到右上角的 打开设置(JSON) 按钮，你就可以打开相对应的 settings.json 或 keybindings.json 文件，直接合并我在下方整理的 JSON 设置也可以，这是最快的设置方法。

💡 以下两个文件我已经整理在 Repo 之中，可以直接下载回去使用：

1. .vscode/settings.json
2. .vscode/keybindings.json

以下则是我对每一个设置选项的摘要说明：

1. 用户设置

   • GitHub Copilot - 一般设置

     • github.copilot.enable

       设置在所有文件启用 GitHub Copilot 功能，但停用「纯文本」文件类型。

     • github.copilot.selectedCompletionModel (可选设置)

       GitHub Copilot 目前默认自动补全的模型已经是 gpt-41-copilot，相较于过去的 copilot-codex (GPT-3.5 Turbo) 来说更加聪明。此设置现在通常不需要手动调整，除非你想要切换到其他可用的模型。

       你也可以用 F1 > GitHub Copilot: Change Completion Model 选择。

     • github.copilot.editor.enableCodeActions 设置为 true

       控制 Copilot 命令在可用时是否显示为 Code Actions (代码动作)

     • github.copilot.renameSuggestions.triggerAutomatically 设置为 true

       自动触发重命名建议

     • window.commandCenter 设置为 true

       如果要启用 chat.commandCenter.enabled 设置，就必须启用这个设置。

     • chat.commandCenter.enabled 设置为 true

       设置要不要在编辑器中启用 Copilot Chat 指令中心按钮。

     • workbench.commandPalette.experimental.askChatLocation 设置为 chatView

       当你按下 F1 之后询问 Ask GitHub Copilot 的结果要显示在哪里，选 chatView 就会留下提问记录，若选 quickChat 就不会留下。

     • search.searchView.semanticSearchBehavior 设置为 runOnEmpty

       在搜索视图中设置语义搜索行为。可设置值有：

       • auto: 无论有没有搜索到东西，都会自动启动「使用 AI 搜索」功能
       • manual (默认值): 搜索不到东西时，会出现「使用 AI 搜索」的链接按钮，需手动点击启动
       • runOnEmpty: 搜索不到东西时，会自动启动「使用 AI 搜索」功能

     • github.copilot.nextEditSuggestions.enabled 设置为 true

       在编辑器中启用下一个编辑建议(NES)功能。深入了解 Next Edit Suggestions。

       NES = Next Edit Suggestions

     • editor.inlineSuggest.edits.showCollapsed 设置为 true

       在启用下一个编辑建议(NES)功能之后，编辑器经常会提醒你要不要按下 Tab 贴上建议的代码。但是默认这些建议都会直接在编辑器上占空间，有时候非常干扰我们的开发心流，所以我个人建议将这个设置调整为 true，他就不会一直跳出来显示你要按下 Tab 会被加入的内容了。

   • GitHub Copilot Chat

     • github.copilot.chat.localeOverride 设置为 zh-TW

       设置 GitHub Copilot Chat 的回应语言默认为繁体中文

     • github.copilot.chat.useProjectTemplates 设置为 true

       使用 /new 时直接选用 GitHub 项目模板

     • github.copilot.chat.scopeSelection 设置为 true

       如果用户使用 /explain 且当前编辑器没有选取任何内容，是否提示用户选择特定符号范围。

     • chat.detectParticipant.enabled 设置为 false

       在 Chat View 聊天的时候自动检测合适的聊天参与者来执行你的需求，因此你可以不用特别通过 @ 呼叫聊天参与者。

       如果设置为 true 的话，如果呼唤出错误的聊天参与者，可以按下 rerun without 重跑一次，这时就会交给 Copilot 来回答。(说明)

       依照我的过往经验，设置为 true 的时候，经常会呼唤错聊天参与者，所以我个人是建议将该设置调整为 false 较好。

     • chat.promptFiles 设置为 true (实验性功能)

       启用提示文件(prompts)功能，让你可以在 VS Code 建立可分享、可重复使用的提示指令，并附加额外的上下文。

       可运用在 Chat View, Edit View, Agent Mode, Inline Chat 等环境下。

       详情参见 Reusable prompt files (experimental)

     • chat.promptFilesLocations 设置指定多个 prompt 文件夹 (实验性功能)

       可指定多个 prompt 文件夹位置，让你能够组织和管理不同类型的提示文件。

        "chat.promptFilesLocations": {
            ".github/personal": true
        },
        ```

        注意：`.github/prompts` 資料夾已預設包含，無需額外設定。

        建議搭配 `.gitignore` 檔案排除個人化的 prompt 資料夾（如 `.github/personal`），避免將個人提示檔案提交到版本控制系統中。

        詳見 [Prompt files (experimental) settings](https://code.visualstudio.com/docs/copilot/copilot-customization#_prompt-files-experimental-settings)

      * `github.copilot.chat.languageContext.typescript.enabled` 設定為 `true` (實驗性功能)

        在 Inline Chat 與 Inline Completion 啟用自動向 TypeScript Language Service 取用 Context 資訊的能力，以獲取更多附加額外的上下文。

      * `github.copilot.chat.languageContext.fix.typescript.enabled` 設定為 `true` (實驗性功能)

        在程式碼修復功能中啟用自動向 TypeScript Language Service 取用 Context 資訊的能力，以獲取更多附加額外的上下文。

      * `github.copilot.chat.languageContext.inline.typescript.enabled` 設定為 `true` (實驗性功能)

        在內嵌編輯功能中啟用自動向 TypeScript Language Service 取用 Context 資訊的能力，以獲取更多附加額外的上下文。

      * `github.copilot.chat.agent.thinkingTool` 設定為 `true`

        啟用這個思考工具設定，能讓 Copilot 能夠在代理模式下深入思考您的請求，然後再生成回應。

    * **GitHub Copilot Chat - 內嵌聊天 (Inline Chat)**

      * `github.copilot.chat.editor.temporalContext.enabled` 設定為 `true`

        是否要在 Copilot 要求中包含最近檢視及編輯過的檔案。

      * `inlineChat.holdToSpeech` 設定為 `true`

        按住不放 `Ctrl+U` 或 `Ctrl+I` 開始語音對話

      * `inlineChat.finishOnType` 設定為 `false`

        在編輯器中輸入時，不會自動結束 Inline Chat 對話

    * **GitHub Copilot Chat - 偵錯相關設定**

      * `github.copilot.chat.startDebugging.enabled` 設定為 `true`

        在 Chat View 啟用實驗性的 `/startDebugging` 命令，幫你快速在 VS Code 初始化偵錯相關設定。

    * **GitHub Copilot Chat - 測試相關設定**

      * `github.copilot.chat.setupTests.enabled` 設定為 `true`

        啟用實驗性的 `/setupTests` 命令，幫你在 VS Code 快速初始化單元測試相關設定。

      * `github.copilot.chat.generateTests.codeLens` 設定為 `true` (實驗性功能)

        讓你在編輯器中遇到某一個函式或方法沒有涵蓋到測試範圍時，自動產生 `Generate tests` 的 Code lens 建議。

      * `github.copilot.chat.testGeneration.instructions` 設定為以下內容：

        ```json
        "github.copilot.chat.testGeneration.instructions": [
          {
            "file": ".copilot-test-instructions.md"
          },
          {
            "text": "Always try uniting related tests in a suite."
          }
        ],
        ```

    * **GitHub Copilot Chat - 自訂提示**

      * `github.copilot.chat.codeGeneration.useInstructionFiles` 設定為 `true`

        使用 `.github/copilot-instructions.md` 文件來自訂程式碼生成邏輯

      * `github.copilot.chat.codeGeneration.instructions` 設定為以下內容：

        ```json
        "github.copilot.chat.codeGeneration.instructions": [
          {
            "text": "Always response in #zh-tw."
          },
          {
            "text": "When outputing any text, use the following translation mappings: create = 建立, object = 物件, queue = 佇列, stack = 堆疊, information = 資訊, invocation = 呼叫, code = 程式碼, running = 執行, library = 函式庫, schematics = 原理圖, building = 建構, Setting up = 設定, package = 套件, video = 影片, for loop = for 迴圈, class = 類別, Concurrency = 平行處理, Transaction = 交易, Transactional = 交易式, Code Snippet = 程式碼片段, Code Generation = 程式碼產生器, Any Class = 任意類別, Scalability = 延展性, Dependency Package = 相依套件, Dependency Injection = 相依性注入, Reserved Keywords = 保留字, Metadata =  Metadata, Clone = 複製, Memory = 記憶體, Built-in = 內建, Global = 全域, Compatibility = 相容性, Function = 函式, Refresh = 重新整理, document = 文件, example = 範例, demo = 展示, quality = 品質, tutorial = 指南, recipes = 秘訣, byte = 位元組, bit = 位元"
          },
          {
              "file": ".copilot-instructions.md"
          }
        ],
        ```

      * `github.copilot.chat.reviewSelection.instructions` 設定為以下內容：

        ```json
        "github.copilot.chat.reviewSelection.instructions": [
            {
                "file": ".copilot-review-instructions.md"
            }
        ],
        ```

      * `github.copilot.chat.commitMessageGeneration.instructions` 設定為以下內容：

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

      * `github.copilot.chat.pullRequestDescriptionGeneration.instructions` 設定為以下內容：

        ```json
        "github.copilot.chat.pullRequestDescriptionGeneration.instructions": [
          {
            "file": ".copilot-pull-request-description-instructions.md"
          }
        ],
        ```

    * **GitHub Copilot Edit**

      * `github.copilot.chat.edits.suggestRelatedFilesForTests` 設定為 `true`

        該功能會在你編輯程式碼時，建議與測試相關的檔案。這對於開發者來說非常有用，因為它可以幫助你快速找到並編輯與當前程式碼變更相關的測試檔案，從而確保程式碼的品質和可靠性。

      * `github.copilot.chat.edits.suggestRelatedFilesFromGitHistory` 設定為 `true`

        該功能會根據 Git 歷史紀錄來建議相關的檔案。這意味著當你編輯某個檔案時，GitHub Copilot Chat 會根據過去的 Git 提交紀錄，建議可能與當前編輯相關的其他檔案。這有助於你更全面地理解程式碼變更的影響範圍，並確保所有相關檔案都得到了適當的更新。

      * `chat.editing.confirmEditRequestRemoval` 設定為 `true`

        該功能會在你嘗試刪除由 GitHub Copilot Chat 生成的程式碼變更時，提示你確認是否要刪除。這樣可以避免意外刪除程式碼變更，並確保你的程式碼變更是正確的。

      * `chat.editing.confirmEditRequestRetry` 設定為 `true`

        該功能會在你嘗試重新生成由 GitHub Copilot Chat 生成的程式碼變更時，提示你確認是否要重新生成。這樣可以避免意外重新生成程式碼變更，並確保你的程式碼變更是正確的。

    * **GitHub Copilot Chat - Agent Mode**

      * `chat.agent.enabled` 設定為 `true`

        即便是 Visual Studio Code Insiders 版本，預設 Agent Mode 也是沒有啟用的，你必須手動啟用這個選項，才可以看見 Copilot Edit 中的功能。

      * `chat.agent.maxRequests` 設定為 `100`

        預設 Agent Mode 在讓 Agent 自動作業的時候，預設只有 `15` 次迭代，對於一些比較複雜的工作，可能會需要你不斷的確認是否繼續。建議可以調高到 `100`，避免有時候量比較多就超標了。100 要超標就很有難度了。

      * `github.copilot.chat.codesearch.enabled` 設定為 `true` (預覽功能)

        這個選項用來啟用 `#codebase` 變數的「代理人」原始碼搜尋功能。

        傳統**一般搜尋**主要是透過**關鍵字比對**，搭配 `search.searchView.semanticSearchBehavior` 設定為 `runOnEmpty` 可以啟用搜尋時做**語意比對**，但在 GitHub Copilot Chat 職聊時，如果要透過 `#codebase` 變數找檔案，之前就只能做一次性的比對。

        當啟用了 `github.copilot.chat.codesearch.enabled` 設定後，就不會只搜尋一次，而是會多嘗試幾種不同的搜尋條件，幫你更好的找到需要的程式碼！👍

      * `github.copilot.chat.newWorkspaceCreation.enabled` 設定為 `true` (實驗性功能)

        這個選項用來啟用 `@workspace /new` 建立新專案的「代理人」功能。

      * `github.copilot.chat.agent.runTasks` 設定為 `true`

        這個選項感覺跟 Agent Mode 相關，實則完全無關。其設定值預設也為 `true`，所以理論上不用特別設定。

        這個選項的用途，主要是讓你可以在 GitHub Copilot Chat 呼叫 `.vscode/tasks.json` 定義的 Task 來執行。

      * `chat.mcp.enabled` 設定為 `true`

        啟用 GitHub Copilot 的 MCP (Model Context Protocol) 支援。

      * `chat.mcp.discovery.enabled` 設定為以下 JSON 內容，預設關閉其他 MCP Host 的伺服器註冊資訊：

        ```json
        "chat.mcp.discovery.enabled": {
            "claude-desktop": false,
            "windsurf": false,
            "cursor-global": false,
            "cursor-workspace": false
        }
        ```

      * `mcp` 用來註冊 MCP 伺服器的啟動資訊：

        ```json
        "mcp": {
          "servers": {
          }
        },
        ```

      * `telemetry.telemetryLevel` 設定為 `off`

        設定此選項可以避免 Agent Mode 無法啟用的問題。請注意，在更改此設定後，您需要重新啟動 Visual Studio Code 以使更改生效。

    * **Accessibility** (Voice)

      * `accessibility.voice.speechLanguage` 設定為 `zh-TW`

        設定語音輸入的語言為**繁體中文**。

* 將 `accessibility.voice.autoSynthesize` 設為 `off`

        在 Copilot 回應時自動合成語音，但有時候太吵了，建議關閉！XD

      * 將 `accessibility.voice.keywordActivation` 設為 `chatInContext`

        代表你在說 `Hey Code` 時會在 Copilot 聊天視窗互動。可設定 `off` 關閉此功能。

      * 將 `accessibility.voice.speechTimeout` 設為 `10000`

        設定語音輸入後可停頓的時間為 10000 毫秒。

        有些人講話比較慢，一句話講到一半會想很久，這時就要調高一點，不然預設只要停頓 1.2 秒就送出了！現在調整為 10 秒讓你想個夠，講話結巴也沒問題。重點是，你講完話之後，直接按個 Enter 也能送出！

      * 將 `accessibility.voice.ignoreCodeBlocks` 設為 `true` (Insiders)

        避免在合成語音的時候去讀程式碼區塊的內容

    * Live Preview

      * 將 `livePreview.autoRefreshPreview` 設為 `On Changes to Saved Files`

        在使用 [Live Preview](https://marketplace.visualstudio.com/items?itemName=ms-vscode.live-server) 擴充套件的時候，這個選項的預設值為 `On All Changes in Editor`，這意味著在 Copilot 生成程式碼的過程當中，會不斷地更新 Live Preview 網頁內容，預覽時可能會看到生成到一半的畫面，容易出現許多錯誤。若將選項值調整為 `On Changes to Saved Files` 就可以等到檔案儲存時才會更新預覽的網頁。

2. 鍵盤設定

    * 常用快速鍵 (內建)

      * 開啟 Copilot Chat 視窗，可以按下 `Ctrl+Alt+I`

      * 開啟 Copilot Edit 視窗，可以按下 `Ctrl+Shift+I`

      * 若在 Copilot Edit 視窗，可以按下 `Ctrl+.` 快速切換 **Ask Mode**、**Edit Mode** 與 **Agent Mode**

      * 若在 Copilot Chat 或 Copilot Edit 可以按下 `Ctrl+/` 連結內容 (Attach Context)

      * 若在 Copilot Chat 或 Copilot Edit 可以按下 `Ctrl+L` 清空現在的對話記錄

      * 若在 Copilot 的代理模式可以按下 `Ctrl+Enter` 讓終端機的命令自動執行 (不用碰滑鼠)

    * 語音對話 (Chat View)

      * 按下 `Ctrl+U` 開始語音對話

      * 按下 `Ctrl+U` 結束語音對話

      * 長按 `Ctrl+U` 可直接說話，放開快速鍵就可以送出提示

    * 語音指令 (Dictation)

      * 按下 `Alt+L` 開始語音輸入

      * 按下 `Alt+L` 或 `Escape` 結束語音輸入



## 建議調整 VS Code 的預設終端機

由於 GitHub Copilot 的 Agent Mode 只能跟指定的 Shell 環境搭配，尤其是在 Windows 作業系統下，各位同學更應該注意！

在 Windows 作業系統，我們有三種 Shell 環境可以選擇：

1. Command Prompt (命令提示字元)

    這是每一台 Windows 都有內建的 Shell 環境。

    ❌ 這個是 GitHub Copilot 的 Agent Mode 不支援的 Shell 環境，如果你目前選到這個的話，一定要改。

2. Windows PowerShell 5.1

    這是每一台 Windows 都有內建的 Shell 環境，啟動命令為 `powershell.exe`。

    ✅ 這是 Visual Studio Code 預設的終端機，理論上不用調整就能用。

    但是第一次使用前，建議執行以下命令，解除一些執行限制。請用「系統管理員」身份開啟 Windows PowerShell 並執行以下命令：

    ```ps1
    Set-ExecutionPolicy RemoteSigned
    ```

3. [PowerShell](https://github.com/PowerShell/PowerShell) (舊名為 PowerShell Core)

    這是微軟下一代 PowerShell 執行環境，支援 Windows, macOS, Linux 等作業系統，必須額外安裝才能使用，啟動的命令為 `pwsh.exe`。

    ✅ 你可以手動調整 Visual Studio Code 讓終端機預設採用這個環境。

    先按下 `F1` 並輸入 `Terminal` 搜尋，找到 `Terminal: Select Default Profile` 命令

    ![Terminal: Select Default Profile](https://oss.gittoolsai.com/images/doggy8088_github-copilot-configs_readme_a94bca5a85e2.png)

    然後選擇執行檔為 `pwsh.exe` 的選項，如下圖示：

    ![Select a profile](https://oss.gittoolsai.com/images/doggy8088_github-copilot-configs_readme_b618b2234b4e.png)

4. Git Bash

    這是在你安裝 Git for Windows 之後，預設就會有的 Shell 環境，啟動命令為 `bash.exe`。

    ❌ 這個是 GitHub Copilot 的 Agent Mode 不支援的 Shell 環境，如果你目前選到這個的話，一定要改。

如果你使用 Windows 作業系統，我強烈建議採用 [PowerShell](https://github.com/PowerShell/PowerShell) 为你主要的 Shell 執行環境，問題會比較少！🔥

如果你使用 macOS 或 Linux 作業系統，選用 `Bash` 或 `Zsh` 应该不会有什么问题，如果遇到无法让 Agent 呼叫命令的情况，请到 Discord 频道报告，或直接到 [microsoft/vscode-copilot-release](https://github.com/microsoft/vscode-copilot-release/issues) 这里反应问题。

## GitHub Copilot 相關連結

1. [GitHub Copilot 官網](https://github.com/features/copilot/)
2. [GitHub Copilot Plans](https://github.com/features/copilot/plans)
3. [GitHub Copilot 快速上手](https://github.com/features/copilot/tutorials)
4. [GitHub Copilot Extensions](https://github.com/features/copilot/extensions)
   1. [Copilot Extensions marketplace](https://github.com/marketplace?type=apps&copilot_app=true)
5. [GitHub Copilot documentation](https://docs.github.com/en/copilot)
6. [GitHub Copilot in Visual Studio Code](https://code.visualstudio.com/docs/copilot/overview)
7. [GitHub Copilot Issues](https://github.com/microsoft/vscode-copilot-release/issues) (專門用來回報問題的地方)

## 自動同步的 GitHub Copilot 檔案

本 Repository 會每天自動從 [Awesome GitHub Copilot Customizations](https://github.com/github/awesome-copilot) 專案同步以下內容：

- **chatmodes/**: GitHub Copilot 聊天模式設定檔 (30+ 個檔案)
- **instructions/**: GitHub Copilot 指令檔案 (35+ 個檔案)  
- **prompts/**: GitHub Copilot 提示檔案 (40+ 個檔案)

這些檔案包含了各種專業領域的 GitHub Copilot 自訂設定，如：

### 聊天模式 (chatmodes)
- Azure 架構師模式
- 除錯模式
- 專家級軟體工程師模式
- 程式碼清潔工模式
- 实现计划模式
- 以及更多专业模式...

### 指令檔案 (instructions)
- Angular 开发指引
- .NET/C# 最佳实务
- Docker 容器化指引
- Kubernetes 部署指引
- 安全开发指引
- 以及更多技术指引...

### 提示檔案 (prompts)
- 建立架构决策记录
- 产生测试代码
- 建立技术文件
- 程式码审查提示
- 以及更多实用提示...

> 📝 **使用说明**: 詳細的使用方法請參考 [SYNC_README.md](SYNC_README.md)

> ⏰ **同步時間**: 每天 UTC 00:00 (台北時間早上 8:00) 自动同步

## 歡迎貢獻

如果你有任何建議或是發現錯誤，歡迎隨時在 GitHub 上面開 Issue 提問，也歡迎大家幫忙發 Pull Request 讓這份文件變的更好！👍

GitHub Copilot 最佳配置快速上手指南

本指南基于 Will 保哥整理的 github-copilot-configs，旨在帮助开发者快速搭建高效的 GitHub Copilot 开发环境，特别优化了繁体中文语境下的使用体验（已适配简体中文阅读习惯）。

环境准备

在开始之前，请确保满足以下系统要求：

• 操作系统：Windows、macOS 或 Linux。
• 核心编辑器：
  • 推荐安装 Visual Studio Code Insiders 版本（以获取最新的 Agent Mode 等功能）。
  • 最低要求：Visual Studio Code v1.99 或更高版本（以支持稳定的 Agent Mode）。
• 账号要求：拥有有效的 GitHub 账号并订阅了 GitHub Copilot 服务。

安装步骤

1. 安装编辑器与语言包

下载并安装 Visual Studio Code Insiders。启动后，建议安装繁体中文语言包以获得完整界面支持（简体用户可同理安装简体包，或沿用此配置）：

1. 按下 F1，输入 >display language 并选择 Configure Display Language。
2. 选择 中文 (繁體) (zh-tw) 或 中文 (简体) (zh-cn)。
3. 点击 Restart 重启编辑器。

2. 安装必要扩展插件

在 VS Code 左侧扩展商店中搜索并安装以下插件：

• GitHub Copilot (GitHub.copilot)：核心代码补全功能。
• GitHub Copilot Chat (GitHub.copilot-chat)：聊天与代理模式功能。
• VS Code Speech (ms-vscode.vscode-speech)：语音输入支持。
• Chinese (Traditional, Taiwan) language support for VS Code Speech (ms-vscode.vscode-speech-language-pack-zh-tw)：语音包（按需安装）。
• Live Preview (ms-vscode.live-server)：网页实时预览。

3. 应用最佳配置 (JSON 方式)

这是最快速的配置方法。打开 VS Code 设置 JSON 文件：

1. 按下 F1，输入 >Preferences: Open User Settings (JSON)。
2. 将以下核心配置项合并到您的 settings.json 文件中：

{
  // --- GitHub Copilot 基础设置 ---
  "github.copilot.enable": {
    "*": true,
    "plaintext": false 
  },
  "github.copilot.editor.enableCodeActions": true,
  "github.copilot.renameSuggestions.triggerAutomatically": true,
  "github.copilot.nextEditSuggestions.enabled": true,
  "editor.inlineSuggest.edits.showCollapsed": true,

  // --- 界面与交互 ---
  "window.commandCenter": true,
  "chat.commandCenter.enabled": true,
  "workbench.commandPalette.experimental.askChatLocation": "chatView",
  "search.searchView.semanticSearchBehavior": "runOnEmpty",

  // --- GitHub Copilot Chat 核心设置 ---
  "github.copilot.chat.localeOverride": "zh-TW", 
  "github.copilot.chat.useProjectTemplates": true,
  "github.copilot.chat.scopeSelection": true,
  "chat.detectParticipant.enabled": false,
  "chat.promptFiles": true,
  "chat.promptFilesLocations": {
    ".github/personal": true
  },
  "github.copilot.chat.agent.thinkingTool": true,

  // --- TypeScript 上下文增强 (实验性) ---
  "github.copilot.chat.languageContext.typescript.enabled": true,
  "github.copilot.chat.languageContext.fix.typescript.enabled": true,
  "github.copilot.chat.languageContext.inline.typescript.enabled": true,

  // --- 内嵌聊天 (Inline Chat) ---
  "github.copilot.chat.editor.temporalContext.enabled": true,
  "inlineChat.holdToSpeech": true,
  "inlineChat.finishOnType": false,

  // --- 调试与测试 ---
  "github.copilot.chat.startDebugging.enabled": true,
  "github.copilot.chat.setupTests.enabled": true,
  "github.copilot.chat.generateTests.codeLens": true,
  
  // --- 自定义指令 (强制中文回复与术语映射) ---
  "github.copilot.chat.codeGeneration.useInstructionFiles": true,
  "github.copilot.chat.codeGeneration.instructions": [
    {
      "text": "Always response in #zh-tw."
    },
    {
      "text": "When outputing any text, use the following translation mappings: create = 建立，object = 物件，queue = 佇列，stack = 堆疊，information = 資訊，invocation = 呼叫，code = 程式碼，running = 執行，library = 函式庫，building = 建構，Setting up = 設定，package = 套件，video = 影片，for loop = for 迴圈，class = 類別，Concurrency = 平行處理，Transaction = 交易，Code Snippet = 程式碼片段，Function = 函式，Refresh = 重新整理，document = 文件，example = 範例，demo = 展示，quality = 品質，tutorial = 指南，byte = 位元組，bit = 位元"
    }
  ],

  // --- 编辑辅助 ---
  "github.copilot.chat.edits.suggestRelatedFilesForTests": true,
  "github.copilot.chat.edits.suggestRelatedFilesFromGitHistory": true,
  "chat.editing.confirmEditRequestRemoval": true,
  "chat.editing.confirmEditRequestRetry": true
}

注意：若需使用自定义指令文件（如 .copilot-instructions.md），请在项目根目录或 .github 文件夹下创建对应文件。

基本使用

配置完成后，您可以通过以下方式立即体验增强后的 Copilot：

1. 启用 Agent 模式 (智能代理)

在较新版本的 VS Code 中，直接在聊天窗口输入复杂任务，Copilot 会自动进入 Agent 模式进行多步推理和执行。

• 操作：按下 Ctrl+I (Windows/Linux) 或 Cmd+I (Mac) 打开内嵌聊天，或直接点击侧边栏聊天图标。
• 示例：输入“为当前文件添加单元测试并修复发现的 bug"，Agent 将自动分析、生成测试代码并尝试修复。

2. 使用语音输入

利用配置的 VS Code Speech 插件，您可以按住快捷键进行语音编程。

• 操作：在内嵌聊天框中，按住 Ctrl+U 或 Ctrl+I 说话，松开即发送。
• 场景：适合快速描述逻辑或口述代码结构。

3. 语义搜索与下一步建议

• 语义搜索：在搜索栏 (Ctrl+Shift+F) 输入自然语言，若普通搜索无结果，系统将自动触发 AI 语义搜索。
• 下一步编辑建议 (NES)：编写代码时，留意编辑器中灰色的幽灵文本提示，按 Tab 键即可接受 Copilot 预测的下一个编辑操作（默认折叠显示，减少干扰）。

4. 快速生成测试与调试

• 生成测试：当光标位于未覆盖测试的函数上时，点击出现的 Generate tests CodeLens 按钮。
• 初始化调试：在聊天窗口输入 /startDebugging，AI 将协助您快速配置 launch.json。