Yarn 是一个快速、可靠且安全的依赖包管理工具,用于替代 npm。以下是在不同操作系统上安装和配置 Yarn 的步骤。
1. 安装 Node.js
在安装 Yarn 之前,请确保已经安装了 Node.js,因为 Yarn 需要 Node.js 环境。你可以在 Node.js — Run JavaScript Everywhere 下载并安装适合你操作系统的版本。
2. 在 Ubuntu / Debian 上安装 Yarn
在 Ubuntu 或 Debian 系统上,可以通过以下命令使用包管理器 apt 来安装 Yarn:
Bash
1curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
2echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
3sudo apt-get update && sudo apt-get install yarn
3. 在 CentOS / RHEL 上安装 Yarn
在 CentOS 或 RHEL 系统上,可以使用以下命令通过包管理器 yum 或 dnf 来安装 Yarn:
Bash
1curl -sS https://dl.yarnpkg.com/rpm/pubkey.gpg | sudo rpm --import -
2echo -e "[yarn]\nname=Yarn\nbaseurl=https://dl.yarnpkg.com/rpm/\nenabled=1\ngpgcheck=1\nrepo_gpgcheck=1\ngpgkey=https://dl.yarnpkg.com/rpm/pubkey.gpg" | sudo tee /etc/yum.repos.d/yarn.repo
3sudo yum install yarn
4# 如果你的系统使用的是dnf,替换上面的yum为dnf即可
4. 在 macOS 上安装 Yarn
在 macOS 上,可以使用 Homebrew 包管理器来安装 Yarn:
Bash
1brew install yarn
5. 在 Windows 上安装 Yarn
在 Windows 上,你可以通过 Chocolatey 包管理器或直接从 Yarn 官网下载安装包进行安装。
- 使用 Chocolatey:
1choco install yarn
- 从官网下载:访问 Installation | Yarn ,下载并运行安装程序。
6. 配置 Yarn
安装完成后,你可能需要对 Yarn 进行一些基本配置,例如设置全局安装目录和缓存目录。可以通过编辑 .yarnrc
文件(位于用户主目录下)来完成这些配置。
例如,要将全局安装目录设置为 /usr/local/lib/node_modules
和缓存目录设置为 /var/cache/yarn
,可以添加以下内容到 .yarnrc
文件中:
1yarn-offline-mirror: false
2global-folder: "/usr/local/lib/node_modules"
3cache-folder: "/var/cache/yarn"
请根据实际情况调整路径。
成功安装和配置了 Yarn,可以开始使用它来管理 项目依赖了!
Yarn 是一个高效、可靠且安全的包管理器,它与 npm 兼容但提供了更快的安装速度和更好的依赖一致性。以下是 Yarn 的基本用法概览,这将帮助你快速上手使用 Yarn:
7.基本命令
初始化项目
若要初始化一个新的项目,使用 yarn init 命令。这会创建一个 package.json 文件,并引导你填写项目信息。
添加依赖
使用 yarn add <package> 来安装一个新包。例如,安装 lodash 库:
yarn add lodash
安装项目依赖
要安装项目中列出的所有依赖,只需运行 yarn 或 yarn install。Yarn 会读取 package.json 中的 dependencies 和 devDependencies 列表。
升级依赖
若要升级一个已存在的依赖到最新版本,使用 yarn upgrade <package>。
移除依赖
使用 yarn remove <package> 来移除一个不再需要的包。
列出所有依赖
yarn list 命令显示所有已安装的依赖包及其版本。
检查依赖
yarn check 可以验证项目中的依赖是否与 package-lock.json 或 yarn.lock 文件中的信息匹配。
清理缓存
使用 yarn cache clean 清除 Yarn 的缓存。
全局安装
若要全局安装一个包,使用 yarn global add <package>。
8.高级功能
链接本地模块
使用 yarn link 和 yarn link <package> 命令来链接本地开发的模块到项目中,这样就可以在开发过程中实时看到模块的变化。
工作空间
大型项目可能包含多个子项目,每个子项目都有自己的 package.json。Yarn 的工作空间功能可以帮助管理这些子项目。在根目录的 package.json 文件中定义 workspaces 字段,然后可以使用 yarn workspaces <command> 来针对所有工作空间执行命令。
插件
Yarn 支持插件,可以扩展其功能。使用 yarn plugin import <plugin-name> 来安装插件。
多版本支持
Yarn 允许同时安装不同版本的相同包,这在处理不同的项目需求时非常有用。
9.日常使用技巧
脚本运行
除了管理依赖,package.json 中的 scripts 字段可以用来定义常用任务,例如构建、测试和部署。使用 yarn <script-name> 来运行这些脚本。
环境变量
Yarn 可以通过 .env 文件或环境变量来设置项目级别的环境变量,这对于配置不同的环境(如开发、测试和生产)很有帮助。
锁定文件
Yarn 使用 yarn.lock 文件来跟踪确切的依赖版本,确保在任何环境中安装的依赖完全一致。
10.构建和发布
-
构建和打包
如果你的项目有构建步骤,比如编译源代码或者压缩资源文件,可以在package.json
的scripts
字段中定义一个build
脚本,然后使用yarn build
来运行这个脚本。 -
发布到npm仓库
使用yarn publish
命令可以将你的项目发布到 npm 仓库。在发布前,请确保你已经在 npm 登录过 (npm login
) 并且你的package.json
文件中的version
字段已经更新。
11.检查和审计
-
依赖关系图
使用yarn why <package>
查看特定包是如何被引入项目的,以及它的所有依赖树。 -
依赖审计
yarn audit
命令可以检查你的项目是否存在已知的安全漏洞,并提供修复建议。
12.自动化和CI/CD
-
自动化脚本
你可以将yarn
命令集成到 CI/CD 流水线中,例如在构建流程中自动运行yarn install
和yarn test
。 -
环境变量和配置
利用.env
文件或环境变量来存储敏感信息,如 API 密钥和数据库连接字符串,以避免硬编码到代码中。
13.性能优化
-
使用离线模式
当网络不稳定或不可用时,可以使用yarn install --offline
命令,Yarn 将尝试从本地缓存安装依赖。 -
自定义镜像源
对于国内用户,可以通过修改.yarnrc
文件中的registry
设置来使用国内的 npm 镜像源,例如阿里云镜像,以提高下载速度。
14.最佳实践
-
保持
yarn.lock
文件同步
每次修改依赖后,都应该提交更新后的yarn.lock
文件到版本控制系统,确保团队成员使用相同的依赖版本。 -
定期更新依赖
定期运行yarn outdated
检查过时的依赖,然后使用yarn upgrade
更新它们,以获取最新的安全补丁和功能改进。 -
使用Workspaces管理多项目
如果你的项目包含多个独立的子项目,考虑使用 Workspaces 功能来简化依赖管理和构建过程。 -
文档和注释
在package.json
和README.md
文件中详细记录项目的依赖、脚本和安装步骤,以便新加入的开发者能够快速上手。