Fitten Code 的静态分析能力确实令人印象深刻，但偶尔也会“用力过猛”——它会遍历整个工作区，连你存放密钥、证书、内部协议实现细节的目录也一并扫入。虽说不一定直接出问题，但万一出现误报、路径信息泄露，或者在调试日志中意外暴露敏感内容，还是相当令人头疼的。好消息是，从 v2.4.0 版本起，Fitten Code 引入了基于 `.fittenignore` 文件的白名单路径排除机制。下面就来详细拆解具体操作与验证步骤。
首先确认你的版本是否达标。Fitten Code 本身并未提供图形化的白名单开关，扫描行为由底层 LSP 插件与项目级配置共同决定。如果你在使用 VS Code 搭配 Fitten Code 插件，默认情况下它会递归扫描整个工作区——**务必先确认你正运行 v2.4.0 或更高版本**，较低版本无法识别 `.fittenignore` 文件，后续配置全都无效。 打开命令面板（Ctrl+Shift+P），输入 “Fitten: Show Server Info”，查看输出中的 version 字段。若版本低于 2.4.0，请升级插件并重启编辑器。
版本满足后，接下来创建 `.fittenignore` 文件。在项目根目录下新建一个纯文本文件，命名为 `.fittenignore`（注意文件名以英文圆点开头，无扩展名）。写入你希望跳过的路径，每行一条，支持通配符与注释：
# 跳过所有凭证类文件
./secrets/
./config/*.pem
**/.env*
# 跳过内部协议实现（避免暴露接口细节）
./internal/proto/
./legacy/encryption/
⚠️ 这里有个容易踩的坑：**路径必须以 `./` 开头**，若写成 `secrets/` 或 `/secrets` 都会被忽略；**绝对路径同样无效**，并且不会有任何错误提示，配置等于白费。
保存后，我们来验证白名单是否生效。分四步走：
- 关闭当前 VS Code 窗口，彻底退出进程（macOS 检查 Activity Monitor，Windows 在任务管理器中确认 Code Helper 进程已结束）。
- 重新打开项目文件夹，等待右下角状态栏显示 “Fitten Server Ready”。
- 在被排除的目录（例如 `./secrets/`）中新建一个 `test.py`，故意写入一些违规代码，比如硬编码密码。观察左下角问题面板是否出现相关警告——**若没有任何提示，说明白名单配置生效了**。
- 打开开发者工具（Help → Toggle Developer Tools），切换到 Console 标签页，搜索关键词 “ignored path”，应能看到类似 `Ignoring path: /Users/me/project/secrets` 的日志条目。
至此，白名单配置就完成了。如果验证后警告消失，说明敏感文件夹已被成功排除，Fitten Code 不会再对其扫描。你可以将 `.fittenignore` 文件提交到版本控制中，团队其他成员拉取后也能直接生效。
