新手指南
Yarn 对你的代码来说是一个包管理器, 你可以通过它使用全世界开发者的代码,或者分享自己的代码。 Yarn 做这些快捷、安全、可靠,所以你不用担心什么。
通过Yarn你可以使用其他开发者针对不同问题的解决方案,使自己的开发过程更简单。 使用过程中遇到问题,你可以将其上报或者贡献解决方案。一旦问题被修复,Yarn会更新保持同步。
代码通过包(package)(或者称为模块(module))的方式来共享。 一个包里包含所有需要共享的代码,以及描述包信息的文件,称为package.json
。
安装
稳定版:v1.3.2
Node.js版本:^4.8.0 || ^5.7.0 || ^6.2.2 || ^8.0.0
在你使用 Yarn 之前,你需要先在系统中安装它。有一些不同的方法(还在增加)安装 Yarn:
windows 中如何安装
在 Windows 系统中安装 Yarn 有多种方法
- 方法一:直接下载安装程序安装
这将给你一个.msi 文件(下载安装程序),当你运行它时带领你安装 Yarn 到 Windows 上。
前提,你需要先安装 Node.js。
- 方法二:用 Chocolatey 安装
Chocolatey 是一个适用于 Windows 的包管理器,您可以用这个*操作方式*安装。
如果你已经安装了 Chocolatey,你可以在你的控制台里运行下面的指令安装 yarn:
1 | choco install yarn |
同样的,你需要确保先安装了 Node.js。
- 方法三:通过 Scoop 安装
Scoop 是一个 Windows 的命令行安装程序,你可以用这些指令安装 Scoop。
安装好了 Scoop 后,你可以在控制台里运行下面的代码安装 yarn:
1 | scoop install yarn |
如果之前没有安装 Node.js,scoop 将给你一个建议来安装它。 例如:
1 | scoop install nodejs |
- 方法四(备选):通过 npm 安装
**注意:**一般来说, 不推荐通过 npm 安装 Yarn 在用基于 Node 的包管理器安装 Yarn 时,该包未被签名,并且只通过基本的 SHA1 散列进行唯一完整性检查。 这在安装系统级应用时有安全风险。
因为这些原因,高度推荐用你的操作系统最适合的方式来安装 Yarn。
你还可以通过 npm package manager 来安装 Yarn。 如果你已经装了Node.js,那你应该已经有 npm 了。
安装好 npm 后你可以用如下命令来安装 yarn:
1 | npm install --global yarn |
此外你还需要在终端里设置PATH
环境变量来全局访问 Yarn 的二进制可执行程序。
添加 set PATH=%PATH%;C:\.yarn\bin
到你的 shell 环境。
- 提示:
请把你的项目目录和 Yarn 缓存目录 (%LocalAppData%\Yarn) 加到你的杀毒软件白名单里,否则安装包时会明显变慢,每个写入到硬盘时将被扫描。
- 测试 Yarn 是否安装成功
运行如下命令:
1 | yarn --version |
Mac OS 中如何安装
Debian/Ubuntu Linux 中如何安装
Nightly Builds
Nightly Builds 是 Yarn 最新和最大的版本,使用最新的 Yarn 代码构建。Nightly Builds 对于尝试还没有作为稳定版发布的新功能或测试 bug 修复很有用。这些 Builds 不保证稳定并且可能有 bugs。
请参阅如何安装 Nightly Builds
有问题吗? 如果你不能用这些安装程序安装 Yarn,请通过 GitHub 搜索一个 issue 或者开一个新的 issue。
使用
现在Yarn已经 安装完毕,可以开始使用。以下是一些你需要的最常用的命令:
- 初始化新项目
1 | yarn init |
- 添加依赖包
1 | yarn add [package] |
- 将依赖项添加到不同依赖项类别
分别添加到devDependencies
、peerDependencies
和optionalDependencies
:
1 | yarn add [package] --dev |
- 升级依赖包
1 | yarn upgrade [package] |
- 移除依赖包
1 | yarn remove [package] |
- 安装项目的全部依赖
1 | yarn |
延伸阅读
Yarn 工作流(如何使用Yarn?方便的创建与使用Yarn包的工作流程将帮你快速提高生产力。)
CLI 命令(Yarn 通过一组丰富的命令执行包安装、管理、发布等操作。)