Yarn快速入门(转载)

Yarn 使用入门

Yarn 对你的代码来说是一个包管理器。它可以让你使用并分享全世界开发者的(例如 JavaScript)代码。 Yarn 能够快速、安全、并可靠地完成这些工作,所以你不用有任何担心。

通过Yarn你可以使用其他开发者针对不同问题的解决方案,使自己的开发过程更简单。

代码通过包(package) (或者称为 模块(module)) 的方式来共享。 一个包里包含所有需要共享的代码,以及描述包信息的文件,称为 package.json。

1、安装

yarn 安装请进 传送门

Windows: 在Windows系统上,可以通过以下两种方式安装Yarn:

使用npm:运行命令 npm install --global yarn 来安装 Yarn。

npm install --global yarn

使用Chocolatey:如果已经安装了Chocolatey,可以通过 choco install yarn 命令进行安装。

choco install yarn

macOS: 在macOS上,推荐使用Homebrew进行安装,使用命令 brew install yarn

brew install yarn

Linux (Ubuntu/Debian): 在基于Debian的系统上,可以添加Yarn的官方仓库并使用apt进行安装:

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

 

Linux (CentOS/RHEL): 在基于RPM的系统上,可以添加Yarn的官方仓库并使用yum进行安装:

curl -sL https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo
sudo yum install yarn

安装完成后,可以通过运行 yarn --version 来验证Yarn是否安装成功.

yarn --version

1.1 配置环境变量

配置环境变量是确保Yarn能够全局访问的关键步骤。在Unix-like系统(包括Linux和macOS)中,通常需要编辑shell配置文件,如.bashrc、.zshrc或.profile。例如,在.bashrc文件中添加以下行:

export PATH="$PATH:$(yarn global bin)"

在Windows系统中,可以通过系统属性中的环境变量设置来添加Yarn的安装路径到PATH变量。确保Yarn的可执行文件路径被添加到PATH中,使得可以在命令行中直接调用yarn命令。

1.2 设置国内镜像源

由于网络问题,直接使用npm官方源在中国大陆可能会遇到访问速度慢或无法访问的问题。Yarn支持设置镜像源以加速包的下载。以下是设置国内镜像源的步骤:

使用淘宝的npm镜像作为Yarn的registry,可以通过以下命令设置:

yarn config set registry https://registry.npm.taobao.org

这将使得Yarn在安装包时使用淘宝的镜像源,显著提高下载速度。

如果需要使用其他镜像源,如npmmirror或cnpm,可以通过替换URL来设置:

yarn config set registry https://registry.npmmirror.com
# 或者
yarn config set registry https://r.cnpmjs.org


查看当前Yarn配置,确保镜像源设置正确:

yarn config list

 

2、Yarn 使用方法

现在 Yarn 已经 安装完毕,可以开始使用了。 以下是一些你需要的最常用的命令:

2.1 初始化一个新项目

yarn init

2.2 添加依赖包

yarn add [package]
yarn add [package]@[version]
yarn add [package]@[tag]

2.3 将依赖项添加到不同依赖项类别中

分别添加到 devDependencies、peerDependencies 和 optionalDependencies 类别中:

yarn add [package] --dev
yarn add [package] --peer
yarn add [package] --optional

devDependencies、peerDependencies 和 optionalDependencies区别

在一个Node.js项目中,package.json几乎是一个必须的文件,它的主要作用就是管理项目中所使用到的外部依赖包,同时它也是npm命令的入口文件。

npm 目前支持以下几类依赖包管理:

  • dependencies
  • devDependencies
  • peerDependencies
  • optionalDependencies
  • bundledDependencies / bundleDependencies

dependencies

应用依赖,或者叫做业务依赖,这是我们最常用的依赖包管理对象!它用于指定应用依赖的外部包,这些依赖是应用发布后正常执行时所需要的,但不包含测试时或者本地打包时所使用的包。

devDependencies

开发环境依赖,仅次于dependencies的使用频率!它的对象定义和dependencies一样,只不过它里面的包只用于开发环境,不用于生产环境,这些包通常是单元测试或者打包工具等,例如gulp, grunt, webpack, moca, coffee等。

peerDependencies

同等依赖,或者叫同伴依赖,用于指定当前包(也就是你写的包)兼容的宿主版本。如何理解呢? 试想一下,我们编写一个gulp的插件,而gulp却有多个主版本,我们只想兼容最新的版本,此时就可以用同等依赖(peerDependencies)来指定。

{
  "name": "gulp-my-plugin",
  "version": "0.0.1",
  "peerDependencies": {
    "gulp": "3.x"
  }
}

optionalDependencies

可选依赖,如果有一些依赖包即使安装失败,项目仍然能够运行或者希望npm继续运行,就可以使用optionalDependencies。另外optionalDependencies会覆盖dependencies中的同名依赖包,所以不要在两个地方都写。

bundledDependencies / bundleDependencies

打包依赖,bundledDependencies是一个包含依赖包名的数组对象,在发布时会将这个对象中的包打包到最终的发布包里。

2.4 升级依赖包

yarn upgrade [package]
yarn upgrade [package]@[version]
yarn upgrade [package]@[tag]

2.5 移除依赖包

yarn remove [package]

2.6 安装项目的全部依赖

yarn

或者

yarn install

 

3. 检查Yarn安装

3.1 验证安装是否成功

安装完成后,需要验证Yarn是否安装成功。可以通过在终端或命令提示符中执行以下命令来检查:

yarn --version

如果终端输出了Yarn的版本号,这表明Yarn已经成功安装在您的系统上。

3.2 检查Yarn的全局安装路径

Yarn的全局安装路径可以通过以下命令查看:

yarn global dir

该命令将显示Yarn全局安装包的路径,确保您知道Yarn包被安装在哪里。

3.3 检查Yarn的配置信息

使用以下命令可以查看Yarn的所有配置信息,包括镜像源、缓存路径等:

yarn config list

 

这个命令会列出当前Yarn的配置,您可以检查是否已经按照您的需求进行了相应的配置。

3.4 检查Yarn的依赖管理

Yarn使用yarn.lock文件来锁定依赖项的版本,确保在不同环境中的依赖一致性。您可以检查项目根目录下是否存在yarn.lock文件:

ls yarn.lock

如果存在,说明依赖项已经被锁定,这有助于团队协作和持续集成流程中的稳定性。

3.5 检查Yarn的插件和扩展

Yarn支持插件系统,可以通过以下命令查看已安装的插件:

yarn plugins list

如果列出了插件,说明Yarn已经配置了额外的功能扩展,可以根据需要使用这些插件来增强Yarn的功能。

4. 升级Yarn

升级Yarn是确保你能够使用最新功能和安全更新的重要步骤。Yarn会定期发布新版本,包括性能改进、新特性以及安全修复。

4.1 升级方法

升级Yarn的主要方法有两种:通过npm和使用Yarn自己的命令。

通过npm升级:由于Yarn是通过npm安装的,因此可以使用npm命令来升级Yarn到最新版本。

npm install -g yarn

使用Yarn升级:如果系统中已经安装了Yarn,可以使用Yarn提供的命令来升级自身。

yarn set version latest  --如果系统已安装Yarn,比如是1.22.x 该方法只是升级到1.22.x上的最新版本
yarn install
yarn set version stable --这将把Yarn升级到最新的稳定版本

yarn set version beta --升级到最新的预览版本

yarn set version <version> --指定一个特定的版本来升级

 

4.2 升级注意事项

在升级Yarn之前,需要注意以下几点:

备份:在升级之前,建议备份你的项目和全局配置,以防万一升级过程中出现问题。

检查依赖:升级Yarn可能会影响你的项目依赖,确保在升级后重新运行yarn install来安装最新的依赖版本。

测试:在生产环境中升级之前,建议在开发或测试环境中先进行升级,确保新版本不会影响现有功能。

4.3 升级流程

升级Yarn的一般流程如下:

查看当前版本:使用命令yarn --version来查看当前Yarn的版本。
获取最新版本:通过上述任一方法获取Yarn的最新版本。
验证安装:升级完成后,再次使用yarn --version来验证是否升级成功。
更新项目依赖:运行yarn install来确保所有依赖都是最新的,并且与新版本的Yarn兼容。

4.4 升级后的验证

升级后,可以通过以下方式验证Yarn是否正常工作:

运行项目:尝试运行你的项目,确保一切正常运行。
检查依赖:查看package.json和yarn.lock文件,确保所有依赖都已正确安装。
使用Yarn命令:尝试使用一些常用的Yarn命令,如yarn add、yarn remove等,以确保命令行工具的功能正常。
通过上述步骤,你可以确保Yarn的升级过程顺利,并且不会影响你的开发工作。

 


————————————————

版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。

转载链接:https://blog.csdn.net/weixin_45046532/article/details/140458475

链接:https://www.jianshu.com/p/a1d2344f54a7

posted @ 2022-05-23 09:24  浅巷深念  阅读(92)  评论(0编辑  收藏  举报