文档

中文文档 https://www.npmjs.cn/

安装

npm 是 node 的包管理工具，安装 Node 时，就会自动安装 npm。

常用命令

• npm install [@scope/]<packageName>@<version> 下载依赖包
  • npm install -S 或 npm install --save安装生产过程中的依赖
  • npm install -D 或 npm install --save-dev 安装开发过程中的依赖
  • npm install -g <packageName> --registry=https://registry.npm.taobao.org 从特定的源上下载包
  • npm install --save-exact固定依赖包的版本
• npm unstall <packageName> 卸载依赖包
• npm <packageName> -v 查看是否使用npm安装过某个插件
• npm ls 或 npm list 树形展示当前安装的所有 node_modules
  • npm ls <packgeName> 树型展示当前安装包依赖的插件版本
• npm outdated 检查当前安装插件新老版本
• npm config list 查看 npm 全局配置
• npm config set registry https://registry.npm.taobao.org 更改 npm 镜像
• npm owner ls <packageName> 查看依赖包权限所有者的名字
• npx <plugin> <pluginDrective> 使用其他包内提供的命令行工具
• npm link 将正在调试的 npm 包链接到全局
  • npm link <packageName> 进入到对应项目目录，link 想要使用的本地包名
  • npm unlink <packageName> 解除模块的全局 link

清除缓存

• rm -rf /node_modules
• npm clean cache --force
• npm install

常见问题

• windows 下安装 npm install <packageName> 或 cnpm install <packageName> 没反应：把 c:/Users/,npmrc 是删除试试
• npm install 时报错：mkdir access denied. 这种情况多发生在 git bash 环境里，要用管理员身份运行 git bash。也可以一劳永逸在运行的快捷方式中直接设置“用管理员身份运行”（详情）
• 同理，Mac下没权限用 sudo npm install xxx
• npm link 后 cannot find modules，这个要注意有的包 npm link 直接在开发包根目录执行就可以，而有的包是编译后新生成一个/dist 文件夹，要在 /dist 下执行 npm link
• .npmrc 文件：一般项目根目录有这个文件的话，npm config 会直接用这里的配置，如镜像源地址

  registry=https://registry.npmmirror.com
  

常用插件

• cnpm：淘宝镜像

  • 执行 npm install -g cnpm --registry=https://registry.npm.taobao.org 全局安装
  • 输入 cnpm -v 检验是否安装成功

• npm-check-updates : 检查插件更新，安装插件

  • ncu - v （ncu 是 npm-check-updates 的缩写命令）查看当前各个安装包的版本
  • 注：ncu 更新插件后，会自动修改 package.json 里的版本号

• nvm : node 版本管理工具，快速切换本地 node 版本

  • nvm list available: 打印出 node released 各个版本
  • nvm use <version>: 指定要使用的 node 版本
  • nvm install <version>: 下载指定的 node 版本
  • 注意：
    1. 当 windows 在 git bash 中使用 nvm 版本切换的时候，提示切换成功，但实际上并没切换成功；要在 CMD 中使用 nvm 进行切换 。
    2. 每次重启终端都要重新设置 nvm，使用 nvm alias default stable 固定版本

• npx npkill：删除电脑某一磁盘下的 node_modules

  2. nvm 安装并切换至新版本 node 时，报错 npm command not found：可能是 nvm 安装 node 时，npm下载失败了；也有可能是 node v12.16.0 的坑，mac 下安装这个版本的 node 时，npm 也出过问题。
  3. nvm 切换 node 版本后，会导致 npm 全局安装过的包失效：解决方式
  4. (偶发) nvm 管理 node 版本升级到10以上后无法安装 npm
  5. Mac全局安装插件报错：Missing write access to /usr/local/lib/node_modules/webpack，使用sudo install -g pkgName@pkgVersion