[web前端] yarn和npm命令使用

 

最初接触 ​​yarn​​ 还是在 ​​0.17.10​​ 版本，由于各种各样的原因，使用时没 npm 顺手, 目前 ​​yarn​​ 的版本已经升级为 ​​1.7.0​​ 各种之前遇到的问题不复存在，安装、下载速度都比 npm 要快很多，这里对之前记录做一下修改。

版本说明 （当前文档使用版本）

yarn : v0.17.10
yarn: v1.3.2 (修改日期 2017.12.26)
node: v8.9.0
npm: v5.6.0

安装

1. macOS 通过 homebrew 安装 brew install yarn
2. Windows 下载安装 下载地址
3. 查看版本 yarn --version

1. 开始一个新工程

yarn init 与 npm init 一样通过交互式会话创建一个 package.json

yarn init # yarn 
    npm init # npm

    # 跳过会话，直接通过默认值生成 package.json
    yarn init --yes # 简写 -y
    npm init -y

2. 添加一个依赖

通过 ​​yarn add​​ 添加依赖会更新 ​​package.json​​ 以及 ​​yarn.lock​​ 文件 

​​yarn add <packageName>​​ 依赖会记录在 ​​package.json​​ 的 ​​dependencies​​ 下

yarn add webpack@2.3.3 # yarn  --save 是 yarn 默认的，默认记录在 package.json 中
npm install webpack@2.3.3 --save # npm

1. ​​yarn add <packageName> --dev​​ 依赖会记录在 ​​package.json​​ 的 ​​devDependencies​​ 下

yarn add webpack --dev # yarn 简写 -D
    npm install webpack --save-dev # npm

1. ​​yarn global add <packageName>​​ 全局安装依赖

yarn global add webpack # yarn
    npm install webpack -g # npm

3. 更新一个依赖

​​yarn upgrade​​ 用于更新包到基于规范范围的最新版本

yarn upgrade # 升级所有依赖项，不记录在 package.json 中
    npm update # npm 可以通过 ‘--save|--save-dev’ 指定升级哪类依赖

    yarn upgrade webpack # 升级指定包
    npm update webpack --save-dev # npm

    yarn upgrade --latest # 忽略版本规则，升级到最新版本，并且更新 package.json

4. 移除一个依赖

yarn remove <packageName>

yarn remove webpack # yarn
    npm uninstall webpack --save # npm 可以指定 --save | --save-dev

5. 安装 package.json 中的所有文件

​​yarn​​ 或者 ​​yarn install​​

yarn install # 或者 yarn 在 node_modules 目录安装 package.json 中列出的所有依赖
    npm install # npm

    # yarn install 安装时，如果 node_modules 中有相应的包则不会重新下载 --force 可以强制重新下载安装
    yarn install --force # 强制下载安装
    npm install --force # npm

6. 运行脚本

​​yarn run​​ 用来执行在 ​​package.json​​ 中 ​​scripts​​ 属性下定义的脚本

// package.json
    {
        "scripts": {
            "dev": "node app.js",
            "start": "node app.js"
        }
    }

yarn run dev # yarn 执行 dev 对应的脚本 node app.js
    npm run # npm

    yarn start # yarn
    npm start # npm

与 npm 一样 可以有 ​​yarn start​​ 和 ​​yarn test​​ 两个简写的运行脚本方式

7. 显示某个包信息

​​yarn info <packageName>​​ 可以用来查看某个模块的最新版本信息

yarn info webpack # yarn 
    npm info webpack # npm

    yarn info webpack --json # 输出 json 格式
    npm info webpack  --json # npm

    yarn info webpack readme # 输出 README 部分
    npm info webpack readme

8. 列出项目的所有依赖

yarn list

yarn list # 列出当前项目的依赖
    npm list # npm

    yarn list --depth=0 # 限制依赖的深度
    sudo yarn global list # 列出全局安装的模块

9. 管理 yarn 配置文件

yarn config

yarn config set key value # 设置
    npm config set key value

    yarn config get key # 读取值
    npm config get key

    yarn config delete key # 删除
    npm config delete key

    yarn config list # 显示当前配置
    npm config list 

    yarn config set registry https://registry.npm.taobao.org # 设置淘宝镜像
    npm config set registry https://registry.npm.taobao.org # npm

10. 缓存

yarn cache

sudo yarn cache list # 列出已缓存的每个包
    sudo yarn cache dir # 返回 全局缓存位置
    sudo yarn cache clean # 清除缓存

11. 问题

1. 安装 package.json 中文件的问题

正常安装 ​​sudo yarn add react@15.4.2​​ package.json 中 出现

"dependencies": {
        "react": "15.4.2"

 }

通过终端查看安装版本 ​​yarn list​​

├─ react@15.4.2
    │  ├─ fbjs@^0.8.4
    │  ├─ loose-envify@^1.1.0
    │  └─ object-assign@^4.1.0

是正确的版本，但是，如果在 package.json 中加上如下依赖，然后通过 ​​sudo yarn install​​ 安装

 

"dependencies": {
        "react": "15.4.2",
        "react-dom": "^15.4.2",
        "jquery": "^3.0.0"
    }

通过终端查看安装版本 ​​yarn list​​

├─ react-dom@15.5.3
    │  ├─ fbjs@^0.8.9
    │  ├─ loose-envify@^1.1.0
    │  ├─ object-assign@^4.1.0
    │  └─ prop-types@~15.5.0
    ├─ react@15.4.2
    │  ├─ fbjs@^0.8.4
    │  ├─ loose-envify@^1.1.0
    │  └─ object-assign@^4.1.0
    ├─ jquery@3.2.1

react 还是之前的版本，但是 新安装的 react-dom 和 jquery 都变成了 最新版本

再试试将版本号的写法变一下 去掉 ​​^​​

"dependencies": {
        "react": "15.4.2",
        "react-dom": "15.4.2",
        "jquery": "3.0.0"
    }

通过 ​​sudo yarn install​​ 安装 查看安装版本 ​​yarn list​​

├─ react-dom@15.4.2
    │  ├─ fbjs@^0.8.1
    │  ├─ loose-envify@^1.1.0
    │  └─ object-assign@^4.1.0
    ├─ react@15.4.2
    │  ├─ fbjs@^0.8.4
    │  ├─ loose-envify@^1.1.0
    │  └─ object-assign@^4.1.0
    ├─ jquery@3.0.0

安装的是正确的版本了

说明

1:  "react-dom": "^15.4.2"这种写法,加了^，是一般是通过npm install --save安装插件生成版本号的默认格式，表示安装15.x.x的最新版本，安装时不改变大版本号
2:  "react-dom": "15.4.2"这种写法,只有版本号，是 yarn add安装后生成版本号的默认格式，表示必须安装同一个版本号
3:  版本号控制，有一个规范，就是语义化版本号控制，规定了版本号格式为：主版本号.次版本号.修订号；

• 主版本号：当你做了不兼容的 API 修改
• 次版本号：当你做了向下兼容的功能性新增
• 修订号：当你做了向下兼容的问题修正

一般来讲 只要主版本号正确，就可以兼容，但是像 最新版的 react@15.5.3 ,出现了React.createClass与React.PropTypes弃用的警告，控制台一片红，因为引用了第三方组件库，最后选择暂不升级react，类似的情况，个人感觉 yarn 默认的版本号写法(只安装特定版本的文件)，更符合需求，npm 的话，很可能导致两个拥有同样package.json 的应用，安装了不同版本的包，进而导致一些BUG

2. 在 yarn 或者 npm 中设置默认版本规则

npm set save-exact true 全局设置 package.json 只记录确切版本号 node: 1.1.1,

npm config set save-prefix '~' 设置安装新模块时，package.json 记录版本号的方式 ~ \ ^ 等

sudo yarn config set save-prefix '~' 通过 yarn 设置，要有 sudo 权限

注意： 通过以上设置可以更改package.json 中记录的版本号默认方式，但是 ​​yarn​​ 的设置是带有 sudo 权限的，通过 ​​sudo add <packageName>​​ 的模块才会按照设置的方式更新版本号

12. 总结

就像官网上说的，​​yarn​​ 的安装速度快，能并行化操作以最大化资源利用率；安全，Yarn会在每个安装包被执行前校验其完整性。正式版的 ​​yarn​​ 比较与 ​​npm​​ 更高效