Yarn 是一个快速、可靠和安全的 JavaScript 包管理器,由 Facebook 开发。以下是关于如何安装、配置和使用 Yarn 的详细教程。
1. 安装 Yarn
1.1 使用 npm 安装 Yarn
如果已经安装了 npm,可以通过以下命令安装 Yarn:
bash
复制代码
npm install --global yarn
1.2 使用安装脚本
Yarn 提供了一个安装脚本,可以通过以下命令安装:
bash
复制代码
curl -o- -L https://yarnpkg.com/install.sh | bash
1.3 使用包管理器安装
根据操作系统的不同,可以使用适合的包管理器安装 Yarn:
macOS
使用 Homebrew 安装:
bash
复制代码
brew install yarn
Ubuntu/Debian
先配置 Yarn 的包管理仓库,然后使用 apt 安装:
bash
复制代码
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
先配置 Yarn 的包管理仓库,然后使用 yum 安装:
bash
复制代码
curl -sL https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo sudo yum install yarn
2. 配置 Yarn
2.1 设置镜像源
如果在国内使用 Yarn,可以设置为淘宝的镜像源以提高下载速度:
bash
复制代码
yarn config set registry https://registry.npmmirror.com
2.2 配置全局缓存路径
可以自定义缓存路径来管理缓存:
bash
复制代码
yarn config set cache-folder /path/to/your/cache
3. 使用 Yarn
3.1 初始化项目
在新项目目录中运行以下命令来初始化一个新的 package.json
文件:
bash
复制代码
yarn init
根据提示输入项目名称、版本、描述等信息。
3.2 安装依赖
安装所有依赖
在有 package.json
文件的项目中运行以下命令安装所有依赖:
bash
复制代码
yarn install
安装特定依赖
安装一个依赖包并将其添加到 dependencies
:
bash
复制代码
yarn add package-name
安装一个依赖包并将其添加到 devDependencies
:
bash
复制代码
yarn add package-name --dev
安装一个特定版本的包:
bash
复制代码
yarn add package-name@version
全局安装依赖
安装一个全局包:
bash
复制代码
yarn global add package-name
3.3 移除依赖
移除一个依赖包并从 package.json
中删除相应条目:
bash
复制代码
yarn remove package-name
3.4 更新依赖
更新所有依赖:
bash
复制代码
yarn upgrade
更新特定依赖:
bash
复制代码
yarn upgrade package-name
3.5 脚本命令
在 package.json
中定义脚本命令,例如:
json
复制代码
{ "scripts": { "start": "node app.js", "test": "jest" } }
运行定义的脚本:
bash
复制代码
yarn start yarn test
3.6 使用 Yarn Workspaces
Yarn Workspaces 可以帮助管理 monorepo 项目。首先,在 package.json
中启用 Workspaces:
json
复制代码
{ "private": true, "workspaces": ["packages/*"] }
在 packages
目录中可以有多个子包,每个子包都有自己的 package.json
文件。然后在项目根目录中运行 yarn install
来安装所有依赖。
4. 常用命令
以下是一些常用的 Yarn 命令及其作用:
- yarn init: 初始化一个新的
package.json
文件。 - yarn install: 安装项目中的所有依赖。
- yarn add <package>: 安装一个依赖包。
- yarn remove <package>: 移除一个依赖包。
- yarn upgrade: 更新所有依赖包。
- yarn run <script>: 运行
package.json
中定义的脚本。 - yarn global add <package>: 全局安装一个依赖包。
通过以上步骤和命令,您可以轻松安装、配置和使用 Yarn 来管理 JavaScript 项目的依赖。