yarn

JavaScript 包管理器

补充说明

yarn 有 Classic（1.x）和 Berry（2+）两代，行为差异很大。新项目通常用 Berry 的 PnP 或 node_modules 模式，老项目多半仍是 1.x。

常用示例

yarn install
yarn install --frozen-lockfile
yarn add express
yarn add -D typescript
yarn remove express
yarn up react
yarn run build
yarn dlx create-vite my-app
yarn workspace web run build
yarn set version stable
yarn --version

易错点与排错

• 先确认是 1.x 还是 2+；yarn add --dev、yarn dlx、PnP 等行为并不通用。
• Berry 默认可能启用 PnP，没有 node_modules；老工具需要 nodeLinker: node-modules。
• --frozen-lockfile 在 CI 中必须加；否则可能悄悄更新依赖。
• yarn.lock 与 package.json 不一致时先修 lockfile，不要删掉了事。
• 多个包管理器混用会生成不同 lockfile；团队要统一。
• workspace 协议（workspace:*）只在 workspace 内可解析，发布前要确认替换策略。
• 全局缓存和离线镜像会占用大量磁盘；清理前确认是否影响离线构建。
• Yarn 版本由 .yarnrc.yml/packageManager 决定；换目录后行为可能不同。

相关命令

• npm — 官方包管理器
• pnpm — 节省磁盘的包管理器
• corepack — 管理 Yarn 版本