必须升级Rider至2021.3+、选用含JCEF的Java运行时、安装插件后先打开.cs文件、登录后启用跨文件感知与知识库索引，才能实现CodeGeeX在.NET开发中的高效补全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 JetBrains Rider 中快速启用 CodeGeeX 并投入日常开发，必须绕过默认插件市场加载慢、登录触发异常、上下文感知失效等常见卡点。Rider 的插件机制与 VSCode 不同，不打开编辑区就不会激活 AI 补全引擎，不配置跨文件感知就只能补当前行，不绑定项目知识库则无法复用已有代码逻辑。
确认 Rider 版本与环境兼容性
打开 Rider → Help → About，核对版本号是否 ≥ 2021.3；若显示 2020.x 或更低，【必须升级】，否则 CodeGeeX 插件安装后不会出现在 Plugins 列表中。
检查 Java 运行时：Help → Find Action → 输入 “Choose Boot Java Runtime for the IDE” → 确保选中的 Runtime 名称包含 “JCEF” 字样；若无 JCEF 选项，说明当前 JDK 不支持嵌入式浏览器组件，CodeGeeX 登录页将空白或报错。
安装 CodeGeeX 插件（仅限 JetBrains 全家桶）
File → Settings → Plugins（macOS 为 Preferences → Plugins）→ 点击右上角「Marketplace」标签 → 搜索框输入 CodeGeeX → 找到官方插件（发布者为 Zhipu AI）→ 点击 Install → 安装完成后勾选「Restart IDE」。
重启后若未自动弹出登录提示，【务必先打开一个 .cs 文件或新建控制台项目】，否则侧边栏 CodeGeeX 工具窗口不可点击，登录入口被禁用。
登录并激活上下文感知能力
方法一：点击 Rider 右下角 CodeGeeX 图标 → 选择 Login to CodeGeeX → 浏览器跳转至 codegeex.cn 登录页，完成验证后自动回传 token。
方法二：右侧工具栏点击 … → 在弹出列表中找到 CodeGeeX → 首次点击后图标固定在右侧 → 点击图标 → 在 AskCodeGeeX 区域点击「Login」按钮 → 弹出网页登录框。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
登录成功后，立刻进入 Settings → CodeGeeX → 勾选「Enable cross-file context awareness」——这一步决定补全建议是否参考整个解决方案的类结构和命名习惯，不勾选则只看当前文件，生成代码极易出现命名冲突或类型未定义错误。
配置代码补全行为（关键三步）
第一步：Settings → CodeGeeX → 开启「Enable code completion」，这是所有智能补全功能的基础开关。
第二步：在同页面中，将「Completion mode」设为「Multi-line」——Rider 默认单行模式，但 .NET 开发中常需生成完整方法体或 LINQ 查询链，多行模式可一次给出 3～5 行结构化代码。
第三步：点击「Configure knowledge base」→ 选择当前解决方案根目录 → 点击「Build knowledge base」→ 等待右下角提示「Indexing completed」。这一步让 CodeGeeX 能识别你项目里的自定义实体类、扩展方法、领域枚举，避免生成泛型占位符如 TEntity 而不是真实的 UserProfile。
验证部署效果（实操测试）
打开任意 .cs 文件，在空行输入 // 获取当前用户权限列表 → 按 Tab 键 → 观察是否生成带 IEnumerable<Permission> 返回类型的异步方法骨架，并自动引用 using System.Collections.Generic; 和 using System.Threading.Tasks;。
若生成内容含硬编码字符串或缺失 using 语句，说明知识库未生效或跨文件感知未开启；此时回到 Settings → CodeGeeX → 点击「Rebuild knowledge base」并等待索引完成，再试一次。
