Fitten Code 陈旧代码改进建议自动设置指南

Fitten Code 一直很务实——它会自动侦测项目里的老旧代码，并提供优化方案。不过要启用这个功能，需要手动操作几个关键步骤。下面从插件版本到项目规则，把流程拆解清楚。

简单来说，开启后，当你打开一个历史项目或久未编辑的文件，Fitten Code 会自动扫描一遍：哪些语法已经废弃，哪些写法效率偏低，哪些地方可能埋有兼容性隐患。它会把这些发现标记在行尾或侧边栏，并给出可点击的优化建议。所有提醒都需要你确认，不会自动修改代码。

确认插件已安装并启用

先确保插件到位，再谈后续配置。打开 Fitten Code，左侧栏找到扩展图标（或直接用 Ctrl+Shift+X），在搜索框输入 【Fitten Code Assistant】，检查状态是否为“已启用”。如果显示“已禁用”或未安装，点一下“安装”，然后重启编辑器即可。

这里有个关键注意：只有官方发布的 【Fitten Code Assistant v2.4+】 才具备陈旧代码分析能力。市面上某些同名第三方插件，名称相似，但无法触发这个功能，不要混淆。

开启陈旧代码检测开关

插件就位后，接下来配置开关。依次点击 文件 → 设置 → 打开设置（JSON），在右侧用户设置 JSON 中插入下面两行配置：

"fitten.code.staleDetection.enabled": true,

"fitten.code.staleDetection.level": "aggressive"

这里的 【"aggressive"】 模式检测全面，会覆盖 Node.js 版本迁移、ES 特性弃用、常见包 API 变更等 12 类陈旧模式。如果你更看重低误报率，可以换成 【"moderate"】，但检测范围会收窄，仅聚焦高风险项，比如已完全移除的全局函数。选哪种模式，取决于你对检测精度与覆盖面的平衡需求。

绑定项目级陈旧规则

这一步相当关键，尤其当项目依赖特定版本的库或框架时。不配置的话，插件只基于工作区默认 Node 版本做基础判断，很容易漏掉那些特定库的 breaking change。

操作也不复杂：在项目根目录新建一个 .fittenrc.json 文件。在里面写入目标 Node 版本和关键依赖的版本约束，例如：

{ "targetNodeVersion": "18.17.0", "dependencies": { "lodash": "^4.17.21", "axios": "^1.6.0" } }

保存好后，对着任意 TypeScript 或 JavaScript 文件右键，选择 “Fitten: Refresh Stale Analysis”。当右下角弹出 “Stale suggestions updated” 提示，说明配置已生效。

手动触发一次全量陈旧扫描

一切准备就绪，最后手动执行一次全量扫描。两种方式可选：

方法一：快捷键 Ctrl+Shift+P 打开命令面板，输入 “Fitten: Scan for Stale Code”，回车执行。

方法二：命令面板执行该命令后，编辑器底部状态栏会显示进度条。扫描完成后，问题面板中新增一类 “Stale Usage” 条目，点击即可查看具体建议。

操作本身很简单，就像拖拽文件一样直观。需要特别说明：扫描结果不会自动改动你的任何代码。所有建议都以“Apply Fix”按钮呈现，必须由你手动点击确认才能应用。因此，放心跑一遍扫描，不会对项目造成意外修改。