nypm 实战指南在 Monorepo 工作区统一管理依赖的终极方案【免费下载链接】nypm Unified Package Manager for Node.js (npm, pnpm, yarn), Bun, Deno, Nub, Aube.项目地址: https://gitcode.com/gh_mirrors/ny/nypmnypm 是一个面向 Node.js 生态的统一包管理器它把 npm、pnpm、yarn、Bun、Deno 以及新兴的 Nub、Aube 全部收进同一套命令和同一套 API 中。无论你的 Monorepo 工作区用的是哪种包管理器nypm 都能自动识别并调用对应的底层命令让你彻底告别记错命令、反复切换的烦恼。本文以 Monorepo 工作区为主线手把手带你掌握 nypm 的安装、CLI 实战与编程式 API 用法。为什么 Monorepo 依赖管理如此混乱Monorepo单仓库多包项目里依赖管理通常面临三大痛点命令不统一npm 用npm installpnpm 用pnpm addyarn 用yarn addBun 又是另一套换一个包管理器就要换一套肌肉记忆。锁文件繁多package-lock.json、pnpm-lock.yaml、yarn.lock、bun.lock、deno.lock各管一摊识别错误就会装错依赖。workspace 参数千差万别给子包装依赖时pnpm 需要-wnpm 需要-w nameyarn 又有自己的写法极易出错。nypm 的存在就是为了把这一切差异抹平。nypm 如何自动识别你用的包管理器nypm 的核心能力是自动检测。它的检测逻辑见 src/package-manager.ts按以下优先级判断读取package.json中的packageManager字段如pnpm8.6.5回退到devEngines.packageManager字段再根据已知锁文件兜底例如package-lock.json、pnpm-lock.yaml、yarn.lock、bun.lock、deno.lock、aube-lock.yaml、nub.lock等。这意味着你什么都不用配置nypm 在 Monorepo 任意一个子目录执行时都会自动向上查找并选中正确的包管理器。快速开始安装 nypm 的两种方法nypm 本身无需全局安装用npx即可零配置使用# 安装依赖 npx nypm i # 添加依赖 npx nypm add defu如果你要在代码中调用它的 API则可以把它作为项目依赖安装# ✨ 自动检测当前包管理器并安装 npx nypm install nypmCLI 实战Monorepo 工作区安装依赖的最快方法nypm 的命令行入口定义在 src/cli.ts提供了一组与包管理器无关的直观命令# 安装全部依赖等价于 npm install / pnpm install / yarn install npx nypm i # 添加普通依赖 npx nypm add lodash # 添加开发依赖 npx nypm add -D vitest # 删除依赖 npx nypm remove lodash # 运行 package.json 中的脚本 npx nypm run dev # 查看当前目录识别到的包管理器 npx nypm detect无论底层是 pnpm 还是 npm命令都完全一致输出还会自动带上当前包管理器的版本信息。Monorepo 工作区专用workspace 参数详解对于工作区项目nypm 提供了统一的--workspace参数来指定操作目标实现细节见 test/api-workspace.test.ts# 把依赖添加到工作区根目录 npx nypm add typescript --workspace # 把依赖添加到名为 workspace-a 的子包 npx nypm add ufo --workspace workspace-a你不再需要记忆 pnpm 的-w、npm 的-w name等五花八门的写法一行命令即可完成跨包依赖管理。编程式 API把 nypm 集成进你的工具链如果你在写 CLI 工具、脚手架或自动化脚本nypm 提供了一组开箱即用的异步 API见 src/api.tsimport { addDependency, ensureDependencyInstalled, detectPackageManager } from nypm; // 自动检测当前目录的包管理器 const pm await detectPackageManager(process.cwd()); console.log(检测到${pm.name}${pm.version}); // 添加依赖不存在时才安装 await addDependency(defu, { cwd: process.cwd() }); // 确保依赖已安装未安装则自动补装 await ensureDependencyInstalled(vitest, { dev: true, cwd: process.cwd() });常用 API 一览API作用installDependencies安装项目依赖addDependency/addDevDependency添加普通 / 开发依赖removeDependency移除依赖ensureDependencyInstalled确保依赖已安装dedupeDependencies去重依赖runScript运行脚本dlx下载并执行包detectPackageManager检测包管理器进阶技巧冻结锁文件、去重与 corepack生产环境的 CI 流程通常要求锁文件不可变nypm 也贴心地内置了对应选项# 用冻结锁文件模式安装npm 对应 npm ci npx nypm i --frozen-lockfile当依赖出现重复安装时还可以一键去重npx nypm dedupe此外nypm 原生集成了corepack默认开启会自动为 pnpm、yarn 拉起正确版本团队协作时再也不用担心版本不一致。如果你只想查看将要执行的命令而不真正运行加--dry即可安全预览。实用建议与常见问题版本要求nypm 需要 Node.js 18 或以上版本。Deno 用户注意添加依赖时 nypm 会自动补上npm:前缀无需手动处理。Bun / Deno 的去重这两个包管理器不支持 dedupe 命令nypm 会自动删除锁文件并重新安装来达到去重效果。源码阅读想深入了解实现可重点看 src/cli.ts、src/api.ts、src/cmd.ts 和 src/types.ts。结语在 Monorepo 工作区中依赖管理最大的成本来自不同包管理器之间的心智切换。nypm 用一套统一的 CLI 和 API 化解了全部差异无论是个人项目还是团队协作都能显著降低出错的概率。现在就打开你的 Monorepo 仓库执行npx nypm i体验一次所有包管理器归于一的畅快吧。【免费下载链接】nypm Unified Package Manager for Node.js (npm, pnpm, yarn), Bun, Deno, Nub, Aube.项目地址: https://gitcode.com/gh_mirrors/ny/nypm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考