1. 安装 Yarn
使用 npm 安装
如果你已经安装了 Node.js 和 npm,可以直接使用 npm 安装 Yarn:
npm install --global yarn
使用安装脚本
你也可以使用 Yarn 官方提供的安装脚本:
curl -o- -L https://yarnpkg.com/install.sh | bash
使用包管理器安装
根据你的操作系统选择适合的包管理器安装 Yarn。
macOS (Homebrew):
brew install yarn
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
Windows (Chocolatey):
choco install yarn
2. 配置 Yarn
设置镜像源
为了加速 Yarn 的包下载速度,可以配置国内镜像源。例如:
yarn config set registry https://registry.npm.taobao.org
查看配置
可以通过以下命令查看 Yarn 的当前配置:
yarn config list
配置全局缓存目录
可以自定义 Yarn 的全局缓存目录:
yarn config set cache-folder /path/to/yarn/cache
3. 使用 Yarn
初始化项目
使用 Yarn 初始化一个新项目:
yarn init
按照提示输入项目名称、版本、描述等信息,最终会生成一个 package.json
文件。
添加依赖包
安装单个包:
yarn add package-name
安装指定版本的包:
yarn add package-name@version
全局安装包:
yarn global add package-name
移除依赖包
移除一个已安装的包:
yarn remove package-name
安装所有依赖
根据 package.json
文件安装所有依赖:
yarn install
更新依赖包
更新指定的包:
yarn upgrade package-name
更新所有依赖包:
yarn upgrade
锁定文件
Yarn 使用 yarn.lock
文件锁定依赖包的版本,确保项目在不同环境下安装的包版本一致。每次添加或更新依赖时,Yarn 都会更新 yarn.lock
文件。
脚本命令
在 package.json
文件中定义脚本命令,然后使用 Yarn 运行:
{ "scripts": { "start": "node index.js", "test": "jest" } }
运行脚本命令:
yarn start yarn test
查看全局包
查看全局安装的包:
yarn global list
4. 高级用法
Workspaces
Yarn Workspaces 用于管理多个包的单个项目,如 Monorepo 项目。启用 Workspaces:
在 package.json
文件中添加:
{ "private": true, "workspaces": [ "packages/*" ] }
自动清理缓存
Yarn 提供自动清理缓存的命令,释放磁盘空间:
yarn cache clean
检查包版本
Yarn 提供工具检查项目中依赖包的版本,并推荐更新:
yarn outdated
执行命令
Yarn 可以执行 node_modules 中包的命令:
yarn run package-command
例如,执行 Jest 测试:
yarn run jest
5. 常见问题和解决方案
修改全局安装路径
如果需要更改 Yarn 全局安装包的路径,可以使用以下命令:
yarn config set prefix /desired/path
切换 Node 版本
可以使用 nvm
或 n
来管理和切换不同版本的 Node.js,与 Yarn 配合使用效果更佳。
卸载 Yarn
如果需要卸载 Yarn,可以使用以下命令:
npm uninstall --global yarn