Fitten Code 插件无法识别项目根目录会导致代码补全缺失、类型推导失败等，需右键标记 Sources Root、为多模块分别标记、重启 IDE；或在插件设置中填绝对路径，或通过启动前设置 PROJECT_ROOT 环境变量解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
PyCharm 或 IDEA 中 Fitten Code 插件无法识别项目根目录，会导致代码补全缺失、类型推导失败、路径跳转中断，甚至无法加载本地模块。根本原因在于插件未正确感知 IDE 的项目结构上下文，尤其在多模块、非标准布局（如未标记 Sources Root）或通过环境变量/配置文件动态指定根目录的项目中极易触发。
确认并修复 IDE 项目结构标识
第一步：右键点击你认为是项目根目录的文件夹（通常含 pyproject.toml、requirements.txt 或 .git），选择 Mark Directory as → Sources Root。这一步强制 IDE 将该目录注册为源码起点，Fitten Code 依赖此元数据定位模块路径。
第二步：若项目含多个子模块（如 src/、tests/、apps/），需分别对每个子模块根目录执行相同操作。漏标任一子模块，Fitten Code 在跨模块引用时就会返回 Any 或报 ModuleNotFoundError。
第三步：重启 IDE。仅标记不重启，Fitten Code 不会重新扫描项目结构——这是最常被忽略的步骤。
手动配置插件识别路径
方法一：通过插件设置指定根目录
进入 Settings → Plugins → Fitten Code → Settings，找到 Project Root Path 输入框。此处必须填写绝对路径，不能用 ${workspaceFolder} 或 ../ 等相对写法。例如 Windows 用户应填 D:\myproject，macOS/Linux 用户应填 /Users/you/project。填错将导致插件完全静默，无报错但无功能响应。
Fitten Code 1.0.3是一款由清华博士团队打造的AI编程助手，基于国产计图（Jittor）深度学习框架开发。它支持VS Code、JetBrains系列等主流IDE及80多种编程语言。核心功能包括智能代码补全、注释生成、代码解释、Bug检测、单元测试生成等，旨在全方位提升开发效率。该工具对个人用户免费开放。
方法二：利用环境变量传递路径（推荐用于 CI 或多环境部署）
在系统中设置环境变量 PROJECT_ROOT，值为项目绝对路径；然后在 PyCharm/IDEA 的 Run → Edit Configurations → Environment variables 中添加该变量。Fitten Code 会自动读取该变量并覆盖默认探测逻辑。
注意：环境变量必须在 IDE 启动前设置生效，在 IDE 内部终端中 export 不起作用。
验证与兜底方案
打开任意 Python 文件，在顶部输入 import os; os.path.join(，观察 Fitten Code 是否能自动补全当前项目下的子目录名（如 src、data）。若不能，说明根目录仍未被识别。
若以上均无效，直接在代码中显式声明根路径：
import os
PROJECT_ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", ".."))
# 此行后，Fitten Code 对 PROJECT_ROOT 下的相对路径解析将立即恢复
