npm是JavaScript项目无法绕开的依赖管理工具，优化关键在于换国内镜像源、用npm ci替代install、精简node_modules、升级npm或迁移到pnpm。
npm 本身不是“要不要用”的问题，而是 JavaScript 项目里你几乎没法绕开的依赖管理工具。优化依赖体积和安装速度，关键不在跳过 npm，而在用对命令、配对源、管住锁文件、理清依赖结构。
换国内镜像源，装包快一倍不止
官方 registry.npmjs.org 对国内用户延迟高、易超时。淘宝镜像（npmmirror.com）已全量同步，延迟常压到 50ms 内，且稳定性强。
- 全局切换：运行 npm config set registry https://registry.npmmirror.com
- 验证是否生效：执行 npm config get registry，输出应为该地址
- 临时单次使用（如 CI 脚本）：加 --registry=https://registry.npmmirror.com 参数
用 npm ci 替代 npm install 做构建与部署
npm install 会读 package.json、解析语义化版本、再查 lock 文件，过程慢且可能引入不一致；npm ci 则完全按 package-lock.json 还原，跳过所有推导逻辑，更快更稳。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- CI/CD 流水线中必须用 npm ci，不能混用 npm install
- 首次拉取或重置环境时，确保 package-lock.json 已提交到 Git，否则 ci 会直接失败
- 本地开发可继续用 npm install，但上线前务必用 npm ci 验证一致性
精简 node_modules：删无用文件，不删依赖
node_modules 膨胀主因不是依赖太多，而是每个包自带文档、示例、source map、测试代码等非运行必需内容。这些不参与执行，却占 40%–60% 磁盘空间。
立即学习“Java免费学习笔记（深入）”；
- 推荐工具：npmshit（TypeScript 编写），默认清理 *.map、/docs、/examples、/.github 等目录
- 安装后运行：npx npmshit --dry-run 先预览，确认无误再执行 npx npmshit
- 也可手动配置 .npmrc 加入 ignore-scripts=true 防止 postinstall 污染，但需评估脚本必要性
控制依赖层级，避免嵌套爆炸
npm v6 默认嵌套安装，不同版本的同一包（如 follow-redirects@1.14.7 和 @1.15.2）会被重复拷贝，路径深、启动慢、Windows 易报错。
- 升级 npm 至 v7+：自动启用更激进扁平化，大幅减少重复
- 或运行 npm dedupe（v6 也支持），尝试将兼容子依赖提升到顶层
- 长期项目建议迁移到 pnpm：用硬链接 + 符号链接复用包，体积直降 70%，且保留严格依赖隔离
