怎样排除多余依赖

排除多余依赖（也叫“清理无用依赖”）是项目维护中提高性能、减少体积、避免安全漏洞的重要步骤。不同语言和生态有不同的做法，下面按常见场景给你一套通用思路 + 主流工具示例。

一、通用思路（先理解再动手）

1. 确认依赖是否真的被使用

   • 代码中是否有 import / require / use
   • 是否被间接依赖（dependencies of dependencies）

2. 区分依赖类型

   • 生产依赖（运行时必须）
   • 开发依赖（仅构建/测试阶段）

3. 优先使用官方或主流工具

   • 慎用“暴力删除”

4. 删除后一定要测试

   • 本地跑通
   • CI / 构建流程正常

二、JavaScript / Node.js（最常见）

1️⃣ 找出未使用的依赖

工具推荐

npm install -g depcheck
depcheck

输出示例：

Unused dependencies
* lodash
* moment

手动确认

# 全局搜索
grep -r "lodash" src/

2️⃣ 删除依赖

npm uninstall lodash
# 或
yarn remove lodash

3️⃣ 清理 node_modules & lock 文件

rm -rf node_modules package-lock.json
npm install

4️⃣ 检查冗余依赖（duplicated）

npm dedupe

三、Python

1️⃣ 找出未使用的包

工具

pip install pip-autoremove
pip-autoremove unused-package -y

或：

pip install pip-check
pip-check

2️⃣ 手动确认

grep -r "import" . | grep unused_module

3️⃣ 使用 virtualenv（强烈推荐）

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

避免系统环境污染。

四、Java（Maven / Gradle）

Maven

mvn dependency:analyze

输出：

• Used undeclared dependencies
• Unused declared dependencies

⚠️ 谨慎删除，分析型依赖可能被反射使用。

Gradle

gradle dependencyInsight --dependency xxx

或插件：

plugins {
  id "com.github.ben-manes.versions" version "0.50.0"
}

五、Go

go mod tidy

✅ 自动删除未使用的依赖
✅ 官方推荐

六、前端构建工具（额外建议）

Webpack / Vite

npm ls --depth=0

配合：

• bundle 分析工具

npm install -D webpack-bundle-analyzer

七、常见误区 ⚠️

❌ 只看工具结果就删
❌ 忽略间接依赖（peerDependencies）
❌ 删除后不跑测试
❌ 在 monorepo 中乱删

八、推荐流程（最佳实践）

1. 用工具扫描
2. 人工确认使用场景
3. 小步删除
4. 本地 + CI 测试
5. 提交 + 写 changelog

如果你愿意，可以告诉我：

• 使用的语言 / 框架（如 React、Vue、Spring、Django）
• 是否是 monorepo
• 是构建慢、体积大，还是安全扫描报警

我可以给你更精确的清理方案。