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