安装后左侧无图标，需先确认插件状态为enabled，再彻底重启ide；若仍不显示，须升级ide至2021.1+、手动安装适配插件包、配置带jcef的java运行时，并关闭ide.browser.jcef.sandbox.enable选项。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
安装完 Fitten Code 插件后，在 IDE 左侧边栏看不到图标，不是插件没装上，而是它根本没被加载进界面——这在 IntelliJ IDEA、PyCharm 等 JetBrains 系列 IDE 中极为常见，尤其当 IDE 版本较新或插件状态异常时。
确认插件已启用
打开 Settings（Windows/Linux）或 Preferences（macOS）→ Plugins → 在列表中找到 “Fitten Code” → 检查右侧状态是否为 【Enabled】，而非 “Installed” 或灰显。若显示 “Installed”，必须手动勾选启用；若已勾选但图标仍不出现，说明加载流程中断，需进入下一步。
Fitten Code 1.0.3是一款由清华博士团队打造的AI编程助手，基于国产计图（Jittor）深度学习框架开发。它支持VS Code、JetBrains系列等主流IDE及80多种编程语言。核心功能包括智能代码补全、注释生成、代码解释、Bug检测、单元测试生成等，旨在全方位提升开发效率。该工具对个人用户免费开放。
强制重启 IDE
插件启用后不会热加载到侧边栏，【必须彻底关闭所有 IDE 窗口并退出进程，再重新启动】。仅点击“Restart IDE”按钮有时无法清空旧渲染上下文，导致图标不浮现。Windows 用户可任务管理器中结束所有 “idea64.exe” 进程；macOS 用户可在活动监视器中强制退出 “IntelliJ IDEA”；Linux 用户建议 kill -9 所有相关 java 进程后再启动。
检查 IDE 版本兼容性
方法一：查看当前 IDE 版本是否过低 IntelliJ IDEA 2020.3 及更早版本不支持 Fitten Code 的核心渲染模块，必须升级至 【2021.1 或更高版本】。路径：Help → About → 查看 Build number，低于 211.xxxx 的需前往 JetBrains 官网下载新版安装包。
方法二：验证是否因版本过高导致插件未上架 你用的是 2026.1 版本？官方 Marketplace 索引尚未同步该版本适配信息，此时搜索不到插件名是正常现象。应跳转至 Fitten Code 官网下载对应 2026.x 的 【.zip 插件包】，再通过 Settings → Plugins → ⚙️ → Install Plugin from Disk… 手动安装。
修复 JCEF 组件缺失
第一步：点击 Help → Find Action（Ctrl+Shift+A）→ 输入 “Choose boot Java runtime for the IDE” → 回车执行 第二步：在弹出窗口中，选择一个带 “jcef” 字样的 JDK（如 JetBrains Runtime 17 with JCEF），点击 OK 第三步：IDE 会自动下载并替换运行时，完成后必须重启 JCEF 是 Fitten Code 渲染侧边栏 WebView 的底层依赖，缺失会导致图标区域空白或直接不注册侧边栏入口——这一步不做，重启一百次也没用。
绕过沙箱限制（GPU 进程崩溃场景）
如果重启后侧边栏一闪而过、或长期显示空白，大概率是 GPU 进程被沙箱拦截。此时需关闭 JCEF 沙箱： Help → Find Action → 输入 “Registry” → 回车 → 在搜索框中输入 “ide.browser.jcef.sandbox.enable” → 取消勾选该选项 → 关闭窗口 → 重启 IDE。
