基于GLM-4 API与IntelliJ SDK，打造你的智能Java代码助手插件

1. 为什么需要智能Java代码助手插件作为一名Java开发者我经常遇到这样的场景面对一个复杂业务逻辑时需要反复查阅文档接手老项目时看不懂前人写的晦涩代码或者想快速生成一些样板代码却总是记不住语法细节。这些问题不仅浪费时间还影响开发效率。GLM-4大模型的出现改变了这种状况。它具备128K的长文本理解能力可以精准解析代码上下文在Java语法理解方面表现优异甚至能识别常见的框架模式。实测下来对于Spring Boot、MyBatis等流行框架的代码生成准确率能达到85%以上。把GLM-4集成到IntelliJ IDEA中相当于给你的IDE装上了AI大脑。我开发过三个类似插件后发现最实用的功能包括通过注释自动生成方法实现对选中的复杂代码段进行白话解释根据代码上下文智能推荐重构方案快速生成单元测试模板2. 搭建IntelliJ插件开发环境2.1 准备工具链首先确保你的IntelliJ IDEA是Ultimate版社区版也能用但功能受限我用的2023.2版本。打开Plugin SDK管理器安装这两个关键组件# Gradle项目需要添加插件依赖 plugins { id java id org.jetbrains.intellij version 1.15.0 } # 配置IntelliJ平台设置 intellij { version 2023.2 plugins [java] }建议使用Gradle构建项目比Maven的配置更简洁。遇到过坑JDK必须用11版本否则会报平台API不兼容错误。2.2 初始化插件项目在IDEA中选择新建项目 → Gradle → IntelliJ Platform Plugin。关键配置项勾选Java支持添加Kotlin支持可选但推荐模板选择Action Plugin项目结构生成后重点关注这几个目录src/main/java- 插件主逻辑代码resources/META-INF- 插件描述文件build.gradle- 依赖管理3. 集成GLM-4 API到插件3.1 封装API客户端GLM-4官方提供了Java SDK但实测用原生HTTP调用更灵活。这里分享我优化过的OkHttp实现public class GLM4Client { private static final String API_URL https://open.bigmodel.cn/api/paas/v4/chat/completions; private final OkHttpClient client new OkHttpClient(); public String generateCode(String prompt) throws IOException { String jsonBody new JSONObject() .put(model, glm-4) .put(messages, new JSONArray() .put(new JSONObject() .put(role, user) .put(content, prompt) )) .toString(); Request request new Request.Builder() .url(API_URL) .addHeader(Authorization, Bearer apiKey) .post(RequestBody.create(jsonBody, MediaType.get(application/json))) .build(); try (Response response client.newCall(request).execute()) { JSONObject jsonResponse new JSONObject(response.body().string()); return jsonResponse.getJSONArray(choices) .getJSONObject(0) .getJSONObject(message) .getString(content); } } }注意三个优化点使用连接池减少重复建立连接的开销对API响应做异常状态码处理设置合理的超时时间建议connectTimeout10s3.2 设计提示词模板直接让GLM-4生成代码容易得到不符合预期的结果。经过多次尝试我总结出这套提示词结构【角色】你是一位资深Java专家 【任务】根据需求生成符合规范的代码 【约束】 1. 使用Java {version} 2. 遵循{code_style}规范 3. 需要兼容{framework}框架 4. 添加必要的空行和注释 【示例】{example_code} 【需求】用户实际输入的需求描述例如生成Spring Controller的模板String prompt 你是一位精通Spring Boot的Java专家 需要生成一个用户管理模块的RESTful Controller 要求 1. 使用Java 17 2. 符合Google Java Style规范 3. 包含基本的CRUD操作 4. 使用Lombok简化代码 示例参考 RestController RequestMapping(/api/users) RequiredArgsConstructor public class UserController { private final UserService userService; } 请补全完整的Controller实现;4. 实现插件核心功能4.1 代码生成功能在plugin.xml中注册Actionactions action idCodeGenerator classcom.your.pkg.CodeGenAction textGenerate Code descriptionAI代码生成 add-to-group group-idEditorPopupMenu anchorlast/ keyboard-shortcut keymap$default first-keystrokectrl shift G/ /action /actions对应的Java实现public class CodeGenAction extends AnAction { Override public void actionPerformed(AnActionEvent e) { Editor editor e.getData(CommonDataKeys.EDITOR); String selectedText editor.getSelectionModel().getSelectedText(); // 弹出输入对话框 InputDialog dialog new InputDialog(输入代码需求, selectedText); if (dialog.showAndGet()) { String prompt buildPrompt(dialog.getInput()); String generatedCode glm4Client.generateCode(prompt); // 插入到编辑器 Document document editor.getDocument(); document.insertString(editor.getCaretModel().getOffset(), generatedCode); } } }4.2 代码解释功能对于阅读复杂代码特别有用实现要点获取选中代码的PSI元素提取方法签名、变量名等元信息构造解释型提示词public void explainCode(AnActionEvent e) { PsiElement element e.getData(CommonDataKeys.PSI_ELEMENT); String codeContext ((PsiMethod)element).getText(); String prompt 用通俗语言解释这段Java代码\n codeContext \n重点说明\n1. 方法功能\n2. 关键算法\n3. 输入输出; String explanation glm4Client.generateCode(prompt); Messages.showMessageDialog(explanation, 代码解释, Messages.getInformationIcon()); }5. 提升插件体验的技巧5.1 添加进度指示长时间等待API响应会让用户以为卡死了。推荐添加进度条ProgressManager.getInstance().run(new Task.Backgroundable(project, 生成中...) { public void run(NotNull ProgressIndicator indicator) { indicator.setText(正在请求GLM-4 API...); String result glm4Client.generateCode(prompt); // 更新UI需要回到EDT线程 ApplicationManager.getApplication().invokeLater(() - updateEditor(result)); } });5.2 实现代码补全通过实现CompletionContributor扩展IDE的智能提示public class AICodeCompletion extends CompletionContributor { public AICodeCompletion() { extend(CompletionType.BASIC, PlatformPatterns.psiElement().withLanguage(JavaLanguage.INSTANCE), new CompletionProvider() { Override protected void addCompletions(NotNull CompletionParameters parameters, NotNull ProcessingContext context, NotNull CompletionResultSet result) { String prefix result.getPrefixMatcher().getPrefix(); String suggestions glm4Client.getCodeSuggestions(prefix); result.addAllElements(parseSuggestions(suggestions)); } }); } }5.3 配置缓存机制频繁调用API既慢又耗token。我的解决方案使用Caffeine缓存高频请求本地保存历史记录对相似代码做指纹去重LoadingCacheString, String codeCache Caffeine.newBuilder() .maximumSize(1000) .expireAfterWrite(1, TimeUnit.HOURS) .build(key - glm4Client.generateCode(key));6. 调试与性能优化6.1 常见问题排查遇到过最头疼的三个问题API响应超时 → 调整OkHttp的超时参数生成的代码格式混乱 → 使用Eclipse Code Formatter修复插件与其他插件冲突 → 检查dependency范围建议的调试流程先确保GLM-4 API能单独调通测试最小化的Action功能逐步添加复杂逻辑6.2 性能数据对比在我的MacBook Pro M1上测试结果操作类型平均耗时(无缓存)启用缓存后生成简单方法1.2s0.3s解释复杂类3.5s1.8s重构建议2.1s0.9s关键发现首次加载需要初始化模型后续请求更快代码补全建议对延迟最敏感建议预加载超过500行的文件处理性能明显下降7. 插件发布与后续迭代打包插件很简单Gradle任务一键完成./gradlew buildPlugin生成的zip文件在build/distributions目录下。上传到JetBrains Marketplace需要注意提供清晰的图标和演示GIF详细的功能说明文档兼容性矩阵支持哪些IDEA版本持续迭代建议收集用户的prompt模板增加对Kotlin的支持实现学习项目代码风格功能添加单元测试生成器开发这类插件的最大体会是不要追求大而全先解决一个具体痛点。比如我最初版本只做方法生成后来才逐步添加其他功能。每次迭代后观察用户反馈用数据驱动优化方向。