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

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

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

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

一、Visual Studio Code 中安裝指南

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

步驟 1：準(zhǔn)備工作

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

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

方法 1：從插件市場(chǎng)安裝

說(shuō)明
單擊?立即安裝?，喚起 Visual Studio Code 插件市場(chǎng)直接安裝，安裝后請(qǐng)重啟 IDE，即可開(kāi)啟智能編碼之旅。

1. 打開(kāi) Visual Studio Code 擴(kuò)展窗口，搜索 ?TONGYI Lingma?，找到通義靈碼后單擊?安裝?。
2. 安裝完成后，請(qǐng)重啟 Visual Studio Code。

方法 2：下載安裝包安裝

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

步驟 3：登錄并開(kāi)啟智能編碼之旅

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

二、通義靈碼配置指南

Visual Studio Code 中配置通義靈碼

準(zhǔn)備工作

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

查看快捷鍵

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

重新綁定快捷鍵

步驟 1：在 Visual Studio Code 的首選項(xiàng)中，單擊快捷鍵的設(shè)置入口；

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

啟用或禁用行間生成

可以通過(guò) 2 個(gè)方法啟用或禁用行間生成功能：

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

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

方法 2：插件設(shè)置頁(yè)面啟用或禁用行間生成，并支持設(shè)置生成的長(zhǎng)度。

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

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

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

打開(kāi)插件設(shè)置頁(yè)面，可以設(shè)置是否同時(shí)展示行間自動(dòng)生成建議和 IDE 原生下拉補(bǔ)全，默認(rèn)不勾選。

查看幫助和分享反饋

查看使用幫助

通義靈碼的智能問(wèn)答窗口中，可以通過(guò) 2 種方式查看使用幫助：

1. 通過(guò)智能問(wèn)答的? /help? 指令快捷查看使用幫助；
   
2. 單擊智能問(wèn)答窗口的幫助文檔入口，可以快速來(lái)到當(dāng)前幫助文檔知識(shí)庫(kù)。
   

反饋回答質(zhì)量

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

使用問(wèn)題反饋

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

參與體驗(yàn)調(diào)研

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

三、通義靈碼核心能力

1. 智能補(bǔ)全使用指南

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

說(shuō)明

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

1.1 行級(jí)/函數(shù)級(jí)實(shí)時(shí)補(bǔ)全

當(dāng)你在 IDE 編輯器區(qū)進(jìn)行代碼編寫(xiě)時(shí)

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

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

編輯器中代碼建議相關(guān)操作的快捷鍵如下：

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

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

1.2 自然語(yǔ)言生成代碼

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

Tab

可直接采納。

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

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

有關(guān)企業(yè)管理員如何準(zhǔn)備代碼庫(kù)以及開(kāi)發(fā)者，以及如何使用代碼生成增強(qiáng)功能的詳細(xì)介紹，可參考企業(yè)代碼補(bǔ)全增強(qiáng)使用實(shí)踐 。

1.4離線(xiàn)單行補(bǔ)全

通義靈碼代碼補(bǔ)全默認(rèn)使用云端大模型進(jìn)行智能續(xù)寫(xiě)， 當(dāng)網(wǎng)絡(luò)情況有限制時(shí) ，可使用本地補(bǔ)全模式，單擊狀態(tài)欄圖標(biāo)切換至本地補(bǔ)全模式后，編輯器中進(jìn)行編碼時(shí)，通義靈碼會(huì)給出單行的代碼建議。

2 智能問(wèn)答使用指南

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

說(shuō)明

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

2.1 研發(fā)智能問(wèn)答

使用通義靈碼的智能問(wèn)答時(shí)，為了通義靈碼與您的對(duì)話(huà)能夠更友好、高效，希望您能夠在輸入問(wèn)題時(shí)：

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

2.1.1 自由問(wèn)答

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

操作	macOS	Windows
打開(kāi)/關(guān)閉 AI 程序員	? ? L	Ctl Shift L

2.1.2 代碼問(wèn)答

當(dāng)您對(duì)某段代碼有疑問(wèn)或期望針對(duì)代碼進(jìn)行一些問(wèn)題解決時(shí) ，選中代碼后，在智能問(wèn)答窗口的輸入框中輸入您的問(wèn)題，通義靈碼將圍繞選中代碼與您開(kāi)展對(duì)話(huà)。

2.1.3 @workspace 本地工程問(wèn)答

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

2.1.4@terminal 問(wèn)答

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

2.1.5#teamDocs 知識(shí)庫(kù)問(wèn)答（企業(yè)版）

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

2.1.6清空會(huì)話(huà)上下文歷史記憶

當(dāng)您在會(huì)話(huà)中時(shí)，在智能問(wèn)答輸入框中輸入 ?/? 即可看到 ?/clear context? 指令，選擇后即可清空當(dāng)前會(huì)話(huà)的上下文歷史記憶。

2.1.7新建會(huì)話(huà)

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

2.1.8查看會(huì)話(huà)歷史

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

2.2智能生成指令

2.2.1指令觸發(fā)方式

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

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

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

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

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

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

2.2.2.1指令一：解釋代碼

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

2.2.2.2 指令二：生成單元測(cè)試

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

2.2.2.3指令三：生成注釋

一鍵生成方法注釋及行間注釋?zhuān)?jié)省您寫(xiě)代碼注釋的時(shí)間，并能夠有效提升代碼可讀性。

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

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

2.2.3生成回答后快捷操作

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

• 生成單元測(cè)試：

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

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

• 采納代碼優(yōu)化建議：針對(duì)優(yōu)化建議中的建議代碼，支持一鍵插入、復(fù)制，快速采納生成的建議代碼；
• 查看 Diff：?jiǎn)螕舨榭?Diff 按鈕，將快速喚起 IDE Diff 查看窗口，快速了解建議和源代碼的變更；

• 生成代碼注釋?zhuān)?/strong>

• 采納代碼注釋建議：支持一鍵插入、復(fù)制，可快速采納生成的代碼注釋建議；
• 查看 Diff：?jiǎn)螕舨榭?Diff 按鈕，將快速喚起 IDE Diff 查看窗口，快速了解建議和源代碼的變更。

• 解釋代碼：

• 支持重試、更詳細(xì)、更簡(jiǎn)單、中文/英文解釋的追問(wèn)。

2.3 問(wèn)題修復(fù)建議 

 2.3.1 代碼問(wèn)題（Problem）一鍵修復(fù)

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

2.3.2 異常報(bào)錯(cuò)排查（IntelliJ IDEA）

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

2.3.3 執(zhí)行報(bào)錯(cuò)、編譯報(bào)錯(cuò)排查（Visual Studio Code）

在 Visual Studio Code 中， 當(dāng) terminal 中執(zhí)行指令后報(bào)錯(cuò)、編譯或運(yùn)行后有大量報(bào)錯(cuò)，需要進(jìn)行解釋或修復(fù)時(shí) ，可以選中報(bào)錯(cuò)信息，右鍵選擇使用通義靈碼一鍵解釋?zhuān)矔?huì)為您生成相關(guān)命令解釋及問(wèn)題解決建議。

2.4 提交信息生成

當(dāng)您有代碼變更需要提交，需要寫(xiě)提交信息時(shí) ，可以通過(guò)通義靈碼一鍵生成 Git 提交信息，同時(shí)可以在插件設(shè)置中配置生成的語(yǔ)言（英文/中文）。

3 AI程序員

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

說(shuō)明

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

AI 程序員可以幫助開(kāi)發(fā)者快速完成一個(gè)研發(fā)任務(wù)的代碼編寫(xiě)工作，在與 AI 程序員對(duì)話(huà)過(guò)程中，可以遵循以下幾點(diǎn)建議：

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

通義靈碼，每天進(jìn)步不止一點(diǎn)點(diǎn)，可以和開(kāi)發(fā)者協(xié)同完成編碼任務(wù)。

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

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

操作	macOS	Windows
打開(kāi)/關(guān)閉 AI 程序員	? ? I	Ctl Shift I

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

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

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

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

3.1.3 需求描述輸入（User Input）

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

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

3.1.4.1 變更文件生成過(guò)程

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

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

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

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

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

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

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

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

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

說(shuō)明

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

當(dāng)所有代碼變更文件均被操作過(guò)拒絕或接受變更后， 當(dāng)前快照 會(huì)變?yōu)橐呀邮?、部分接受、已拒絕狀態(tài)，各個(gè)狀態(tài)的相關(guān)釋義如下：

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

3.1.5 多輪對(duì)話(huà)及變更快照（Multi-turns & Snapshot）

3.1.5.1 進(jìn)行多輪次需求對(duì)話(huà)

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

3.1.5.2 快照查看和變更回退

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

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

4 單元測(cè)試生成（UnitTest Agent）

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

4.1 選擇被測(cè)代碼并輸入測(cè)試要求

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

4.2 選擇和確認(rèn)環(huán)境信息

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

4.3 確定被測(cè)方法

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

說(shuō)明

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

• 選擇方法后，會(huì)提示整體生成過(guò)程預(yù)計(jì)需要的時(shí)間，以供參考。

4.4 查看生成進(jìn)展

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

狀態(tài)	圖標(biāo)含義
	代表運(yùn)行通過(guò)的用例
	代表編譯通過(guò)但運(yùn)行失敗的用例
	代表編譯失敗的用例

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

4.5 審查、接受測(cè)試用例文件代碼

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

4.6 查看會(huì)話(huà)歷史

如果需要回顧歷史的會(huì)話(huà)任務(wù)，可單擊會(huì)話(huà)歷史按鈕。你與 AI 程序員的會(huì)話(huà)均有 @AI Developer 標(biāo)簽，單擊后即可查看相關(guān)對(duì)話(huà)過(guò)程。

四、登錄通義靈碼

步驟 1：準(zhǔn)備工作

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

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

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

使用阿里云賬號(hào)登錄通義靈碼有兩種方式：

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

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

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

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

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

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

如果遇到無(wú)法打開(kāi)瀏覽器的阿里云登錄頁(yè)面時(shí)，可使用阿里云賬號(hào)的 AK/SK 登錄通義靈碼，情況如下：

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

操作步驟如下：

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

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

相關(guān)鏈接：

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