通義靈碼是阿里云與通義實驗室聯(lián)合打造的智能AI編碼輔助工具，基于通義大模型技術，為開發(fā)者提供多種編程輔助功能。它支持多種編程語言，包括 Java、Python、 Go、 TypeScript、JavaScript、C/C++、 PHP、 C#、Ruby 等200多種編碼語言。

通義靈碼的主要功能包括代碼智能生成、代碼優(yōu)化、注釋生成、代碼解釋、研發(fā)智能問答、異常報錯排查等。它還支持圖片多模態(tài)問答，可以根據(jù)圖片內(nèi)容生成代碼建議或問題修復建議。此外，通義靈碼還具備多文件代碼修改和工具使用的能力，可以與開發(fā)者協(xié)同完成編碼任務，如需求實現(xiàn)、問題解決、單元測試生成、批量代碼修改等。

目前，通義靈碼內(nèi)置Qwen模型以及DeepSeek滿血版，歡迎按需使用。

目前對于 HTML 語言，通義靈碼支持在多種文本編輯器或 IDE 上使用，接下來我們以 VS Code 為例來詳細講解通義靈碼的安裝與使用：

一、Visual Studio Code 中安裝指南

本安裝步驟適用于 macOS、Windows 或 Linux 的 Visual Studio Code 中安裝通義靈碼。

步驟 1：準備工作

• 操作系統(tǒng)：Windows 7 及以上、macOS、Linux；
• 下載并安裝 Visual Studio Code 1.68.0 及以上版本。

步驟 2：在 Visual Studio Code 中安裝通義靈碼

方法 1：從插件市場安裝

說明
單擊?立即安裝?，喚起 Visual Studio Code 插件市場直接安裝，安裝后請重啟 IDE，即可開啟智能編碼之旅。

1. 打開 Visual Studio Code 擴展窗口，搜索 ?TONGYI Lingma?，找到通義靈碼后單擊?安裝?。
2. 安裝完成后，請重啟 Visual Studio Code。

方法 2：下載安裝包安裝

1. 單擊下方鏈接，下載 Visual Studio Code 的 VSIX 安裝包；
   ? TONGYI Lingma-VS Code
2. 下載完安裝包后，打開 Visual Studio Code 后，單擊擴展，單擊更多按鈕，在下拉菜單中單擊 從 VSIX 安裝，選擇下載的 VSIX 文件后安裝；
   
3. 安裝完成后，請重啟 Visual Studio Code。

步驟 3：登錄并開啟智能編碼之旅

1. 重啟 Visual Studio Code 后，單擊側(cè)邊導航的通義靈碼，在通義靈碼助手的窗口單擊登錄按鈕。
   
   Tips：如果安裝后在側(cè)邊導航上找不到通義靈碼入口，可鼠標聚焦在側(cè)邊導航后右鍵查看，勾選通義靈碼后即可將插件入口配置在側(cè)邊導航上。
   
2. 單擊登錄后，將前往登錄頁面，完成登錄后可進入 IDE 客戶端開始使用。

二、通義靈碼配置指南

Visual Studio Code 中配置通義靈碼

準備工作

如果需要在 Visual Studio Code 中使用通義靈碼，必須完成通義靈碼插件安裝及阿里云賬號登錄。

查看快捷鍵

操作	macOS	Windows
打開/關閉智能問答窗口	? ? L	Ctl Shift L
接受行間代碼建議	Tab	Tab
廢棄行間代碼建議	esc	esc
查看上一個行間推薦結(jié)果	?(option) [	Alt [
查看下一個行間推薦結(jié)果	?(option) ]	Alt ]
手動觸發(fā)行間代碼建議	?(option) P	Alt P

重新綁定快捷鍵

步驟 1：在 Visual Studio Code 的首選項中，單擊快捷鍵的設置入口；

步驟 2：在快捷鍵管理窗口中，輸入 TONGYI Lingma 搜索，單擊編輯。在彈出的窗口中輸入用于命令的按鍵，然后單擊?Enter?/?Return?。

啟用或禁用行間生成

可以通過 2 個方法啟用或禁用行間生成功能：

方法 1：單擊狀態(tài)欄的通義靈碼圖標，在彈出的窗口中可快速啟用或禁用行間生成功能：

• 可以配置本地離線模型、云端大模型是否啟用；
• 開啟本地離線模型、云端大模型同時開啟的情況下，行間生成時優(yōu)先推薦云端大模型的代碼建議；

方法 2：插件設置頁面啟用或禁用行間生成，并支持設置生成的長度。

啟用或禁用函數(shù)的行間快捷入口

通義靈碼的智能問答窗口中，單擊設置，找到函數(shù)的行間快捷入口設置，可以進行啟用或禁用該功能。

配置 IDE 原生補全和行間生成的展示規(guī)則

打開插件設置頁面，可以設置是否同時展示行間自動生成建議和 IDE 原生下拉補全，默認不勾選。

查看幫助和分享反饋

查看使用幫助

通義靈碼的智能問答窗口中，可以通過 2 種方式查看使用幫助：

1. 通過智能問答的? /help? 指令快捷查看使用幫助；
   
2. 單擊智能問答窗口的幫助文檔入口，可以快速來到當前幫助文檔知識庫。
   

反饋回答質(zhì)量

在智能問答中，你可以對通義靈碼所生成的回答內(nèi)容進行評價，支持點贊和點踩，以不斷優(yōu)化回答效果。

使用問題反饋

當你在使用的過程有任何疑問、優(yōu)化建議、功能訴求等，均可在通義靈碼的智能問答窗口單擊提交反饋，即可前往阿里云開發(fā)者社區(qū)-通義靈碼問答專區(qū) 向我們提出問題。

參與體驗調(diào)研

為了給你提供更好的智能編碼體驗，我們也期待收到你的使用體驗反饋、優(yōu)化建議以及你的期待，我們會不斷努力和優(yōu)化產(chǎn)品體驗。

三、通義靈碼核心能力

1. 智能補全使用指南

通義靈碼提供了多種智能補全的方式，可以根據(jù)當前代碼文件、跨文件的上下文或企業(yè)代碼規(guī)范等，為您生成行級/函數(shù)級代碼，讓您更專注在技術設計。

說明

在 IDE 環(huán)境中使用通義靈碼，需要先完成通義靈碼插件安裝及阿里云賬號登錄。詳細信息可查看下載安裝指南 。

1.1 行級/函數(shù)級實時補全

當你在 IDE 編輯器區(qū)進行代碼編寫時

，在開啟自動云端生成的模式下，通義靈碼會根據(jù)當前代碼文件及相關代碼文件的上下文，自動為你生成行級/函數(shù)級的代碼建議，此時你可以使用快捷鍵采納、廢棄，或查看不同的代碼建議。

同時，當你在編碼的過程中，也可以通過快捷鍵 ??? ?P? 手動觸發(fā)生成代碼建議。

編輯器中代碼建議相關操作的快捷鍵如下：

操作	macOS	Windows
接受行間代碼建議	Tab	Tab
廢棄行間代碼建議	esc	esc
查看上一個行間推薦結(jié)果	?(option) [	Alt [
查看下一個行間推薦結(jié)果	?(option) ]	Alt ]
手動觸發(fā)行間代碼建議	?(option) P	Alt P

Tips：不同操作系統(tǒng)的快捷鍵配置可查看配置和反饋指南 。

1.2 自然語言生成代碼

在編輯器中，可以直接通過自然語言的方式描述需要實現(xiàn)的需求，通義靈碼可以在編輯器中生成代碼建議，單擊

Tab

可直接采納。

1.3 企業(yè)代碼生成增強

企業(yè)管理員上傳并啟用行間代碼生成知識庫，并設置為組織內(nèi)開發(fā)者可見成員后，開發(fā)者在 IDE 的代碼編輯器中編寫代碼時，通過快捷鍵 ? P 手動觸發(fā)，通義靈碼將根據(jù)知識庫中的內(nèi)容自動生成符合企業(yè)規(guī)范的代碼建議。

有關企業(yè)管理員如何準備代碼庫以及開發(fā)者，以及如何使用代碼生成增強功能的詳細介紹，可參考企業(yè)代碼補全增強使用實踐 。

1.4離線單行補全

通義靈碼代碼補全默認使用云端大模型進行智能續(xù)寫， 當網(wǎng)絡情況有限制時 ，可使用本地補全模式，單擊狀態(tài)欄圖標切換至本地補全模式后，編輯器中進行編碼時，通義靈碼會給出單行的代碼建議。

2 智能問答使用指南

通義靈碼，作為您的智能編碼助手，可以在您進行編碼工作遇到疑問時幫您答疑解惑，并快速為您生成建議代碼，能夠幫您生成代碼注釋、生成單元測試、進行代碼優(yōu)化、解釋工程和代碼文件、修復代碼問題、排查編譯報錯、生成提交信息等。

說明

在 IDE 環(huán)境中使用通義靈碼，需要先完成通義靈碼插件安裝及阿里云賬號登錄。詳細信息可查看下載安裝指南 。

2.1 研發(fā)智能問答

使用通義靈碼的智能問答時，為了通義靈碼與您的對話能夠更友好、高效，希望您能夠在輸入問題時：

• 選中代碼 ，開始輸入您的問題，通義靈碼將圍繞著選中代碼與您開展對話；
  
• 精準表達問題 ，以及給出相對詳細的上下文輸入， 比如選中的代碼、日志、報錯信息等；
  
• 多多互動 ，告訴通義靈碼，所給出代碼建議或回答是否滿足您的預期，或生成內(nèi)容存在的具體瑕疵，通義靈碼也會不斷改進。

2.1.1 自由問答

當您編碼遇到問題，缺乏具體解決思路時 ，可單擊 IDE 側(cè)邊工具導航或使用 ??? ??? ?L? 喚起通義靈碼智能問答助手，無需離開 IDE 客戶端，即可快速獲得答案和解決思路。

操作	macOS	Windows
打開/關閉 AI 程序員	? ? L	Ctl Shift L

2.1.2 代碼問答

當您對某段代碼有疑問或期望針對代碼進行一些問題解決時 ，選中代碼后，在智能問答窗口的輸入框中輸入您的問題，通義靈碼將圍繞選中代碼與您開展對話。

2.1.3 @workspace 本地工程問答

當您需要快速了解一個工程、查找工程內(nèi)的實現(xiàn)邏輯，或有新的訴求需要進行代碼變更時 ，可以在智能問答窗口中通過 ?@? 可喚起 ?@workspace? ，選中后輸入您的問題或訴求，通義靈碼可快速結(jié)合當前倉庫進行工程理解、代碼查詢、代碼問答等，同時可以通過自然語言描述需求，結(jié)合當前工程生成簡單需求或缺陷的整體修改建議和相關建議代碼。

2.1.4@terminal 問答

當您遇到執(zhí)行指令不知道如何寫，或者不清楚某個指令的意思時 ，可以在智能問答窗口中通過 ?@? 可喚起 ?@terminal? ，選擇后使用自然語言描述您的需要指令訴求，通義靈碼將可以生成您需要的命令。生成指令后，您可以一鍵插入到 terminal 中進行執(zhí)行或讓通義靈碼繼續(xù)解釋。當然，您也可以在選擇 ?@terminal? 后，輸入指令讓通義靈碼生成指令解釋。

2.1.5#teamDocs 知識庫問答（企業(yè)版）

當您需要結(jié)合企業(yè)內(nèi)私域知識信息讓通義靈碼進行回答時 ，可以在智能問答窗口中通過 ?#? 喚起 ?#teamDocs? ，并輸入問題，通義靈碼將結(jié)合企業(yè)知識庫（當前用戶有權限的知識庫）對問題進行回答，在回復中也可以單擊查看引用的企業(yè)知識庫內(nèi)容。

2.1.6清空會話上下文歷史記憶

當您在會話中時，在智能問答輸入框中輸入 ?/? 即可看到 ?/clear context? 指令，選擇后即可清空當前會話的上下文歷史記憶。

2.1.7新建會話

在智能問答窗口中，單擊右上角的新建按鈕即可新建會話窗口，單擊后會話窗口將回到默認狀態(tài)。

2.1.8查看會話歷史

歷史會話功能幫助您檢索和回顧與通義靈碼的交流記錄，方便針對多次的建議進行對比和選擇。不管您在哪個 IDE 客戶端上、哪個工程中，均可以查看或搜索您和通義靈碼的歷史會話。

2.2智能生成指令

2.2.1指令觸發(fā)方式

通義靈碼提供多處觸發(fā)單元測試生成、代碼解釋、生成代碼注釋、代碼優(yōu)化功能的入口，當您選中的代碼后，有 3 種觸發(fā)方式：

1. 在編輯器中，單擊右鍵找到通義靈碼功能操作入口，單擊對應功能操作；
   
2. 在智能問答中，直接單擊對應功能操作；
   
3. 在智能問答中，使用 ?/? 查看快捷指令，單擊對應功能操作。
   

當需要針對一個方法實現(xiàn)生成單元測試、代碼注釋、代碼解釋、代碼優(yōu)化時，無需選中代碼，可直接單擊函數(shù)上方的快捷入口觸發(fā)相關功能操作。

2.2.2 選擇指令后輸入回答要求

當您選中代碼后，并通過在智能問答窗口的輸入框輸入 / 的方式選中指令后，可以繼續(xù)輸入附加的要求，比如：

• 選擇 ?/generate unit test?  后，繼續(xù)輸入您對單元測試生成的要求，比如 使用 ?JUnit 5? 生成 ；
  
• 選擇 ?/generate comment?  后，繼續(xù)輸入生成注釋的要求，比如 開頭標明日期，并用英文注釋 。
  

2.2.2.1指令一：解釋代碼

覆蓋各種編程語言，選中代碼后可自動識別編程語言并生成代碼解釋?？缭秸Z言的邊界，讓您閱讀代碼更高效。

2.2.2.2 指令二：生成單元測試

支持根據(jù) JUnit、Mockito、Spring Test、unit test、pytest 等框架生成單元測試。

2.2.2.3指令三：生成注釋

一鍵生成方法注釋及行間注釋，節(jié)省您寫代碼注釋的時間，并能夠有效提升代碼可讀性。

2.2.2.4指令四：代碼優(yōu)化

深度分析代碼及其上下文，迅速識別潛在的編碼問題，從簡單的語法錯誤到復雜的性能瓶頸，均能夠指出問題所在，并提供具體的優(yōu)化建議代碼。

2.2.3生成回答后快捷操作

針對不同的指令生成回答后，在智能問答區(qū)中，可以繼續(xù)根據(jù)訴求進行操作，不同功能的對應操作如下：

• 生成單元測試：

• 采納單元測試代碼建議：支持一鍵插入、復制、或者新建代碼文件，可快速采納生成的單元測試代碼建議；
• 更換單元測試框架：提供基于 JUnit、Mockito、Spring Test、unit test、pytest 等框架生成單元測試代碼建議，在回答完成后，可以根據(jù)需要切換框架重新生成；
• 新建文件：支持一鍵保存單元測試代碼為新文件，方便進行查看和修改。

• 生成代碼優(yōu)化建議

• 采納代碼優(yōu)化建議：針對優(yōu)化建議中的建議代碼，支持一鍵插入、復制，快速采納生成的建議代碼；
• 查看 Diff：單擊查看 Diff 按鈕，將快速喚起 IDE Diff 查看窗口，快速了解建議和源代碼的變更；

• 生成代碼注釋：

• 采納代碼注釋建議：支持一鍵插入、復制，可快速采納生成的代碼注釋建議；
• 查看 Diff：單擊查看 Diff 按鈕，將快速喚起 IDE Diff 查看窗口，快速了解建議和源代碼的變更。

• 解釋代碼：

• 支持重試、更詳細、更簡單、中文/英文解釋的追問。

2.3 問題修復建議 

 2.3.1 代碼問題（Problem）一鍵修復

當您在編碼過程中出現(xiàn)代碼問題（Problem）需要進行修復時 ，通義靈碼可以一鍵給出修復建議，幫您快速修復代碼問題?？梢酝ㄟ^編輯器中報錯圖標中下拉菜單中或 Problem 窗口中聚焦到報錯信息后右鍵菜單中，單擊通義靈碼一鍵修復菜單，即可生成修復建議和相關建議代碼。

在 IntelliJ IDEA 中，當運行出現(xiàn)異常報錯時，在運行標準輸出窗口中，即可看到通義靈碼的快捷操作按鈕，單擊后，通義靈碼將結(jié)合運行代碼、異常堆棧等報錯上下文，快速給出排查思路或修復建議。

在 Visual Studio Code 中， 當 terminal 中執(zhí)行指令后報錯、編譯或運行后有大量報錯，需要進行解釋或修復時 ，可以選中報錯信息，右鍵選擇使用通義靈碼一鍵解釋，也會為您生成相關命令解釋及問題解決建議。

當您有代碼變更需要提交，需要寫提交信息時 ，可以通過通義靈碼一鍵生成 Git 提交信息，同時可以在插件設置中配置生成的語言（英文/中文）。

通義靈碼 AI 程序員，具備 多文件代碼修改（Multi-file Edit）和工具使用（Tool-use） 的能力，可以與開發(fā)者協(xié)同完成編碼任務，如需求實現(xiàn)、問題解決、單元測試用例生成、批量代碼修改等。

說明

使用通義靈碼 AI 程序員，需要將通義靈碼 IDE 插件升級到最新版本（2.0.0及以上版本）。

AI 程序員可以幫助開發(fā)者快速完成一個研發(fā)任務的代碼編寫工作，在與 AI 程序員對話過程中，可以遵循以下幾點建議：

• 清晰的需求描述： 首先需要澄清我們需要 AI 程序員幫我們做什么，建議包含一個明確的目標，并通過步驟式的結(jié)構(gòu)化描述，詳細地描述你期望完成的開發(fā)任務要求；
  
• 指定需要的上下文： 選擇代碼文件、圖片、codebase、codeChanges 等上下文，可以幫助 AI 程序員獲取需求相關的語境。同時，結(jié)合詳細執(zhí)行步驟和要求，AI 程序員更精準地了解你的意圖，生成最佳的方案和建議代碼；
  
• 明確生成要求： 告訴 AI 程序員在生成代碼修改建議時，你期望它遵循的要求，比如語言、規(guī)范、格式、變更目標等，如“生成變更時，同時為每個方法生成英文注釋”；
  
• 善用快照功能： 當 AI 生成內(nèi)容不符合預期，或你的需求有變化時，可以通過快照功能回退到之前的對話輪次和代碼變更，繼續(xù)重新提問；
  
• 審查和修改變更： AI 程序員完成多個文件的代碼變更后，開發(fā)者可以通過變更對比查看視圖（Diff View）進行審查，以及對局部代碼片段進行接受、拒絕、修改，保證最后得到符合預期的代碼變更。
  

通義靈碼，每天進步不止一點點，可以和開發(fā)者協(xié)同完成編碼任務。

3.1.1 喚起 AI 程序員（ Summon your AI Developer ）

當開發(fā)者期望和 AI 程序員一起完成一個研發(fā)任務時，可以通過 IDE 擴展導航打開通義靈碼插件的窗口，并切換到 AI 程序員模塊，或使用快捷鍵 ? ? I 喚起 AI 程序員，即可開始使用。

操作	macOS	Windows
打開/關閉 AI 程序員	? ? I	Ctl Shift I

3.1.2 與 AI 程序員一起編程（Coding with AI Developer）

AI 程序員與開發(fā)者一起圍繞開發(fā)任務進行編碼工作時，開發(fā)者需要輸入清晰的需求描述和要求，AI 程序員可以為開發(fā)者在工程內(nèi)進行多個文件的修改，開發(fā)者審查并接受相關代碼變更即可。

同時，通義靈碼提供了相關的交互界面幫助開發(fā)者與 AI 程序員進行對話和交互，整體交互界面區(qū)域如下：

• 新建會話 ：如果和 AI 程序員正在對話并有文件變更，單擊后將出現(xiàn)二次確認，確認后會終止或取消當前文件變更，同時創(chuàng)建一個新的會話；
  
• AI 程序員對話區(qū)域 ：展示開發(fā)者（問題）和 AI 程序員（回答）對話的過程，如果涉及到文件變更、計劃確認等，也將在會話流的回答卡片中進行狀態(tài)展示或操作；
  
• 工作區(qū) ：承載代碼變更文件的展示，以及針對當前會話流中的多次對話產(chǎn)生的多次變更文件進行快照管理，同時提供查看、拒絕、接受代碼變更的相關操作入口；
  
• 需求描述輸入?yún)^(qū)域 ：開發(fā)者進行需求描述輸入的區(qū)域，提供了選擇上下文、自然語言輸入、自然語言和上下文組裝的能力；
  
• 變更對比查看和操作區(qū)域 ：當前快照下文件與其對應本地文件的變更差異查看視圖，并提供針對代碼變更片段進行修改、拒絕或接受的操作，以及文件級別的變更接受或拒絕操作。
  

3.1.3 需求描述輸入（User Input）

打開 AI 程序員后，即可看到需求輸入?yún)^(qū)域，在輸入框內(nèi)單擊 ? 或者輸入 # 即可選擇需要的相關上下文。輸入完成后發(fā)送即可，AI 程序員將根據(jù)需求描述自動進行需求理解、相關信息檢索、任務拆解、編碼實現(xiàn)等。

3.1.4 多文件代碼修改（Multi-file Edit）

3.1.4.1 變更文件生成過程

當 AI 程序員對工程內(nèi)多個代碼文件進行修改時，每一個文件的修改將至少經(jīng)歷生成、應用的過程，生成代碼變更的過程中，可在 AI 程序員的回答卡片中和工作區(qū)中看到相關的變更文件，以及相應的狀態(tài)：

• 生成中（Generating）：根據(jù)任務拆解的修改計劃生成對各個文件的代碼片段修改建議的過程；
  
• 應用中（Applying）：某文件的代碼片段修改建議生成完成后，將自動結(jié)合原文件內(nèi)容和代碼片段修改建議，生成相關代碼變更文件（非原文件）；
  
• 應用完成（Applied）： 代碼變更文件生成完成。
  

回答卡片中的文件或工作區(qū)的文件在生成中、應用中的狀態(tài)時，單擊對應文件，即可看到對應文件的代碼修改建議生成過程、代碼變更文件與原文件變更對比（Diff）生成過程。

AI 程序員完成的代碼變更文件將聚合在 工作區(qū) ，方便開發(fā)者進行查看和操作。

3.1.4.2 審查、接受、拒絕代碼變更

單擊工作區(qū)的查看變更按鈕或單擊文件列表中的某文件，即可看到對應文件的變更對比查看視圖（Diff View），開發(fā)者在此視圖中可以進行如下操作：

• 單擊上下鍵進行切換查看當前文件的多個變更點；
  
• 單擊某變更點上的拒絕、采納按鈕進行決策操作；
  
• 單擊文件級操作區(qū)的前后鍵進行多個變更文件的查看；
  
• 單擊文件級操作區(qū)的拒絕、采納按鈕進行決策操作；
  
• 局部修改當前變更文件。
  

JetBrains IDEs 的視圖和操作位置，示意如下：：

VS Code 的視圖和操作位置，示意如下：

說明

1. 開發(fā)者基于當前快照的代碼變更文件產(chǎn)生的修改，將統(tǒng)一進入當前快照的最新內(nèi)容中，進行拒絕或接受操作時，將統(tǒng)一被拒絕或接受；
2. 當單擊接受某片段、某文件的代碼變更時，變更內(nèi)容將被合并到原文件代碼內(nèi)容中。

當所有代碼變更文件均被操作過拒絕或接受變更后， 當前快照 會變?yōu)橐呀邮堋⒉糠纸邮?、已拒絕狀態(tài)，各個狀態(tài)的相關釋義如下：

• 已接受： 某文件有代碼變更接受，視為該文件為已接受狀態(tài)；所有文件為已接受狀態(tài)，當前快照為已接受狀態(tài)；
  
• 部分接受： 某文件有代碼變更接受，視為該文件為已接受狀態(tài)；有部分文件為已接受狀態(tài)，當前快照為部分接受狀態(tài)；
  
• 已拒絕 ：某文件在無代碼變更被接受，視為該文件為已拒絕狀態(tài)；所有文件為已拒絕狀態(tài)，當前快照為已拒絕狀態(tài)。

3.1.5 多輪對話及變更快照（Multi-turns & Snapshot）

3.1.5.1 進行多輪次需求對話

當進行了一輪對話并生成代碼變更文件后，如需繼續(xù)補充需求或者修改需求，可在當前任務的會話流中繼續(xù)提問，AI 程序員將結(jié)合前序輪次生成的代碼變更分析補充的需求，并生成新的代碼修改建議，產(chǎn)生一個或多個新的代碼變更文件。

當需要查看或回退到前序輪次的修改時，可單擊下拉箭頭查看當前會話任務中產(chǎn)生的多次代碼變更快照，選擇后，可以看到相關信息變化或進行切換操作：

• 會話流中自動定位到產(chǎn)生該快照代碼變更文件的回答卡片；
  
• 快照下方文件列表自動切換到所選快照下的代碼變更文件，單擊后可查看代碼變更內(nèi)容；
  
• 單擊“切換”按鈕，將當前代碼變更回退到所選快照的代碼變更狀態(tài)。
  

單元測試智能體是 AI 程序員所具備的一種專項能力，可以 針對代碼變更（?#codeChanges?）、單個或多個代碼文件批量生成單元測試文件 。開發(fā)者輸入被測內(nèi)容、生成要求，AI 程序員即可自動生成測試計劃、測試用例、編譯、運行以及根據(jù)錯誤信息進行自動修復，大幅提升測試用例覆蓋度和用例的生成質(zhì)量，降低開發(fā)者編寫單元測試用例的成本。

4.1 選擇被測代碼并輸入測試要求

打開 AI 程序員后，在輸入框內(nèi)單擊 ? 或者輸入 # 即可選擇需要的相關上下文，并輸入相關的指令要求（ 建議輸入和生成單元測試相關要求的內(nèi)容 ），輸入完成后發(fā)送即可，AI 程序員會自動感知意圖，開始進入生成單元測試的流程。

收到測試要求后，AI 程序員會自動檢測本地環(huán)境 Java 版本、構(gòu)建工具、測試框架、Mock 框架等信息，如果檢測到多個版本，開發(fā)者可主動選擇需要的版本；如果無法識別，將看到提示錯誤，單擊“如何修復”按鈕，開發(fā)者可以進一步了解如何配置相關組件。

4.3 確定被測方法

環(huán)境信息檢查通過后，AI 程序員將自動分析被測文件，并生成測試計劃，開發(fā)者可以主動選擇需要覆蓋的方法，選擇并確認完成后，單擊確定按鈕，即可開始為每個方法生成單元測試用例。

說明

• 每次至少選擇 1 個方法為其生成測試用例，最多選擇 20 個方法；

• 選擇方法后，會提示整體生成過程預計需要的時間，以供參考。

4.4 查看生成進展

在確定被測方法后，AI 程序員將自動根據(jù)開發(fā)者選擇的被測方法進行單測用例生成工作，并自動對生成的結(jié)果進行編譯、運行和自動修復。最終的結(jié)果會展示在界面中，狀態(tài)及釋義如下：

狀態(tài)	圖標含義
	代表運行通過的用例
	代表編譯通過但運行失敗的用例
	代表編譯失敗的用例

當所有方法的用例生成完成后，AI 程序員自動將編譯通過和運行通過的用例合并成最終測試用例文件，并根據(jù)被測文件自動進行命名。對于編譯失敗的測試用例代碼，開發(fā)者可自行選擇是否需要，所有用例代碼確認后，可單擊完成按鈕，測試用例文件將自動與原測試用例文件進行差異對比。

確認完成后，測試用例文件會出現(xiàn)在工作區(qū)中，開發(fā)者可單擊工作區(qū)的查看變更按鈕或單擊文件列表中的某文件，即可看到對應文件的變更對比查看視圖（Diff View），開發(fā)者可進行審查、局部修改、接受或拒絕部分代碼等。確認所有代碼變更后，單擊接受按鈕，，測試用例文件變更代碼將正式進入到當前代碼工程。

如果需要回顧歷史的會話任務，可單擊會話歷史按鈕。你與 AI 程序員的會話均有 @AI Developer 標簽，單擊后即可查看相關對話過程。

四、登錄通義靈碼

步驟 1：準備工作

• 已成功注冊阿里云賬號，具體操作可參考：賬號注冊（PC端） 。如果你是某阿里云賬號下的 RAM 用戶，且你所在的阿里云主賬號未開通企業(yè)標準版，也可以使用通義靈碼個人版；
  
• 已在 JetBrains IDEs、Visual Studio Code、Visual Studio 中安裝通義靈碼 IDE 插件，具體操作可參考：下載安裝指南 。
  

步驟 2：在 IDE 的通義靈碼插件登錄

說明
如果你的電腦安裝多個 IDE 本地客戶端，均安裝通義靈碼的情況，登錄狀態(tài)在多個 IDE 客戶端的通義靈碼插件中同步，你只需要登錄一次即可。

使用阿里云賬號登錄通義靈碼有兩種方式：

• 前往阿里云登錄頁，登錄通義靈碼（推薦）；
  
• 使用阿里云賬號的 AK/SK 登錄通義靈碼。
  

方式 1：前往阿里云登錄頁，登錄通義靈碼（推薦）

安裝完通義靈碼插件后，通常情況下，你可以通過 IDE 客戶端的插件上的登錄按鈕前往阿里云登錄頁完成登錄，操作步驟如下：

1 在 IDE 客戶端的通義靈碼插件中，找到登錄按鈕，不同 IDE 客戶端中位置不一樣（如下圖所示），操作步驟如下：
○ 在 JetBrains IDEs、Visual Studio Code 中，單擊通義靈碼智能問答窗口中的登錄按鈕，即可前往阿里云登錄頁；
○ 在 Visual Studio 中，單擊頂部導航工具-通義靈碼，單擊登錄按鈕，即可前往阿里云登錄頁；

2 在阿里云登錄頁面中，完成阿里云登錄（RAM 用戶可在 RAM 用戶登錄頁面中登錄）后，即可看到登錄完成的狀態(tài)，此時即可前往插件端使用。

1.2.2 方式 2：使用阿里云賬號的 AK/SK 登錄通義靈碼

如果遇到無法打開瀏覽器的阿里云登錄頁面時，可使用阿里云賬號的 AK/SK 登錄通義靈碼，情況如下：

● 當你進行遠程開發(fā)時，如使用 Remote SSH、WSL、Docker 的開發(fā)環(huán)境，可以使用 AK/SK 的方式登錄通義靈碼；
● 當你使用 Visual Studio Code 的 Web IDE 時，可以使用 AK/SK 的方式登錄通義靈碼；
● 當你使用基于 Visual Studio Code 的 Web IDE 開源版本構(gòu)建的 IDE 時，如果 IDE 提供方對接了 Open VSX 時，可以使用 AK/SK 的方式登錄通義靈碼，直達插件地址：https://open-vsx.org/extension/Alibaba-Cloud/tongyi-lingma ；
● 其他無法打開阿里云登錄頁面的情況。

操作步驟如下：

1 前往阿里云控制臺獲取 AccessKey，具體操作可參考：創(chuàng)建AccessKey 。

2 在插件中輸入 AccessKey ID、AccessKey Secret 進行登錄，不同 IDE 客戶端中操作不一樣（如下圖所示），操作如下：
○ VS Code：在 IDE 中使用快捷鍵 ? ? P （ Ctl Shift P ）打開命令面板，搜索 TONGYI Lingma，即可看到使用 AK/SK 登錄通義靈碼，單擊后分步輸入 AccessKey ID、AccessKey Secret，選擇身份（未加入任何企業(yè)時將跳過）單擊 Enter / Return 鍵，即可完成登錄；
○ JetBrains IDEs：打開 IDE 的設置頁面，找到通義靈碼插件設置，在未登錄狀態(tài)即可看到 AK/SK 登錄入口，輸入 AccessKey ID、AccessKey Secret 后，選擇身份（未加入任何企業(yè)無需選擇），然后單擊登錄即可；
○ 暫不支持在 Visual Studio 中使用 AK/SK 登錄。

相關鏈接：

• 通義靈碼官網(wǎng)： https://lingma.aliyun.com/lingma/
• 通義靈碼插件下載： https://lingma.aliyun.com/lingma/download