开心每一天

Appearance

npm-check 更新依赖包 ​

npm-check 是一个用于检查 Node.js 项目依赖状态的工具，可帮助开发者识别过时、未使用或配置错误的依赖包。以下是其核心功能和用法指南：

核心功能 ​

依赖状态检测 ​

  • 过时依赖：对比 npm 仓库版本，显示可升级的依赖包及更新类型（主版本/次版本/补丁）。
  • 未使用依赖：分析项目代码，标记未被引用的依赖包，便于清理冗余。
  • 错误配置：检查依赖版本范围是否符合规范（如语义化版本控制）。

交互式更新 ​

支持通过 -u 参数启动交互式更新界面，用户可逐项选择是否升级依赖，避免误操作。

多环境兼容 ​

  • 支持全局依赖（-g 参数）和项目局部依赖检查。
  • 兼容 npm@2/3、yarn、pnpm 等包管理工具。

安装与使用 ​

shell
# 全局安装 
npm install -g npm-check

# 检查项目依赖（在项目根目录运行）
npm-check

# 检查全局依赖 
npm-check -g
 
# 启动交互式更新（项目目录）
npm-check -u
 
# 自动更新所有依赖（慎用）
npm-check -u -y

典型场景 ​

清理冗余依赖 ​

通过 npm-check 检测未使用的依赖，再手动移除以减少 node_modules 体积。

安全维护 ​

定期运行 npm-check 更新过时依赖，避免因旧版本漏洞引发安全问题。

CI/CD 集成 ​

结合 API 接口集成到持续集成流程中，自动化检查依赖健康状态。

最佳实践 ​

  • 定期检查：建议每月运行一次 npm-check，确保依赖处于最新稳定状态。
  • 结合版本控制：更新依赖前提交代码，便于回滚。
  • 分阶段更新：优先更新补丁版本，次版本和主版本需充分测试。

如需更多高级用法（如忽略特定依赖），可参考 GitHub 官方文档 。

报错：npm error notsup Unsupported platform for n@10.1.0: wanted {"os":"!win32"} (current: {"os":"win32"}) ​

这里也不建议消除这个告警。

增加 --force 参数可强制更新，一般不推荐使用。

这里强制使用是 n 工具是在 linux 下使用的工具，但是 npm-check 依然会检测到版本低的问题，所以强制升级。即使升级了，在 windows 环境下也不会使用 n 工具，仅仅起到一个消除告警的作用。

shell
# 强制升级
npm install -g n --force 

# 回退到 windows 支持的版本
npm install -g n@9.2.0 --force