Yarn 参考文档 #

# 使用Homebrew安装
brew install yarn

# 或使用npm安装
npm install -g yarn

# 使用Chocolatey安装
choco install yarn

# 或使用Scoop安装
scoop install yarn

# 或使用npm安装
npm install -g yarn

# Debian/Ubuntu
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update && sudo apt install yarn

# CentOS/RHEL
sudo wget https://dl.yarnpkg.com/rpm/yarn.repo -O /etc/yum.repos.d/yarn.repo
sudo yum install yarn

# 检查当前版本
yarn --version

# 升级到最新版Yarn 1.x
yarn set version latest

# 升级到Yarn 2+
yarn set version berry

# 升级到特定版本
yarn set version 2.4.2

# 安装特定Node.js版本
nvm install 14
nvm use 14

# 安装Yarn
npm install -g yarn

# 切换Node.js版本后，重新安装Yarn
nvm use 16
npm install -g yarn

# .yarnrc.yml 示例配置

# 全局依赖安装目录
prefix: ~/.yarn

# 镜像源配置
npmRegistryServer: https://registry.npmmirror.com

# 网络超时设置
timeout: 30000

# 启用PnP模式
nodeLinker: pnp

# 缓存目录
cacheFolder: ~/.yarn/cache

# 忽略引擎检查
ignoreEngines: false

# Yarn 1.x
yarn config set registry https://registry.npmmirror.com

# Yarn 2+
yarn config set npmRegistryServer https://registry.npmmirror.com

# 设置HTTP代理
yarn config set proxy http://proxy.example.com:8080
yarn config set https-proxy https://proxy.example.com:8080

# 清除代理设置
yarn config delete proxy
yarn config delete https-proxy

# package.json (根目录)
{
  "name": "my-monorepo",
  "private": true,
  "workspaces": [
    "packages/*",
    "apps/*"
  ],
  "scripts": {
    "build": "yarn workspaces run build",
    "test": "yarn workspaces run test"
  }
}

# 添加共享依赖到根目录
yarn add -D typescript jest

# 在特定工作区添加依赖
yarn workspace web add react
yarn workspace api add express

# 工作区之间的依赖
yarn workspace web add @my-monorepo/utils@workspace:*

yarn install

yarn build

yarn workspace web test

yarn workspaces run clean

# 安装Lerna
yarn add -D lerna

# 初始化Lerna
lerna init

# 配置Lerna使用Yarn工作区
# lerna.json
{
  "packages": [
    "packages/*"
  ],
  "version": "independent",
  "npmClient": "yarn",
  "useWorkspaces": true
}

// plugin-example.ts
import { Plugin } from '@yarnpkg/core';

export const plugin: Plugin = {
  commands: [
    require('./commands/example').default,
  ],
};

yarn plugin import ./plugin-example.js

{
  "dependencies": {
    "react": "^17.0.0"  // 生产依赖
  },
  "devDependencies": {
    "@types/react": "^17.0.0",  // 开发依赖
    "webpack": "^5.0.0"  // 构建工具
  },
  "peerDependencies": {
    "react-dom": "^17.0.0"  // 对等依赖
  }
}

// package.json
{
  "resolutions": {
    "lodash": "^4.17.21",
    "**/react": "^17.0.0"
  }
}

# 启用离线模式
yarn install --offline

# 预下载依赖
yarn install --prefer-offline

# .yarnrc.yml
cacheFolder: ~/.yarn/cache
httpTimeout: 60000

# 并行安装优化
yarn install --network-concurrency 16

# 跳过完整性检查
yarn install --skip-integrity-check

# 使用PnP模式（Yarn 2+）
yarn set version berry
yarn install

yarn set version berry
yarn config set nodeLinker pnp
yarn install

# .yarnrc.yml
npmRegistryServer: https://registry.npmmirror.com
nodeLinker: pnp
strictSemver: true
ignoreEngines: false

# GitHub Actions 示例
name: CI

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Set up Node.js
        uses: actions/setup-node@v2
        with:
          node-version: '14'
      - name: Install Yarn
        run: npm install -g yarn
      - name: Install dependencies
        run: yarn install --frozen-lockfile
      - name: Build
        run: yarn build
      - name: Test
        run: yarn test

# 集成到CI流程
yarn audit --level high

# 使用Snyk进行更深入的检查
npx snyk test

# 检查网络连接
ping registry.npmmirror.com

# 更换镜像源
yarn config set npmRegistryServer https://registry.npmmirror.com

# 检查代理设置
yarn config list | grep proxy

# 查看依赖树
yarn list --pattern <package>

# 使用resolutions强制版本
yarn add -D resolutions
# 在package.json中添加resolutions字段

# 清理缓存
yarn cache clean

# 删除node_modules和lock文件
rm -rf node_modules yarn.lock

# 重新安装
yarn install

# 1. 安装Yarn
npm install -g yarn

# 2. 删除node_modules和package-lock.json
rm -rf node_modules package-lock.json

# 3. 安装依赖
yarn install

# 4. 更新npm脚本
# 将所有npm命令替换为yarn命令

# 1. 备份项目
cp -r my-project my-project-backup

# 2. 升级到Yarn 2+
yarn set version berry

# 3. 安装依赖
yarn install

# 4. 配置PnP（可选）
yarn config set nodeLinker pnp

# 5. 测试构建和运行
yarn build
yarn test

# 安装pnpm
npm install -g pnpm

# 删除node_modules和yarn.lock
rm -rf node_modules yarn.lock

# 安装依赖
pnpm install

# 删除node_modules和yarn.lock
rm -rf node_modules yarn.lock

# 安装依赖
npm install

# .yarnrc.yml 完整配置

# 基础配置
prefix: ~/.yarn
timeout: 60000
ignoreEngines: false
strictSemver: true

# 网络配置
npmRegistryServer: https://registry.npmmirror.com
proxy: http://proxy.example.com:8080
httpsProxy: https://proxy.example.com:8080
noProxy: localhost,127.0.0.1

# 依赖管理
nodeLinker: pnp
nmMode: hardlinks-local
extraNodeModules: {}

# 缓存配置
cacheFolder: ~/.yarn/cache
cachePattern: "*.tgz"

# 脚本配置
shell: bash
scriptShell: bash

# 日志配置
logLevel: info