Fitten Code忽略列表配置:防止AI读取敏感源码指南
Fitten Code 的核心机制依赖一个轻量的 .aiignore 配置文件,其语法与 .gitignore 完全一致,几无学习门槛。将文件置于项目根目录后,插件启动时会自动加载,无需重启 IDE 或手动刷新。
配置方式很直接:在 .aiignore 中按行写入需要屏蔽的路径模式。示例如下:
关键:secrets/、*.env 这类规则必须从行首开始书写,前面不能留空格,否则规则会彻底失效。
secrets/
config/local.py
*.env
node_modules/**
__pycache__/
*.log
路径末尾加斜杠(/)表示仅匹配文件夹;双星号(**)代表递归匹配所有子目录;单星号(*)只匹配当前层级的文件名。掌握这些差异后,配置优化会变得非常顺畅。
在VS Code中启用.aiignore识别
Fitten Code 插件默认已支持 .aiignore,但若你使用的是旧版本或自定义安装路径,该功能可能未激活。
解决办法:打开 VS Code 设置(快捷键 Ctrl+,),搜索 "fitten code ignore",找到 "Fitten Code: Enable Aiignore" 选项,确认勾选即可。
若完全找不到该选项,说明插件版本低于 v2.8.0——此时必须升级。操作路径:点击扩展图标,搜索 Fitten Code,再点击“更新”按钮。不升级的话,配置再多也无用。
针对PyCharm/IntelliJ IDEA的额外配置
JetBrains 系列 IDE 对 .aiignore 的支持依赖底层索引机制,因此配置完成后,需手动触发一次重新扫描。
第一步:确认 .aiignore 文件确实放在项目根目录(不是 src 或 .idea 目录内)。
第二步:点击菜单栏 File → Reload project from Disk。
第三步:等待右下角状态栏出现 "Indexing finished" 提示,此时 Fitten Code 才开始真正遵循 .aiignore 的规则。
若以上操作后文件仍被读取,问题可能出现在 .idea/misc.xml 文件。需检查该文件内 节点下是否存在 excluded 属性——如有,手动删除对应路径条目,否则它会覆盖 .aiignore 的设置。
验证忽略是否生效
配置完成后,如何确认规则已生效?以下三种实战方法:
方法一:在 Fitten Code 对话框中输入“读取 secrets/api_key.py 的内容”,观察返回结果是否为“权限不足”或“文件被忽略”。
方法二:打开一个被 .aiignore 命中的文件(如 .env),右键选择“Fitten Code → 解释代码”。若弹出提示“该文件已被排除在AI上下文之外”,即表示配置成功。
方法三:在终端执行 fitten-cli status --verbose(需先安装 CLI),查看输出中的 Ignored Files 列表是否包含你指定的路径。
