zjffun blog

npm 使用

更新于 写于 前端

基本使用

  1. 安装 较新版本 Node 自带，基本不用自己装
  2. 初始化 npm init之后一路 next
  3. 安装依赖
  • npm install --production安装 package.json 里已经声明了依赖（只安装 dependencies）
  • npm install安装 package.json 里已经声明了依赖（包括：devDependencies 和 dependencies）

下载源

nrm

国内 npm 官方源慢，用 nrm 可以切换成淘宝的 npm 镜像源

nrm can help you easy and fast switch between different npm registries, now include: npm, cnpm, taobao, nj(nodejitsu), rednpm.

  • Install

$ npm install -g nrm

  • Example
bash
$ nrm use cnpm  //switch registry to cnpm

    Registry has been set to: http://r.cnpmjs.org/

nrm 的原理是修改 npm 的registr配置，cnpm是 fork 一个子进程实现的（据说有问题没有用过，感觉在发布时会省点事，nrm 还得切回去）

bash
# 建议不要用 cnpm 安装 会有各种诡异的bug 可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=https://registry.npm.taobao.org
bash
alias cnpmi='npm install --registry=https://registry.npm.taobao.org/'

卡在 Building fresh packages，npm 包用到的附加无法下载？

一些 npm 包需要一些附件，这些附件通常在配置文件的 script 的 preinstall、install 或 postuninstall 中去下载，但因为墙或者网络的原因这些附件可能会无法下载或下载的很慢，所以得切换到国内的源才能获得极致的体验。

例如 puppeteer 的进行了如下配置在安装的时候下载 chromium：

text
{
  "name": "puppeteer",
  ...
  "scripts": {
    ...
    "install": "node install.js",
    ...
  },
  ...
},

常见的附件的下载源

text
puppeteer_download_host "https://npm.taobao.org/mirrors"
sass_binary_site "https://npm.taobao.org/mirrors/node-sass/"
phantomjs_cdnurl "http://cnpmjs.org/downloads"
electron_mirror "https://npm.taobao.org/mirrors/electron/"
sqlite3_binary_host_mirror "https://foxgis.oss-cn-shanghai.aliyuncs.com/"
profiler_binary_host_mirror "https://npm.taobao.org/mirrors/node-inspector/"
chromedriver_cdnurl "https://cdn.npm.taobao.org/dist/chromedriver"

使用：以解决 puppeteer 无法下载为例

npm

bash
npm config set puppeteer_download_host=https://storage.googleapis.com.cnpmjs.org

或 yarn

bash
yarn config set puppeteer_download_host https://npm.taobao.org/mirrors

或.npmrc

bash
echo 'PUPPETEER_DOWNLOAD_HOST = https://npm.taobao.org/mirrors' >> .npmrc

参见：希望添加 chromium 镜像源・Issue #1246・cnpm/cnpmjs.org

操作模块

  1. 安装，卸载模块

    npm install 模块名：安装模块（写入 package.json 中 dependencies 下的对应信息）

    npm uninstall 模块名：删除模块（删除 package.json 中 dependencies 下的对应信息）

    [--save-dev] 写入，删除 package.json 中 devDependencies 下的对应信息

    （dependencies：一般是运行时用到的模块，devDependencies：一般是开发时用到的工具的模块）

  2. 查找是否安装某模块

    npm 模块名 -v

  3. 查看安装的模块

    npm list [-g] [-depth n]

    -g：查看全局安装的模块

    -depth n：展示 n 层模块的依赖

PS：升级 npm 到最新版本npm install npm@latest -g

发布到 npm 社区

基本步骤

  1. 在 npm 社区注册

  2. npm adduser：输入用户名密码和邮箱登陆

    npm whoami：查看登陆的用户

  3. 配置package.json

  4. 配置.npmignore（未配置则使用.gitignore）

  5. ！！！发布前确保您的包可以安装和使用（下面细说一下如何在本地测试待发布的 npm 包）

  6. npm publish：发布

测试待发布的 npm 包

其实 npm 包就是一个带有package.json的文件夹。。

  • 全局安装测试
bash
cd %my-package%
npm install . -g # 当前包安装到全局

或者

bash
cd %my-package%
npm link # 当前包连接到全局（当前包状态改变，全局会跟着改变）
  • 本地安装测试
bash
cd %some-other-folder%
npm install %my-package%

修改版本

npm version 版本号：确定版本号（格式：主版本号.次版本号.修订号）（可以为 major | minor | patch 等）

代码状态 阶段 规则 例
首次发布 新作品 从 1.0.0 开始 1.0.0
向后兼容的 Bug 修复 Patch release 增加最右边第一个数字 1.0.1
向后兼容的新特性 Minor release 增加中间数字，并将最后一位数重置为零 1.1.0
无法向后兼容的更改 Major release 增加第一个数字，并将中间和最后一个数字重置为零 2.0.0

参见：

检查和解决隐患（vulnerabilities）

使用 npm 的安全检查。

bash
# 检查
npm audit [--json|--parseable]
# 解决
npm audit fix [--force|--package-lock-only|--dry-run|--production|--only=dev]

详细用法：docs.npmjs.com/cli/audit