寻找检测Node.js项目中未被引用模块的工具以清理无效文件

可用工具及操作步骤 #

1. depcheck #

这是最常用的项目依赖分析工具，既能检测npm包的未用依赖，也能扫描项目文件间的引用关系，直接找出未被任何文件引用的文件。

• 安装：npm install -g depcheck
• 运行：在项目根目录执行 depcheck --ignores "node_modules"
• 查看结果里的unused files列表，这就是项目中无引用的文件，你可以对照之前移除的路由相关文件确认后删除。

2. madge #

专门做依赖树可视化与分析的工具，能从指定入口文件（比如你的app.js）构建依赖链，还能直接列出孤立文件（完全没被引用的文件）。

• 安装：npm install -g madge
• 运行：先执行madge --extensions js ./app.js生成依赖树，再执行madge --orphans ./就能得到所有未被引用的孤立文件列表。

3. ESLint + unused-imports插件 #

如果你的项目已经在用ESLint，可通过插件检测代码里的未用导入，再结合手动核对找出无引用的文件：

• 安装：npm install eslint eslint-plugin-unused-imports --save-dev
• 在ESLint配置文件中添加规则："unused-imports/no-unused-imports": "error"
• 运行eslint .，工具会提示代码中未使用的导入语句，你可以顺着这些导入反向定位对应的无引用文件。

注意事项 #

• 运行工具前，确保已经移除app.js中对应的require语句，这样工具才能准确识别未被引用的文件分支。
• 删除文件前建议先备份，或者用Git做版本控制，避免误删有用文件。
• 配置文件、测试文件这类通常不会被业务代码引用的文件，可以通过工具的--ignores参数手动排除，避免被误判为无用文件。

内容的提问来源于stack exchange，提问作者Siavoshkc