文檔

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

安裝

npm 是 node 的包管理工具，安裝 Node 時(shí)，就會自動(dòng)安裝 npm。

常用命令

• npm install [@scope/]<packageName>@<version> 下載依賴包
  • npm install -S 或 npm install --save安裝生產(chǎn)過程中的依賴
  • npm install -D 或 npm install --save-dev 安裝開發(fā)過程中的依賴
  • npm install -g <packageName> --registry=https://registry.npm.taobao.org 從特定的源上下載包
  • npm install --save-exact固定依賴包的版本
• npm unstall <packageName> 卸載依賴包
• npm <packageName> -v 查看是否使用npm安裝過某個(gè)插件
• npm ls 或 npm list 樹形展示當(dāng)前安裝的所有 node_modules
  • npm ls <packgeName> 樹型展示當(dāng)前安裝包依賴的插件版本
• npm outdated 檢查當(dāng)前安裝插件新老版本
• npm config list 查看 npm 全局配置
• npm config set registry https://registry.npm.taobao.org 更改 npm 鏡像
• npm owner ls <packageName> 查看依賴包權(quán)限所有者的名字
• npx <plugin> <pluginDrective> 使用其他包內(nèi)提供的命令行工具
• npm link 將正在調(diào)試的 npm 包鏈接到全局
  • npm link <packageName> 進(jìn)入到對應(yīng)項(xiàng)目目錄，link 想要使用的本地包名
  • npm unlink <packageName> 解除模塊的全局 link

清除緩存

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

常見問題

• windows 下安裝 npm install <packageName> 或 cnpm install <packageName> 沒反應(yīng)：把 c:/Users/,npmrc 是刪除試試
• npm install 時(shí)報(bào)錯(cuò)：mkdir access denied. 這種情況多發(fā)生在 git bash 環(huán)境里，要用管理員身份運(yùn)行 git bash。也可以一勞永逸在運(yùn)行的快捷方式中直接設(shè)置“用管理員身份運(yùn)行”（詳情）
• 同理，Mac下沒權(quán)限用 sudo npm install xxx
• npm link 后 cannot find modules，這個(gè)要注意有的包 npm link 直接在開發(fā)包根目錄執(zhí)行就可以，而有的包是編譯后新生成一個(gè)/dist 文件夾，要在 /dist 下執(zhí)行 npm link
• .npmrc 文件：一般項(xiàng)目根目錄有這個(gè)文件的話，npm config 會直接用這里的配置，如鏡像源地址

  registry=https://registry.npmmirror.com
  

常用插件

• cnpm：淘寶鏡像

  • 執(zhí)行 npm install -g cnpm --registry=https://registry.npm.taobao.org 全局安裝
  • 輸入 cnpm -v 檢驗(yàn)是否安裝成功

• npm-check-updates : 檢查插件更新，安裝插件

  • ncu - v （ncu 是 npm-check-updates 的縮寫命令）查看當(dāng)前各個(gè)安裝包的版本
  • 注：ncu 更新插件后，會自動(dòng)修改 package.json 里的版本號

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

  • nvm list available: 打印出 node released 各個(gè)版本
  • nvm use <version>: 指定要使用的 node 版本
  • nvm install <version>: 下載指定的 node 版本
  • 注意：
    1. 當(dāng) windows 在 git bash 中使用 nvm 版本切換的時(shí)候，提示切換成功，但實(shí)際上并沒切換成功；要在 CMD 中使用 nvm 進(jìn)行切換 。
    2. 每次重啟終端都要重新設(shè)置 nvm，使用 nvm alias default stable 固定版本

• npx npkill：刪除電腦某一磁盤下的 node_modules

  2. nvm 安裝并切換至新版本 node 時(shí)，報(bào)錯(cuò) npm command not found：可能是 nvm 安裝 node 時(shí)，npm下載失敗了；也有可能是 node v12.16.0 的坑，mac 下安裝這個(gè)版本的 node 時(shí)，npm 也出過問題。
  3. nvm 切換 node 版本后，會導(dǎo)致 npm 全局安裝過的包失效：解決方式
  4. (偶發(fā)) nvm 管理 node 版本升級到10以上后無法安裝 npm
  5. Mac全局安裝插件報(bào)錯(cuò)：Missing write access to /usr/local/lib/node_modules/webpack，使用sudo install -g pkgName@pkgVersion