必须完成插件安装、账号绑定、模型后端选择三步闭环：先在goland settings→plugins中安装zhipu ai官方codegeex插件并重启，再登录账号，最后在backend configuration中选定zhipu ai cloud、ollama或custom api后端并保存应用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 GoLand 中让 CodeGeex 插件真正响应代码补全、生成和解释请求，必须完成插件安装、账号绑定、模型后端选择三步闭环，缺一不可——未登录时右下角图标呈灰色且无 hover 提示，未指定后端则所有功能点击后仅显示“Loading”并无限等待。
确认 GoLand 版本与环境兼容性
打开 GoLand → Help → About，查看版本号和构建日期。CodeGeex 官方明确要求 GoLand 2021.3 及以上版本，且仅支持 Ultimate（专业版）。若显示 “Community Edition”，【立即停止后续操作】——社区版不加载任何 AI 插件，强行安装后插件列表中仍不可见。
终端执行 java -version，输出必须含 “11.”、“17.” 或 “21.” 字样。低于 Java 11 将导致插件初始化失败，日志中报错 “Plugin failed to initialize” 但界面无任何提示。
安装 CodeGeex 官方插件
按 Ctrl+Alt+S（Windows/Linux）或 Cmd+,（macOS）打开 Settings → 左侧 Plugins → 确保顶部为 Marketplace 标签页 → 在搜索框输入 CodeGeex（注意不是 CodeGeeX 或 CodeGeex4）→ 找到发布者为 Zhipu AI 的官方插件 → 点击 Install。
安装过程中若弹出 “Trust this plugin from third-party vendor?” 提示，必须点 Accept。拒绝后插件静默失效，重启后仍不会出现在已启用列表中。
安装完成后，点击右下角 Restart IDE 立即重启。不重启，插件不注册监听器，右下角无图标，右键菜单也无 CodeGeex 选项。
完成账号登录与后端配置
重启后，右侧工具栏出现蓝色火箭图标 → 点击打开 CodeGeex 面板 → 点击右上角头像 → 选择 Login。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
支持手机号验证码、微信扫码、GitHub 账号三种方式。若使用手机号，请确保网络可访问 open.bigmodel.cn；若企业内网受限，需提前联系 IT 开放该域名出口。
登录成功后，面板自动切换至 “Backend Configuration” 页面 → 在 Model Provider 下拉菜单中选择：
• 云端服务：选 “Zhipu AI Cloud”（默认，需联网）
• 本地 Ollama：选 “Ollama”，并确认 Ollama 正在运行且已拉取 codegeex4 模型（执行 ollama list 应显示 codegeex4）
• 自建 FastAPI 服务：选 “Custom API”，填入 http://localhost:8080/v1/chat/completions（需提前部署 CodeGeex4 本地服务）
选完后点击 Save & Apply。此时右下角图标由灰色变为蓝色，hover 显示 “Ready”。若仍为灰色，说明后端连接失败，需检查 Ollama 是否监听 11434 端口或自建服务是否返回 200。
验证 Go 文件中的补全与生成功能
新建一个 main.go 文件 → 输入 package main → 换行 → 输入 func main() { → 换行后输入 fmt. → 停顿 1 秒 → 观察是否弹出 fmt.Println 建议。
若未弹出，尝试手动触发：光标置于空行 → 按 Ctrl+Enter → 在弹出窗口中输入 “打印当前时间戳，格式为 2006-01-02 15:04:05” → 按回车。
生成结果应包含 import "time" 和 time.Now().Format(...) 调用。若返回 “No response from model”，说明后端未就绪或 apiKey 权限不足——此时需回到 Backend Configuration 页面重新检查登录状态与模型可用性。
