Yarn 安装及使用流程详解

  1. node 安装
    1
    2
    3
    4
    5
    6
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
    source ~/.bashrc   # 或 ~/.zshrc（取决于你的 Shell）
    nvm install 20
    nvm use 20
    nvm alias default 20  # 设置默认版本
    node -v  # 应输出 v20.x.x
  2. 运行构建nodejs项目
    1
    2
    3
    4
    npm install -g yarn
    yarn install
    yarn run dev
    npm run build

一、安装 Yarn

根据操作系统选择以下安装方式：

  1. Windows

    • Chocolatey（推荐）： 
      1
      choco install yarn
    • Scoop： 
      1
      scoop install yarn
    • 官方安装包：
      访问 Yarn 官网，下载 .msi 安装包并运行。

  2. macOS

    • Homebrew： 
      1
      brew install yarn

  3. Linux

    • npm 安装（需先安装 Node.js）： 
      1
      npm install -g yarn
    • 官方脚本： 
      1
      curl -o- -L https://yarnpkg.com/install.sh | bash

  4. 验证安装
    安装完成后，运行以下命令检查版本： 

    1
    yarn --version

二、初始化项目

  1. 创建项目目录 

    1
    mkdir my-project && cd my-project

  2. 生成 package.json

    • 交互式初始化： 
      1
      yarn init
    • 快速生成默认配置： 
      1
      yarn init -y

三、依赖管理

  1. 安装依赖

    • 生产依赖（默认）： 
      1
      2
      yarn add [package-name]
      # 示例：yarn add react
    • 开发依赖（如 Webpack、Babel）： 
      1
      2
      yarn add [package-name] --dev  # 或 yarn add -D [package-name]
      # 示例：yarn add webpack --dev
    • 指定版本： 
      1
      2
      yarn add [package-name]@[version]
      # 示例：yarn add [email protected]

  2. 升级依赖

    • 单个包： 
      1
      2
      yarn upgrade [package-name]
      # 示例：yarn upgrade react
    • 所有包到最新版本： 
      1
      yarn upgrade --latest

  3. 移除依赖 

    1
    2
    yarn remove [package-name]
    # 示例：yarn remove redux

  4. 安装项目依赖
    克隆项目后，根据 package.json 和 yarn.lock 安装依赖： 

    1
    yarn install

四、运行脚本

  1. 定义脚本
    在 package.json 的 scripts 字段中添加自定义命令： 

    1
    2
    3
    4
    5
    6
    7
    {
      "scripts": {
        "start": "node index.js",
        "build": "webpack --mode production",
        "test": "jest"
      }
    }

  2. 执行脚本 

    1
    2
    yarn run [script-name]
    # 示例：yarn start
    • 简写形式（如 start、test）： 
      1
      2
      yarn [script-name]
      # 示例：yarn test

五、其他常用命令

  1. 查看依赖列表 

    1
    yarn list

  2. 清除缓存 

    1
    yarn cache clean

  3. 离线模式
    使用本地缓存安装依赖（无需网络）： 

    1
    yarn install --offline

六、配置与镜像源

  1. 设置全局配置 

    1
    2
    3
    yarn config set [key] [value]
    # 示例：设置淘宝镜像源
    yarn config set registry https://registry.npm.taobao.org

  2. 查看配置 

    1
    yarn config list

七、高级功能

  1. 工作区（Workspaces）
    适用于多包项目（如 Monorepos），在根目录 package.json 中启用： 

    1
    2
    3
    4
    {
      "private": true,
      "workspaces": ["packages/*"]
    }

  2. 自定义脚本
    结合 package.json 中的脚本实现自动化流程（如构建、测试、部署）。

八、注意事项

  • 版本兼容性：确保 Node.js 版本 ≥ 8.x（推荐使用 LTS 版本）。
  • 网络问题：国内用户建议配置淘宝镜像源以加速下载。
  • 权限问题：Linux/macOS 用户若遇到权限错误，可尝试： 
    1
    sudo chmod -R 777 /usr/local/lib/node_modules