必须绕过三个卡点：插件市场搜不到、装完没图标、侧边栏空白；需确认idea≥2021.3版本，安装后重启并启用插件，解决jcef缺失和gpu沙箱问题，最后登录验证功能可用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 IntelliJ IDEA 里让 Fitten Code 插件真正跑起来、不报错、能登录、能生成代码，必须绕过三个常见卡点：插件市场搜不到、装完没图标、点开侧边栏直接空白。这些不是操作失误，而是 IDEA 版本、JCEF 环境、沙箱策略共同作用的结果。
确认 IDEA 版本与基础兼容性
打开 IDEA → Help → About，查看版本号。Fitten Code 官方明确要求 IntelliJ IDEA 2021.3 或更高版本。低于这个版本（比如 2020.x）即使强行安装插件，也会在启动时被自动禁用或根本无法加载侧边栏界面。
如果你用的是 2023.1 及以上版本，跳过手动下载步骤；若版本是 2022.3 或更老但高于 2021.3，建议先升级 IDEA 再安装插件——旧版对 JCEF 渲染引擎支持不稳定，后续极易出现“侧边栏白屏”问题。
从 Marketplace 正常安装插件
File → Settings → Plugins → Marketplace → 搜索框输入 fitten code（注意大小写不敏感，但必须带空格）→ 找到官方插件（作者为 Fitten Tech）→ 点击 Install → 等待进度条走完 → 提示“Restart IDE”时点击 Restart。
重启后，左侧工具栏应出现 Fitten Code 图标（蓝色对话气泡形状）。如果没出现，说明插件未激活或被 IDE 自动禁用，请进入 Settings → Plugins 查看状态是否为 Enabled；若显示 Disabled，勾选后再次重启。
解决“请安装 JCEF”错误
方法一：自动切换运行时（推荐）
Help → Find Action（Ctrl+Shift+A）→ 输入 “Choose Boot Java Runtime for the IDE” → 回车 → 在弹出窗口中选择带有 JCEF 标识的 JDK（通常为 JetBrains Runtime 17+ 或 21+）→ 点击 OK → 等待 IDEA 自动更新并重启。
方法二：手动配置（仅当方法一不可用时）
关闭 IDEA → 打开安装目录下的 bin/idea64.exe.vmoptions（Windows）或 bin/idea.vmoptions（macOS/Linux）→ 在末尾添加一行：-Dide.jcef.enabled=true → 保存文件 → 重新启动 IDEA。
注意：JCEF 是 Fitten Code 侧边栏 UI 渲染的底层依赖，不解决此问题，插件图标虽在但点击即崩溃或白屏，所有功能均不可用。
修复“Too many restarts of gpu-process”导致侧边栏打不开
第一步：Help → Find Action → 输入 “Registry” → 回车
第二步：在 Registry 搜索框中输入 ide.browser.jcef.sandbox.enable
第三步：取消该选项的勾选
第四步：关闭 Registry 窗口 → 重启 IDEA
这一步关闭的是 JCEF 的沙箱隔离机制。某些企业网络策略或杀毒软件会拦截沙箱进程，触发 GPU 进程反复重启，最终导致侧边栏完全无法加载。关闭后侧边栏可正常渲染，不影响代码生成功能安全性。
完成登录并验证可用性
点击左侧 Fitten Code 图标 → 弹出登录面板 → 支持微信扫码、邮箱注册、GitHub 登录三种方式 → 任选一种完成认证 → 登录成功后，底部状态栏会显示 “Fitten Code Ready”。
此时在任意代码文件中右键 → 选择 “Ask Fitten Code” → 输入 “帮我写一个 Java 的单例模式” → 等待几秒 → 生成结果出现在编辑器上方悬浮窗中，即表示全部配置完成。
