1.安装 Yarn
- 在 MacOS 或 Linux 上安装:
brew install yarn
- 在 Ubuntu, Debian 或其他基于Debian的Linux发行版上
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-get update && sudo apt-get install yarn
- 在 CentOS 或 Fedora 上
sudo yum install yarn
- 在 Windows 上安装:
下载并运行 Yarn 的.msi 安装包,可以从官方下载页面获取:https://classic.yarnpkg.com/en/docs/install/#windows-tab
2. 验证 Yarn 是否成功安装
yarn --version
执行此命令后,将会显示已安装的 Yarn 版本号。
3. 使用 Yarn 初始化项目
在一个新的目录下创建一个新的 Node.js 项目:
bash mkdir my-project
cd my-project
yarn init
这将会引导你完成一系列交互式的问题,用来生成 package.json 文件。
4. 安装依赖
- 在项目中添加并安装依赖包:
bash
- 添加一个依赖项(例如 Express)
yarn add express
- 添加开发依赖项
yarn add --dev jest
- 或简写形式
yarn add -D jest
5. 运行项目
在 package.json 中定义了 scripts 字段后,可以使用 yarn 来运行它们:
bash
如果 package.json 中有 "start": "node index.js"
yarn start
6. 其他常用命令
- 更新依赖包
bash yarn upgrade <package-name>
- 查看已安装的依赖列表
bash yarn cache clean
7.工作区 (Workspaces) 和依赖链接 (Linking)
- 工作区 (Workspaces)
Yarn 支持工作区功能,可以在多个相互关联的包之间共享依赖关系。在根 package.json 文件中配置 workspaces 字段来启用该特性:
// package.json
{
"private": true,
"workspaces": ["packages/*"] // 包含所有 packages 目录下的子项目
}
在这种配置下,你可以在顶级目录下统一管理各个子项目的依赖,并使用如下命令操作:
# 在所有工作区内安装依赖
yarn install
# 在所有工作区内添加全局依赖
yarn add <package> -W
# 在某个特定工作区内添加依赖
cd packages/my-package
yarn add <package>
- 依赖链接 (Linking)
Yarn 提供了一个便捷的方式来本地链接和测试你的包,无需发布到远程仓库:
# 将本地包链接到全局模块
yarn link
# 在另一个项目中链接这个全局模块
cd another-project
yarn link <package-name>
# 解除链接
yarn unlink <package-name>
8. 自动化任务 (Scripts)
Yarn 可以直接运行 package.json 中定义的 scripts 命令,比如启动开发服务器、打包构建等:
# 执行 package.json 中的 build 脚本
yarn run build
# 或者简写形式
yarn build
9. Yarn Berry(现代版 Yarn)
Yarn 最新版本称为 Yarn Berry(或 Yarn v2+),它引入了许多改进,如零-installs(在某些情况下无需安装即可运行)、Plug'n'Play(PnP,不需要全局Node_modules)等新特性。安装 Yarn Berry 可参考其官网文档。
总之,Yarn 是一款强大的 JavaScript 包管理器,它通过更好的依赖管理、更快的安装速度、丰富的功能集极大地提升了前端开发者的体验。通过熟悉和掌握 Yarn 的各种命令和功能,能显著提高开发效率和项目维护质量。