通義靈碼 - HTML智能編碼輔助AI工具

2025-03-12 09:52 更新

通義靈碼是阿里云與通義實(shí)驗(yàn)室聯(lián)合打造的智能AI編碼輔助工具,基于通義大模型技術(shù),為開(kāi)發(fā)者提供多種編程輔助功能。它支持多種編程語(yǔ)言,包括 Java、Python、 GoTypeScript、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。

從插件市場(chǎng)安裝通義靈碼


方法 2:下載安裝包安裝

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

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

  1. 重啟 Visual Studio Code 后,單擊側(cè)邊導(dǎo)航的通義靈碼,在通義靈碼助手的窗口單擊登錄按鈕。
    通義靈碼 登錄并開(kāi)啟智能編碼之旅
    Tips:如果安裝后在側(cè)邊導(dǎo)航上找不到通義靈碼入口,可鼠標(biāo)聚焦在側(cè)邊導(dǎo)航后右鍵查看,勾選通義靈碼后即可將插件入口配置在側(cè)邊導(dǎo)航上。
    通義靈碼登錄并開(kāi)啟智能編碼之旅2
  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?。

通義靈碼 重新綁定快捷鍵2

啟用或禁用行間生成

可以通過(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è)置頁(yè)面啟用或禁用行間生成,并支持設(shè)置生成的長(zhǎng)度

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

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

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

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

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

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


查看幫助和分享反饋

查看使用幫助

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

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


反饋回答質(zhì)量

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

image (12)


使用問(wèn)題反饋

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

image (13)


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

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

image (14)

三、通義靈碼核心能力

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ā)生成代碼建議。


image (15)

編輯器中代碼建議相關(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

可直接采納。



image (16)

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í)踐 。


image (17)



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ì)給出單行的代碼建議。


image (18)


智能問(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

image (19)


2.1.2 代碼問(wèn)答

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


image (20)

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)建議代碼。


image (21)


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? 后,輸入指令讓通義靈碼生成指令解釋。


image (22)


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)容。


image (23)


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

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


image (24)


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

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


image (25)


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

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


image (26)


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)功能操作。


image (27)

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


image (28)


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

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

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

image (29)

2.2.2.1指令一:解釋代碼

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


image (30)



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

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

image (31)


2.2.2.3指令三:生成注釋

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


image (32)


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

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

image (33)


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)建議代碼。


image (34)


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ù)建議。


image (34)


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)題解決建議。


image (35)


2.4 提交信息生成

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


image (35)


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)代碼變更即可。


image (36)


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


image (37)


  • 新建會(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)等。


image (38)

image (39)


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)行查看和操作。


image (41)


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 的視圖和操作位置,示意如下::


image (42)


VS Code 的視圖和操作位置,示意如下:


image (43)


說(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è)新的代碼變更文件。


image (44)


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)。

image (46)


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è)試的流程。


image (47)


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)組件。


image (48)


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í)間,以供參考。

image (49)


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)含義

image (50)

代表運(yùn)行通過(guò)的用例

image (51)

代表編譯通過(guò)但運(yùn)行失敗的用例

image (52)

代表編譯失敗的用例


image (53)


當(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ì)比。


image (54)


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)前代碼工程。


image (55)


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

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


image (56)


四、登錄通義靈碼

步驟 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è);


image (57)


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


image (58)


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 。


image (59)


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 登錄。


image (60)



相關(guān)鏈接:


以上內(nèi)容是否對(duì)您有幫助:
在線(xiàn)筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)