Conducts a phased codebase aud…

# 电商后台死代码扫描方案（Node.js + Express）

一、扫描工具选型

• knip：首选，专门检测未使用的文件、导出、依赖，支持 Express 项目结构
• ts-prune / depcheck：分别检查未使用的导出和 npm 依赖（若为 TS 项目）
• ESLint（no-unused-vars 规则）：兜底检查函数内部未用变量
• jsлейн 替代方案：纯 JS 项目可用 unimported 检测未被引用的文件

二、执行步骤

1. 工具安装与配置

• 在项目根目录安装 knip，编写 knip.json，将 src/order、src/payment 设为高优先级扫描入口
• 配置 entry 文件（如 src/app.js、src/routes/index.js），避免误报路由动态注册的模块

2. 先扫描，先出报告不动代码

• 生成“未引用文件 / 未使用导出 / 未使用依赖”三类清单
• 结合 git log --since=3.years.ago -- src/order src/payment 交叉比对，筛选“三年未改动 + 无引用”的模块

3. 人工确认高风险点

• 动态引用：字符串拼接 require、路由字符串注册、定时任务（cron）、消息队列消费者、CLI 脚本入口——这些 knip 可能误判为死代码
• 反向 grep 验证：对每个候选模块用 grep -r "模块名" 全库（含配置文件、部署脚本）二次确认

三、删除策略

• 分批进行：每批删除后跑全量测试 + 本地启动冒烟验证核心下单/支付链路
• 保留回滚能力：每个批次独立 commit/分支，标注“死代码清理”便于回滚
• 灰度上线：删除后先发预发环境观察 1-2 个完整业务周期（含促销/对账等周期性任务）

四、注意事项

• 支付目录尤其谨慎：对账、退款回调等模块可能低频触发，建议先加埋点日志观察 1-2 个月再删
• 检查中间件与装饰式注册：Express 的 app.use 挂载可能分散在多个文件
• 顺手清理 package.json：用 depcheck 移除僵尸依赖，减小安装体积与安全面

预期产出：死代码清单（文件级 + 导出级）、依赖清理清单、分批删除的 PR 计划。