通义灵码插件保姆级教学-IDEA(安装及使用)

技术咖啡馆C2025-01-28 14:45

一、JetBrains IDEA 中安装指南

官方下载指南：通义灵码安装教程-阿里云

步骤 1：准备工作

  • 操作系统：Windows 7 及以上、macOS、Linux；

  • 下载并安装兼容的 JetBrains IDEs 2020.3 及以上版本，通义灵码与以下 IDE 兼容：

    • IntelliJ IDEA（旗舰版、社区版、教育版）

    • PyCharm（专业版、社区版、教育版）

    • WebStorm

    • Android Studio

    • CLion

    • GoLand

    • PhpStorm

    • RustRover

    • Rider

    • RubyMine

步骤 2：在 JetBrains IDEs 中安装通义灵码

方法 1：从插件市场安装

  1. 打开 IntelliJ IDEA 设置窗口，在插件市场中搜索 TONGYI Lingma，找到通义灵码后单击安装。

  2. 安装完成后，请重启 IntelliJ IDEA。

方法 2：下载安装包安装

  1. 单击下方链接，下载 JetBrains IDEs 的 zip 安装包；

    ⇩ TONGYI Lingma - JetBrains

  2. 下载完安装包后，打开 IntelliJ IDEA 后，打开设置，在插件管理的设置下拉菜单中单击从本地安装插件，选择下载的 zip 文件后安装。​

  3. 安装完成后，请重启 IntelliJ IDEA。

步骤 3：登录并开启智能编码之旅

  1. 重启 IntelliJ IDEA 后，单击侧边导航的通义灵码，在通义灵码助手的窗口单击登录按​

  2. 单击登录后，将前往登录页面，完成登录后可进入 IDE 客户端开始使用。登录相关具体操作，可参考：登录通义灵码插件端。

  3. 退出登录，点击右下角通义灵码图标即可退出登录

  4. 高级设置，点击右下角通义灵码图标-->高级设置

二、JetBrains IDEA 中使用指南

2.1、代码解释

选择需要解释的代码 --> 右键 --> 通义灵码 --> 解释代码

解释代码很详细，感觉很强大有木有，关键还会生成流程图，对程序员理解业务非常有帮忙，基本能做到哪里不懂点哪里。

2.2、生成注释

选择需要注释的代码 --> 右键 --> 通义灵码 --> 生成注释

把生成注释的代码替换掉原代码即可，不爱写注释的程序员有福音了。

2.3、代码优化

选择需要优化的代码 --> 右键 --> 通义灵码 --> 优化代码

通义灵码会对所选的代码进行潜在问题分析及风险提醒，并提供优化后的代码

有些不易发找到的bug搞不好使用通义灵码的代码优化功能就找到了，目前很多项目都有高代码质量的要求，多使用代码优化功能写高质量代码不是问题。

2.4、代码片段补全

把光标移动到未写完的代码后，右键 --> 通义灵码 --> 代码片段补全，也可以使用快捷键ALT + P，会显示灰色的建议代码，按Tab键接受代码。

2.5、生成单元测试

在你需要单元测试的方法上点击：通义灵码的图标 --> 生成单元测试

生成单元测试还有设计说明，整得挺真实的，下面附上完整的代码：

java 复制代码 
package com.leonse.xxx;


import com.leonse.xxx.UserServiceImpl;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.mockito.InjectMocks;
import org.mockito.junit.MockitoJUnitRunner;

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;

@RunWith(MockitoJUnitRunner.class)
public class UserServiceImplTest {

    @InjectMocks
    private UserServiceImpl userService;

    @Before
    public void setUp() {
        // 如果需要，可以在此处进行任何设置
    }

    @Test
    public void getGender_NullIdentityCard_ThrowsIllegalArgumentException() {
        assertThrows(IllegalArgumentException.class, () -> userService.getGender(null));
    }

    @Test
    public void getGender_InvalidLength_ThrowsIllegalArgumentException() {
        assertThrows(IllegalArgumentException.class, () -> userService.getGender("12345678901234567"));
    }


    @Test
    public void getGender_ValidMaleIdentityCard_ReturnsMale() {
        String identityCard = "123456199001011235"; // 第17位是5，奇数
        assertEquals("男", userService.getGender(identityCard));
    }

    @Test
    public void getGender_ValidFemaleIdentityCard_ReturnsFemale() {
        String identityCard = "123456199001011244"; // 第17位是4，偶数
        assertEquals("女", userService.getGender(identityCard));
    }
}

执行单元测试，全部校验通过：

生成的单元测试中缺少了身份证号格式的合法性校验(业务代码里面没有格式校验所以没生成)，并非满足所有场景，需要根据实际情况进行调整或添加，但已满足大部分场景，对手写单元测试来说提升的效率还是蛮高的，这里缺少的部分可以通过智能问答来补充，下面会说怎么补充。

2.6、智能问答

点击右边的通义灵码图标 --> 智能问答 --> ＋ --> 选择 UserServiceImpl，在对话框输入：getGender 方法增加身份证号码格式校验，然后按回车即可生成增加身份证号码格式校验的代码，速度还不慢；

生成的完整代码如下：

java 复制代码 
    /**
     * 给定一个身份证号，计算出该用户的性别
     *
     * @param identityCard 身份证号
     */
    @Override
    public String getGender(String identityCard) {
        if (identityCard == null || identityCard.length() != 18) {
            throw new IllegalArgumentException("无效的身份证号码");
        }

        // 校验身份证号码格式
        if (!identityCard.matches("\\d{17}[0-9Xx]")) {
            throw new IllegalArgumentException("无效的身份证号码格式");
        }

        int genderDigit = Integer.parseInt(identityCard.substring(16, 17));
        return genderDigit % 2 == 1 ? "男" : "女";
    }

这里还少了验证身份证号码格式的单元测试，在对话框输入：补充一条校验身份证格式的单元测试用例

java 复制代码 
package com.xxx;


import com.xxx.UserServiceImpl;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.mockito.InjectMocks;
import org.mockito.junit.MockitoJUnitRunner;

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;

@RunWith(MockitoJUnitRunner.class)
public class UserServiceImplTest {

    @InjectMocks
    private UserServiceImpl userService;

    @Before
    public void setUp() {
        // 如果需要，可以在此处进行任何设置
    }

    @Test
    public void getGender_NullIdentityCard_ThrowsIllegalArgumentException() {
        assertThrows(IllegalArgumentException.class, () -> userService.getGender(null));
    }

    @Test
    public void getGender_InvalidLength_ThrowsIllegalArgumentException() {
        assertThrows(IllegalArgumentException.class, () -> userService.getGender("12345678901234567"));
    }

    @Test
    public void getGender_InvalidFormat_ThrowsIllegalArgumentException() {
        assertThrows(IllegalArgumentException.class, () -> userService.getGender("s12345678901234567")); // 长度正确但格式错误
        assertThrows(IllegalArgumentException.class, () -> userService.getGender("12345678901234567文")); // 长度正确但格式错误
        assertThrows(IllegalArgumentException.class, () -> userService.getGender("12345678901234567G")); // 长度正确但最后一位不是数字或X
    }

    @Test
    public void getGender_ValidMaleIdentityCard_ReturnsMale() {
        String identityCard = "123456199001011235"; // 第17位是5，奇数
        assertEquals("男", userService.getGender(identityCard));
    }

    @Test
    public void getGender_ValidFemaleIdentityCard_ReturnsFemale() {
        String identityCard = "123456199001011244"; // 第17位是4，偶数
        assertEquals("女", userService.getGender(identityCard));
    }
}

执行单元测试，5条用例全部通过

@workspace 本地工程问答

当你需要快速了解一个工程、查找工程内的实现逻辑，或有新的诉求需要进行代码变更时，可以在智能问答窗口中通过 @ 可唤起 @workspace，选中后输入你的问题或诉求，通义灵码可快速结合当前仓库进行工程理解、代码查询、代码问答等，同时可以通过自然语言描述需求，结合当前工程生成简单需求或缺陷的整体修改建议和相关建议代码。

如接手新项目时想快速了解项目架构可在对话框输入：@workspace 详细了解项目架构，通义灵码会详细解析项目的架构的设计。

@terminal 问答

当你遇到执行指令不知道如何写，或者不清楚某个指令的意思时，可以在智能问答窗口中通过 @ 可唤起 @terminal，选择后使用自然语言描述你的需要指令诉求，通义灵码将可以生成你需要的命令。生成指令后，你可以一键插入到 terminal 中进行执行或让通义灵码继续解释。当然，你也可以在选择 @terminal 后，输入指令让通义灵码生成指令解释。

2.7、AI程序员

通义灵码 AI 程序员，具备**多文件代码修改（Multi-file Edit）和工具使用（Tool-use）**的能力，可以与开发者协同完成编码任务，如需求实现、问题解决、单元测试用例生成、批量代码修改等。

说明

使用通义灵码 AI 程序员，需要将通义灵码 IDE 插件升级到最新版本（2.0.0及以上版本）。

AI 程序员可以帮助开发者快速完成一个研发任务的代码编写工作，在与 AI 程序员对话过程中，可以遵循以下几点建议：

  • **清晰的需求描述：**首先需要澄清我们需要 AI 程序员帮我们做什么，建议包含一个明确的目标，并通过步骤式的结构化描述，详细地描述你期望完成的开发任务要求；

  • **指定需要的上下文：**选择代码文件、图片、codebase、codeChanges 等上下文，可以帮助 AI 程序员获取需求相关的语境。同时，结合详细执行步骤和要求，AI 程序员更精准地了解你的意图，生成最佳的方案和建议代码；

  • **明确生成要求：**告诉 AI 程序员在生成代码修改建议时，你期望它遵循的要求，比如语言、规范、格式、变更目标等，如"生成变更时，同时为每个方法生成英文注释"；

  • **善用快照功能：**当 AI 生成内容不符合预期，或你的需求有变化时，可以通过快照功能回退到之前的对话轮次和代码变更，继续重新提问；

  • **审查和修改变更：**AI 程序员完成多个文件的代码变更后，开发者可以通过变更对比查看视图（Diff View）进行审查，以及对局部代码片段进行接受、拒绝、修改，保证最后得到符合预期的代码变更。

在AI程序员对话框输入你要是现在的需求即可生成相关代码

java 复制代码 
package com.xxx.utils;

import java.time.Duration;
import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.temporal.ChronoUnit;
import java.time.temporal.TemporalUnit;

public class DateTimeUtils {

    /**
     * 增加时间的方法
     *
     * @param currentTime 当前时间
     * @param amountToAdd 需要增加的时间值
     * @param unit        需要增加的时间单位
     * @return 增加后的时间对象
     */
    public static LocalDateTime addTime(LocalDateTime currentTime, long amountToAdd, TemporalUnit unit) {
        return currentTime.plus(amountToAdd, unit);
    }

    /**
     * 增加时间的方法（使用Instant）
     *
     * @param currentInstant 当前时间
     * @param amountToAdd    需要增加的时间值
     * @param unit           需要增加的时间单位
     * @return 增加后的时间对象
     */
    public static Instant addTime(Instant currentInstant, long amountToAdd, ChronoUnit unit) {
        return currentInstant.plus(amountToAdd, unit);
    }

    /**
     * 增加时间的方法（使用Duration）
     *
     * @param currentInstant 当前时间
     * @param duration       需要增加的时间间隔
     * @return 增加后的时间对象
     */
    public static Instant addTime(Instant currentInstant, Duration duration) {
        return currentInstant.plus(duration);
    }
}

三、常用的快捷键

通义灵码的多个操作均配备了开箱即用的快捷键，以下列出了几项常用的快捷键。

|---------------|------------------|-----------------|
| 功能 | Windows快捷键 | macOS快捷键 |
| 在任意位置触发补全代码解释 | Alt + P | Option + P |
| 更换生成的结果 | Alt + ] | Option + ] |
| 采纳全部生成的代码 | Tab | Tab |
| 逐行采纳生成的代码 | Ctrl + ↓ | Cmd + ↓ |
| 关闭/打开对话面板 | Ctrl + Shift + L | Cmd + Shift + L |
| 代码解释 | Alt + Shfit + P | |
| 生成单元测试 | Alt + Shfit + U | |
| 生成注释 | Alt + Shfit + V | |
| 代码优化 | Alt + Shfit + O | |
| 代码片段补全 | Alt + P | |

四、总结

总体而言，"通义灵码" 堪称国内极为出色的 AI 插件，它具备强大的兼容性，支持众多 IDE，为广大程序员提供了便利。其核心功能丰富多元，涵盖代码解释，能让复杂代码逻辑一目了然；精准生成注释，助力代码的可读性与可维护性；高效代码优化，去除冗余、提升性能；轻松生成单元测试，为代码质量保驾护航；还有智能答疑解惑以及模拟 AI 程序员辅助开发等实用功能。作为编程领域的得力助手，它完全有能力大幅提升程序员的开发效率，是不可多得的编程利器。

相关推荐
已是上好佳7 分钟前
介绍一下Qt中的事件过滤
java·服务器·数据库
Java中文社群16 分钟前
面试官：你项目是如何保证高可用的？
java·后端·面试
不修×蝙蝠22 分钟前
SpringBoot（一）--搭建架构5种方法
java·spring boot·架构·配置·搭建
FreemanGordon1 小时前
Java volatile 关键字
java
北京_宏哥1 小时前
《手把手教你》系列基础篇（九十三）-java+ selenium自动化测试-框架设计基础-POM设计模式实现-上篇（详解教程）
java·前端·selenium
北京_宏哥1 小时前
《手把手教你》系列基础篇（九十二）-java+ selenium自动化测试-框架设计基础-POM设计模式简介（详解教程）
java·selenium·前端工程化
当归10242 小时前
微服务与消息队列RabbitMQ
java·微服务
Lx3522 小时前
《从头开始学java，一天一个知识点》之：循环结构：for与while循环的使用场景
java·后端
Cache技术分享2 小时前
15. Java 如何声明一个变量来引用数组
java·前端
雷渊2 小时前
深入分析理解mysql的MVCC
java·数据库·面试
热门推荐
01DeepSeek各版本说明与优缺点分析02从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑03如何在WPS和Word/Excel中直接使用DeepSeek功能04如何本地部署AI智能体平台，带你手搓一个AI Agent05DeepSeek R1本地化部署 Ollama + Chatbox 打造最强 AI 工具06本地部署DeepSeek教程（Mac版本）07本地化部署AI知识库：基于Ollama+DeepSeek+AnythingLLM保姆级教程08Windows 11 安装 Dify 完整指南 非docker环境09保姆级教程：利用Ollama与Open-WebUI本地部署 DeedSeek-R1大模型10Coze扣子平台完整体验和实践（附国内和国际版对比）