參考鏈接：
-
通義靈碼產品介紹_智能編碼助手_AI編程_云效(Apsara Devops)-阿里云幫助中心
-
【IDEA如何使用通義靈碼？】_idea 通義靈碼-CSDN博客
1. 簡介
1.1 定義
? ? ? ?通義靈碼，是阿里云出品的一款基于通義大模型的智能編碼輔助工具，提供行級/函數(shù)級實時續(xù)寫、自然語言生成代碼、單元測試生成、代碼注釋生成、代碼解釋、研發(fā)智能問答、異常報錯排查等能力，并針對阿里云 SDK/OpenAPI 的使用場景調優(yōu)，助力開發(fā)者高效、流暢的編碼。
1.2 功能介紹
-
行級/函數(shù)級實時續(xù)寫；
-
自然語言生成代碼；
-
單元測試生成；
-
代碼注釋生成；
-
代碼解釋；
-
研發(fā)領域自由問答；
-
異常報錯智能排查（Java）；
-
雙模引擎，一鍵切換
-
支持 Java、Python、Go、C#、C/C++、JavaScript、TypeScript、PHP、Ruby、Rust、Scala、Kotlin 等主流編程語言。
-
支持 IDE 及操作系統(tǒng)
-
JetBrains IDEs
-
IDE 版本：IntelliJ IDEA、PyCharm、GoLand、WebStorm 等 2020.3 及以上
-
操作系統(tǒng)：Windows 7 及以上、macOS、Linux
-
-
Visual Studio Code
-
IDE 版本：1.75.1 及以上
-
操作系統(tǒng)：Windows 8.1 及以上、macOS、Linux
-
-
詳見：通義靈碼產品介紹_智能編碼助手_AI編程_云效(Apsara Devops)-阿里云幫助中心
2. 安裝
注意：通義靈碼需要登錄阿里云后方可使用，如果你尚未擁有一個阿里云賬號，可前往注冊阿里云賬號
2.1 在線版安裝
（1）打開IDEA，F(xiàn)ile-->Settings...
（2）找到Plugins，切換到Marketplace選項卡下，輸入“TONGYI ”或“TONGYI Lingma”進行搜索，找到TONGYI Lingma插件，Install安裝即可
（3）Install完成后會變成Installed，此時只需要點擊OK，無需重啟IDEA，等待插件安裝完成即可
（4）點擊“登錄”，出現(xiàn)“通義靈碼協(xié)議”對話框，選擇“同意并登錄”，它會默認打開阿里云的登錄地址：
使用阿里云主賬號或者RAM子賬號登錄均可：
登錄成功頁面如下：
再切換回IDEA，在右下角點擊通義靈碼圖標，出現(xiàn)已登錄，表示賬號登錄成功了，接下來就可以使用啦：
退出：通義靈碼登錄說明_智能編碼助手_AI編程_云效(Apsara Devops)-阿里云幫助中心
3.2 離線版安裝
參考：通義靈碼下載和安裝手冊_智能編碼助手_AI編程_云效(Apsara Devops)-阿里云幫助中心
3. 使用
3.1 行級/函數(shù)級實時續(xù)寫
? ? ? ?根據(jù)當前語法和跨文件的代碼上下文，實時生成行、函數(shù)建議代碼。
? ? ? ?當你在 IDE 編輯器區(qū)進行代碼編寫時，在開啟自動云端生成的模式下，通義靈碼會根據(jù)當前代碼文件及相關代碼文件的上下文，自動為你生成行級/函數(shù)級的代碼建議，此時你可以使用快捷鍵采納、廢棄、查看不同的代碼建議，同時，當你在編碼的過程中，也可以通過快捷鍵 ? P 手動觸發(fā)生成代碼建議，具體如下：
示例：
實操：
按下Tab鍵，即可將生成的代碼應用到自己編寫代碼的位置。
其他調整代碼語法如下：
| macOS | Windows | |
|---|---|---|
| 接受行間代碼建議 | Tab |
Tab |
| 廢棄行間代碼建議 | esc |
esc |
| 查看上一個行間推薦結果 |
? [
|
Alt [
|
| 查看下一個行間推薦結果 |
? ]
|
Alt ]
|
| 手動觸發(fā)行間代碼建議 |
? P
|
Alt P
|
3.2 自然語言生成代碼
通過自然語言描述你想要的功能，可直接在編輯器區(qū)生成代碼，編碼心流不間斷。即用自己的語言描述出要實現(xiàn)的功能，通義靈碼會按照功能進行代碼自動補全。
通義靈碼支持兩種通過自然語言描述生成代碼的方式：
-
在編輯器中，直接通過注釋的方式描述你需要的功能，直接在編輯器中生成代碼建議，單擊
Tab可直接采納 ； -
在智能問答中，直接描述你需要的功能，智能問答助手將為你生成代碼建議，并支持一鍵插入或復制代碼。
示例：
實操：
3.3 單元測試生成
支持根據(jù) JUnit、Mockito、Spring Test、unit test、pytest 等框架生成單元測試。
示例：
實操：
3.4 代碼注釋生成
一鍵生成方法注釋及行間注釋，節(jié)省你寫代碼注釋的時間，并能夠有效提升代碼可讀性。
示例：
實操：
3.5 代碼解釋
覆蓋各種編程語言，選中代碼后可自動識別編程語言并生成代碼解釋。跨越語言的邊界，讓你閱讀代碼更高效。
示例：
實操：
總結：
A. 選中代碼后，一鍵觸發(fā)功能
當你選中的代碼后，支持生成單元測試、代碼注釋或代碼解釋，有 3 種觸發(fā)方式：
-
在編輯器中，單擊右鍵找到通義靈碼功能操作入口，單擊對應功能操作；
-
在智能問答中，直接單擊對用功能操作；
-
在智能問答中，使用 / 查看快捷指令，單擊生成單元測試指令。
B.生成回答后，一鍵采納和追問
單擊對應功能操作后，在智能問答區(qū)中，通義靈碼為你所選代碼生成相關回答，此時你可以根據(jù)訴求進行操作，不同功能的對應操作如下：
-
生成單元測試：
-
采納單元測試代碼建議：支持一鍵插入、復制、或者新建代碼文件，可快速采納生成的單元測試代碼建議；
-
更換單元測試框架：目前提供基于 JUnit、Mockito、Spring Test、unit test、pytest 等框架生成單元測試代碼建議，在回答完成后，可以根據(jù)需要切換框架重新生成。
-
-
生成代碼注釋：
-
采納代碼注釋建議：支持一鍵插入、復制，可快速采納生成的代碼注釋建議；
-
查看 Diff：單擊查看 Diff 按鈕，將快速喚起 IDE Diff 查看窗口，快速了解建議和源代碼的變更；
-
重試、使用英文等與代碼注釋相關的追問操作。
-
-
解釋代碼：
-
支持重試、更詳細、更簡單、中文/英文解釋的追問。
-
C. 函數(shù)的行間快捷入口
當需要針對一個方法或功能實現(xiàn)生成單元測試、代碼注釋、代碼解釋時，無需選中代碼，可直接單擊函數(shù)上方的快捷入口觸發(fā)相關功能操作。
Tips：目前該功能 Visual Studio Code 上支持語言：Java、Python、Go、JS/TS、C/C++，JetBrains IDEs 支持語言：Java、Python。
3.6 研發(fā)領域自由問答
遇到編碼疑問、技術難題時，一鍵喚起通義靈碼，無需離開 IDE 客戶端，即可快速獲得答案和解決思路。聚焦研發(fā)領域知識的問答，幫助開發(fā)者快速解決問題。
使用通義靈碼的智能問答時，為了通義靈碼與你的對話能夠更友好、高效，希望你能夠在輸入問題時：
-
選中代碼，開始輸入你的問題，通義靈碼將圍繞著選中代碼與你開展對話；
-
精準表達問題，以及給出相對詳細的上下文輸入， 比如選中的代碼、日志、報錯信息等；
-
多多互動，告訴通義靈碼，所給出代碼建議或回答是否滿足你的預期，或生成內容存在的具體瑕疵，通義靈碼也會不斷改進。
開始自由問答
當你編碼遇到問題，缺乏具體解決思路時，可單擊 IDE 側邊工具導航或使用? ? L喚起通義靈碼智能問答助手，無需離開 IDE 客戶端，即可快速獲得答案和解決思路。
多種快捷指令問答
在智能問答輸入框中，預置了多個常用快捷指令，輸入 / 即可看到相關快捷指令：
-
/help：學習如何使用通義靈碼；
-
/explain code：解釋選中的代碼；
-
/generate unit test：為選中的代碼生成單元測試；
-
/generate comment：為選中的代碼生成方法注釋或行間注釋；文章來源：http://www.zghlxwxcb.cn/news/detail-823296.html
-
/clear context：當你在會話中時，單擊后將清空上下文記憶文章來源地址http://www.zghlxwxcb.cn/news/detail-823296.html
新建會話
在智能問答窗口中，單擊右上角的新建按鈕即可新建會話窗口，單擊后會話窗口將會到默認狀態(tài)。
異常報錯排查（IntelliJ IDEA）
當運行出現(xiàn)異常報錯時，在運行標準輸出窗口中，即可看到通義靈碼的快捷操作按鈕，單擊后，通義靈碼將結合運行代碼、異常堆棧等報錯上下文，快速給出排查思路或修復建議。
IntelliJ IDEA 中技術文檔和代碼片段搜索
在 IntelliJ IDEA 客戶端內，如果你在編碼過程中有需要進行技術資料檢索、代碼片段搜索的訴求，無須離開 IDE，單擊側邊導航的通義靈碼，單擊搜索，即可開始搜索。
示例：
實操：
3.7 異常報錯智能排查（Java）
當運行出現(xiàn)異常報錯時，一鍵啟動報錯排查的智能答疑，可結合運行代碼、異常堆棧等報錯上下文，快速給出排查思路或修復建議代碼。
示例：
實操：
3.8 雙模引擎，一鍵切換
支持極速離線模型（Java/Python）、云端大模型兩種代碼補全方式，極速離線模型擁有單行補全的能力，云端大模型具備函數(shù)生成的能力。在你需要的時候，可一鍵切換，滿足不同網(wǎng)絡環(huán)境、不同補全強度的場景訴求。
示例：
3.9 配置指南
查看快捷鍵
| 操作 | macOS | Windows |
|---|---|---|
| 打開/關閉智能問答窗口 |
? ? L
|
Ctl Shift L
|
| 接受行間代碼建議 | Tab |
Tab |
| 廢棄行間代碼建議 | esc |
esc |
| 查看上一個行間推薦結果 |
? [
|
Alt [
|
| 查看下一個行間推薦結果 |
? ]
|
Alt ]
|
| 手動觸發(fā)行間代碼建議 |
? P
|
Alt P
|
重新綁定快捷鍵
步驟 1：打開 JetBrains IDE 偏好設置（實際IDEA：File->Settings...)，如下圖以 IntelliJ IDEA 為例：
步驟 2：在設置窗口中單擊快捷鍵，輸入面板（英文：Panel）后搜索，找到TONGYI Lingma 快捷鍵，右鍵后單擊修改鍵盤快捷鍵。在彈出的窗口中輸入用于命令的按鍵后，單擊確定即可。
啟用或禁用行間生成
方法 1：單擊狀態(tài)欄的通義靈碼圖標，在彈出的窗口中可快速啟用或禁用行間生成功能：
-
可以配置本地離線模型、云端大模型是否啟用；
-
開啟本地離線模型、云端大模型同時開啟的情況下，行間生成時優(yōu)先推薦云端大模型的代碼建議；
方法 2：打開插件設置頁面，支持啟用或禁用行間生成，以及設置生成的長度。
啟用或禁用函數(shù)的行間快捷入口
打開插件設置頁面，支持啟用或禁用函數(shù)的行間快捷入口。
3.10 查看幫助和分享反饋
查看使用幫助
通義靈碼的智能問答窗口中，可以通過 2 種方式查看使用幫助：
-
通過智能問答的
/help指令快捷查看使用幫助；
-
單擊智能問答窗口的幫助文檔入口，可以快速來到當前幫助文檔知識庫。
反饋回答質量
在智能問答中，你可以對通義靈碼所生成的回答內容進行評價，支持點贊和點踩，以不斷優(yōu)化回答效果。
使用問題反饋
當你在使用的過程有任何疑問、優(yōu)化建議、功能訴求等，均可在通義靈碼的智能問答窗口單擊提交反饋，即可前往阿里云開發(fā)者社區(qū)-通義靈碼問答專區(qū)向我們提出問題。
參與體驗調研
為了給你提供更好的智能編碼體驗，我們也期待收到你的使用體驗反饋、優(yōu)化建議以及你的期待，我們會不斷努力和優(yōu)化產品體驗。
3.11 常見問題
詳見：通義靈碼常見問題_智能編碼助手_AI編程_云效(Apsara Devops)-阿里云幫助中心
4. 總結
4.1 打開工具
-
IDEA操作頁面右下角
-
IDEA右側插件欄
-
Ctrl+Shift+L：喚起只能問答
-
Ctrl+Shift+S：搜索代碼/文檔
4.2 快捷鍵
| 操作 | macOS | Windows |
|---|---|---|
| 打開/關閉智能問答窗口 |
? ? L
|
Ctl Shift L
|
| 接受行間代碼建議 | Tab |
Tab |
| 廢棄行間代碼建議 | esc |
esc |
| 查看上一個行間推薦結果 |
? [
|
Alt [
|
| 查看下一個行間推薦結果 |
? ]
|
Alt ]
|
| 手動觸發(fā)行間代碼建議 |
? P
|
Alt P
|
4.3 快捷指令
-
/help：學習如何使用通義靈碼；
-
/explain code：解釋選中的代碼；
-
/generate unit test：為選中的代碼生成單元測試；
-
/generate comment：為選中的代碼生成方法注釋或行間注釋；
-
/clear context：當你在會話中時，單擊后將清空上下文記憶
到了這里，關于在IntelliJ IDEA上使用通義靈碼(TONGYI Lingma)的文章就介紹完了。如果您還想了解更多內容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持TOY模板網(wǎng)！
