通義靈碼是阿里云與通義實驗室聯(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 為例來詳細講解通義靈碼的安裝與使用:
本安裝步驟適用于 macOS、Windows 或 Linux 的 Visual Studio Code 中安裝通義靈碼。
說明
單擊?立即安裝
?,喚起 Visual Studio Code 插件市場直接安裝,安裝后請重啟 IDE,即可開啟智能編碼之旅。
TONGYI Lingma
?,找到通義靈碼后單擊?安裝
?。
如果需要在 Visual Studio Code 中使用通義靈碼,必須完成通義靈碼插件安裝及阿里云賬號登錄。
操作 |
macOS |
Windows |
打開/關閉智能問答窗口 |
|
|
接受行間代碼建議 |
|
|
廢棄行間代碼建議 |
|
|
查看上一個行間推薦結(jié)果 |
|
|
查看下一個行間推薦結(jié)果 |
|
|
手動觸發(fā)行間代碼建議 |
|
|
步驟 1:在 Visual Studio Code 的首選項中,單擊快捷鍵的設置入口;
步驟 2:在快捷鍵管理窗口中,輸入 TONGYI Lingma 搜索,單擊編輯。在彈出的窗口中輸入用于命令的按鍵,然后單擊?Enter
?/?Return
?。
可以通過 2 個方法啟用或禁用行間生成功能:
方法 1:單擊狀態(tài)欄的通義靈碼圖標,在彈出的窗口中可快速啟用或禁用行間生成功能:
方法 2:插件設置頁面啟用或禁用行間生成,并支持設置生成的長度。
通義靈碼的智能問答窗口中,單擊設置,找到函數(shù)的行間快捷入口設置,可以進行啟用或禁用該功能。
打開插件設置頁面,可以設置是否同時展示行間自動生成建議和 IDE 原生下拉補全,默認不勾選。
通義靈碼的智能問答窗口中,可以通過 2 種方式查看使用幫助:
/help
? 指令快捷查看使用幫助;
在智能問答中,你可以對通義靈碼所生成的回答內(nèi)容進行評價,支持點贊和點踩,以不斷優(yōu)化回答效果。
當你在使用的過程有任何疑問、優(yōu)化建議、功能訴求等,均可在通義靈碼的智能問答窗口單擊提交反饋,即可前往阿里云開發(fā)者社區(qū)-通義靈碼問答專區(qū) 向我們提出問題。
為了給你提供更好的智能編碼體驗,我們也期待收到你的使用體驗反饋、優(yōu)化建議以及你的期待,我們會不斷努力和優(yōu)化產(chǎn)品體驗。
通義靈碼提供了多種智能補全的方式,可以根據(jù)當前代碼文件、跨文件的上下文或企業(yè)代碼規(guī)范等,為您生成行級/函數(shù)級代碼,讓您更專注在技術設計。
說明
在 IDE 環(huán)境中使用通義靈碼,需要先完成通義靈碼插件安裝及阿里云賬號登錄。詳細信息可查看下載安裝指南 。
當你在 IDE 編輯器區(qū)進行代碼編寫時
,在開啟自動云端生成的模式下,通義靈碼會根據(jù)當前代碼文件及相關代碼文件的上下文,自動為你生成行級/函數(shù)級的代碼建議,此時你可以使用快捷鍵采納、廢棄,或查看不同的代碼建議。
同時,當你在編碼的過程中,也可以通過快捷鍵
?
?
手動觸發(fā)生成代碼建議。P
?
編輯器中代碼建議相關操作的快捷鍵如下:
操作
|
macOS
|
Windows
|
接受行間代碼建議
|
|
|
廢棄行間代碼建議
|
|
|
查看上一個行間推薦結(jié)果
|
|
|
查看下一個行間推薦結(jié)果
|
|
|
手動觸發(fā)行間代碼建議
|
|
|
Tips:不同操作系統(tǒng)的快捷鍵配置可查看配置和反饋指南 。
在編輯器中,可以直接通過自然語言的方式描述需要實現(xiàn)的需求,通義靈碼可以在編輯器中生成代碼建議,單擊
Tab
可直接采納。
企業(yè)管理員上傳并啟用行間代碼生成知識庫,并設置為組織內(nèi)開發(fā)者可見成員后,開發(fā)者在 IDE 的代碼編輯器中編寫代碼時,通過快捷鍵
手動觸發(fā),通義靈碼將根據(jù)知識庫中的內(nèi)容自動生成符合企業(yè)規(guī)范的代碼建議。
有關企業(yè)管理員如何準備代碼庫以及開發(fā)者,以及如何使用代碼生成增強功能的詳細介紹,可參考企業(yè)代碼補全增強使用實踐 。
通義靈碼代碼補全默認使用云端大模型進行智能續(xù)寫, 當網(wǎng)絡情況有限制時 ,可使用本地補全模式,單擊狀態(tài)欄圖標切換至本地補全模式后,編輯器中進行編碼時,通義靈碼會給出單行的代碼建議。
通義靈碼,作為您的智能編碼助手,可以在您進行編碼工作遇到疑問時幫您答疑解惑,并快速為您生成建議代碼,能夠幫您生成代碼注釋、生成單元測試、進行代碼優(yōu)化、解釋工程和代碼文件、修復代碼問題、排查編譯報錯、生成提交信息等。
說明
在 IDE 環(huán)境中使用通義靈碼,需要先完成通義靈碼插件安裝及阿里云賬號登錄。詳細信息可查看下載安裝指南 。
使用通義靈碼的智能問答時,為了通義靈碼與您的對話能夠更友好、高效,希望您能夠在輸入問題時:
當您編碼遇到問題,缺乏具體解決思路時
,可單擊 IDE 側(cè)邊工具導航或使用
?
?
?
?
喚起通義靈碼智能問答助手,無需離開 IDE 客戶端,即可快速獲得答案和解決思路。
L
?
操作
|
macOS
|
Windows
|
打開/關閉 AI 程序員
|
|
|
當您對某段代碼有疑問或期望針對代碼進行一些問題解決時 ,選中代碼后,在智能問答窗口的輸入框中輸入您的問題,通義靈碼將圍繞選中代碼與您開展對話。
當您需要快速了解一個工程、查找工程內(nèi)的實現(xiàn)邏輯,或有新的訴求需要進行代碼變更時 ,可以在智能問答窗口中通過
可喚起 @
?
,選中后輸入您的問題或訴求,通義靈碼可快速結(jié)合當前倉庫進行工程理解、代碼查詢、代碼問答等,同時可以通過自然語言描述需求,結(jié)合當前工程生成簡單需求或缺陷的整體修改建議和相關建議代碼。
@workspace
?
當您遇到執(zhí)行指令不知道如何寫,或者不清楚某個指令的意思時 ,可以在智能問答窗口中通過
可喚起 @
?
,選擇后使用自然語言描述您的需要指令訴求,通義靈碼將可以生成您需要的命令。生成指令后,您可以一鍵插入到 terminal 中進行執(zhí)行或讓通義靈碼繼續(xù)解釋。當然,您也可以在選擇 @terminal
?
后,輸入指令讓通義靈碼生成指令解釋。
@terminal
?
當您需要結(jié)合企業(yè)內(nèi)私域知識信息讓通義靈碼進行回答時 ,可以在智能問答窗口中通過
喚起 #
?
,并輸入問題,通義靈碼將結(jié)合企業(yè)知識庫(當前用戶有權限的知識庫)對問題進行回答,在回復中也可以單擊查看引用的企業(yè)知識庫內(nèi)容。#teamDocs
?
當您在會話中時,在智能問答輸入框中輸入
即可看到 /
?
指令,選擇后即可清空當前會話的上下文歷史記憶。
/clear context
?
在智能問答窗口中,單擊右上角的新建按鈕即可新建會話窗口,單擊后會話窗口將回到默認狀態(tài)。
歷史會話功能幫助您檢索和回顧與通義靈碼的交流記錄,方便針對多次的建議進行對比和選擇。不管您在哪個 IDE 客戶端上、哪個工程中,均可以查看或搜索您和通義靈碼的歷史會話。
通義靈碼提供多處觸發(fā)單元測試生成、代碼解釋、生成代碼注釋、代碼優(yōu)化功能的入口,當您選中的代碼后,有 3 種觸發(fā)方式:
?/
?
查看快捷指令,單擊對應功能操作。
當需要針對一個方法實現(xiàn)生成單元測試、代碼注釋、代碼解釋、代碼優(yōu)化時,無需選中代碼,可直接單擊函數(shù)上方的快捷入口觸發(fā)相關功能操作。
當您選中代碼后,并通過在智能問答窗口的輸入框輸入 / 的方式選中指令后,可以繼續(xù)輸入附加的要求,比如:
?/generate unit test
?
后,繼續(xù)輸入您對單元測試生成的要求,比如
使用 ?JUnit 5
? 生成
;
?/generate comment
?
后,繼續(xù)輸入生成注釋的要求,比如
開頭標明日期,并用英文注釋
。
覆蓋各種編程語言,選中代碼后可自動識別編程語言并生成代碼解釋??缭秸Z言的邊界,讓您閱讀代碼更高效。
支持根據(jù) JUnit、Mockito、Spring Test、unit test、pytest 等框架生成單元測試。
一鍵生成方法注釋及行間注釋,節(jié)省您寫代碼注釋的時間,并能夠有效提升代碼可讀性。
深度分析代碼及其上下文,迅速識別潛在的編碼問題,從簡單的語法錯誤到復雜的性能瓶頸,均能夠指出問題所在,并提供具體的優(yōu)化建議代碼。
針對不同的指令生成回答后,在智能問答區(qū)中,可以繼續(xù)根據(jù)訴求進行操作,不同功能的對應操作如下:
當您在編碼過程中出現(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 程序員對話過程中,可以遵循以下幾點建議:
通義靈碼,每天進步不止一點點,可以和開發(fā)者協(xié)同完成編碼任務。
當開發(fā)者期望和 AI 程序員一起完成一個研發(fā)任務時,可以通過 IDE 擴展導航打開通義靈碼插件的窗口,并切換到 AI 程序員模塊,或使用快捷鍵
喚起 AI 程序員,即可開始使用。
操作
|
macOS
|
Windows
|
打開/關閉 AI 程序員
|
|
|
AI 程序員與開發(fā)者一起圍繞開發(fā)任務進行編碼工作時,開發(fā)者需要輸入清晰的需求描述和要求,AI 程序員可以為開發(fā)者在工程內(nèi)進行多個文件的修改,開發(fā)者審查并接受相關代碼變更即可。
同時,通義靈碼提供了相關的交互界面幫助開發(fā)者與 AI 程序員進行對話和交互,整體交互界面區(qū)域如下:
打開 AI 程序員后,即可看到需求輸入?yún)^(qū)域,在輸入框內(nèi)單擊 ? 或者輸入
即可選擇需要的相關上下文。輸入完成后發(fā)送即可,AI 程序員將根據(jù)需求描述自動進行需求理解、相關信息檢索、任務拆解、編碼實現(xiàn)等。
當 AI 程序員對工程內(nèi)多個代碼文件進行修改時,每一個文件的修改將至少經(jīng)歷生成、應用的過程,生成代碼變更的過程中,可在 AI 程序員的回答卡片中和工作區(qū)中看到相關的變更文件,以及相應的狀態(tài):
回答卡片中的文件或工作區(qū)的文件在生成中、應用中的狀態(tài)時,單擊對應文件,即可看到對應文件的代碼修改建議生成過程、代碼變更文件與原文件變更對比(Diff)生成過程。
AI 程序員完成的代碼變更文件將聚合在 工作區(qū)
,方便開發(fā)者進行查看和操作。
單擊工作區(qū)的查看變更按鈕或單擊文件列表中的某文件,即可看到對應文件的變更對比查看視圖(Diff View),開發(fā)者在此視圖中可以進行如下操作:
JetBrains IDEs 的視圖和操作位置,示意如下::
VS Code 的視圖和操作位置,示意如下:
說明
- 開發(fā)者基于當前快照的代碼變更文件產(chǎn)生的修改,將統(tǒng)一進入當前快照的最新內(nèi)容中,進行拒絕或接受操作時,將統(tǒng)一被拒絕或接受;
- 當單擊接受某片段、某文件的代碼變更時,變更內(nèi)容將被合并到原文件代碼內(nèi)容中。
當所有代碼變更文件均被操作過拒絕或接受變更后, 當前快照 會變?yōu)橐呀邮堋⒉糠纸邮?、已拒絕狀態(tài),各個狀態(tài)的相關釋義如下:
當進行了一輪對話并生成代碼變更文件后,如需繼續(xù)補充需求或者修改需求,可在當前任務的會話流中繼續(xù)提問,AI 程序員將結(jié)合前序輪次生成的代碼變更分析補充的需求,并生成新的代碼修改建議,產(chǎn)生一個或多個新的代碼變更文件。
當需要查看或回退到前序輪次的修改時,可單擊下拉箭頭查看當前會話任務中產(chǎn)生的多次代碼變更快照,選擇后,可以看到相關信息變化或進行切換操作:
單元測試智能體是 AI 程序員所具備的一種專項能力,可以 針對代碼變更(?#codeChanges
?)、單個或多個代碼文件批量生成單元測試文件 。開發(fā)者輸入被測內(nèi)容、生成要求,AI 程序員即可自動生成測試計劃、測試用例、編譯、運行以及根據(jù)錯誤信息進行自動修復,大幅提升測試用例覆蓋度和用例的生成質(zhì)量,降低開發(fā)者編寫單元測試用例的成本。
打開 AI 程序員后,在輸入框內(nèi)單擊 ? 或者輸入
即可選擇需要的相關上下文,并輸入相關的指令要求( 建議輸入和生成單元測試相關要求的內(nèi)容 ),輸入完成后發(fā)送即可,AI 程序員會自動感知意圖,開始進入生成單元測試的流程。
收到測試要求后,AI 程序員會自動檢測本地環(huán)境 Java 版本、構(gòu)建工具、測試框架、Mock 框架等信息,如果檢測到多個版本,開發(fā)者可主動選擇需要的版本;如果無法識別,將看到提示錯誤,單擊“如何修復”按鈕,開發(fā)者可以進一步了解如何配置相關組件。
環(huán)境信息檢查通過后,AI 程序員將自動分析被測文件,并生成測試計劃,開發(fā)者可以主動選擇需要覆蓋的方法,選擇并確認完成后,單擊確定按鈕,即可開始為每個方法生成單元測試用例。
說明
- 每次至少選擇 1 個方法為其生成測試用例,最多選擇 20 個方法;
- 選擇方法后,會提示整體生成過程預計需要的時間,以供參考。
在確定被測方法后,AI 程序員將自動根據(jù)開發(fā)者選擇的被測方法進行單測用例生成工作,并自動對生成的結(jié)果進行編譯、運行和自動修復。最終的結(jié)果會展示在界面中,狀態(tài)及釋義如下:
狀態(tài)
|
圖標含義
|
![]() |
代表運行通過的用例
|
![]() |
代表編譯通過但運行失敗的用例
|
![]() |
代表編譯失敗的用例
|
當所有方法的用例生成完成后,AI 程序員自動將編譯通過和運行通過的用例合并成最終測試用例文件,并根據(jù)被測文件自動進行命名。對于編譯失敗的測試用例代碼,開發(fā)者可自行選擇是否需要,所有用例代碼確認后,可單擊完成按鈕,測試用例文件將自動與原測試用例文件進行差異對比。
確認完成后,測試用例文件會出現(xiàn)在工作區(qū)中,開發(fā)者可單擊工作區(qū)的查看變更按鈕或單擊文件列表中的某文件,即可看到對應文件的變更對比查看視圖(Diff View),開發(fā)者可進行審查、局部修改、接受或拒絕部分代碼等。確認所有代碼變更后,單擊接受按鈕,,測試用例文件變更代碼將正式進入到當前代碼工程。
如果需要回顧歷史的會話任務,可單擊會話歷史按鈕。你與 AI 程序員的會話均有
標簽,單擊后即可查看相關對話過程。
說明
如果你的電腦安裝多個 IDE 本地客戶端,均安裝通義靈碼的情況,登錄狀態(tài)在多個 IDE 客戶端的通義靈碼插件中同步,你只需要登錄一次即可。
使用阿里云賬號登錄通義靈碼有兩種方式:
安裝完通義靈碼插件后,通常情況下,你可以通過 IDE 客戶端的插件上的登錄按鈕前往阿里云登錄頁完成登錄,操作步驟如下:
如果遇到無法打開瀏覽器的阿里云登錄頁面時,可使用阿里云賬號的 AK/SK 登錄通義靈碼,情況如下:
操作步驟如下:
?
?
P
(
Ctl
Shift
P
)打開命令面板,搜索 TONGYI Lingma,即可看到使用 AK/SK 登錄通義靈碼,單擊后分步輸入 AccessKey ID、AccessKey Secret,選擇身份(未加入任何企業(yè)時將跳過)單擊
Enter
/
Return
鍵,即可完成登錄;
更多建議: