文檔

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

安裝

npm 是 node 的包管理工具蕉饼，安裝 Node 時作彤，就會自動安裝 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安裝過某個插件
• 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> 查看依賴包權(quán)限所有者的名字
• npx <plugin> <pluginDrective> 使用其他包內(nèi)提供的命令行工具
• npm link 將正在調(diào)試的 npm 包鏈接到全局
  • npm link <packageName> 進入到對應(yī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 時報錯：mkdir access denied. 這種情況多發(fā)生在 git bash 環(huán)境里召调，要用管理員身份運行 git bash。也可以一勞永逸在運行的快捷方式中直接設(shè)置“用管理員身份運行”（詳情）
• 同理，Mac下沒權(quán)限用 sudo npm install xxx
• npm link 后 cannot find modules唠叛，這個要注意有的包 npm link 直接在開發(fā)包根目錄執(zhí)行就可以只嚣，而有的包是編譯后新生成一個/dist 文件夾，要在 /dist 下執(zhí)行 npm link
• .npmrc 文件：一般項目根目錄有這個文件的話艺沼，npm config 會直接用這里的配置册舞，如鏡像源地址

  registry=https://registry.npmmirror.com
  

常用插件

• cnpm：淘寶鏡像

  • 執(zhí)行 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. 每次重啟終端都要重新設(shè)置 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 版本后恋腕，會導(dǎo)致 npm 全局安裝過的包失效：解決方式
  4. (偶發(fā)) nvm 管理 node 版本升級到10以上后無法安裝 npm
  5. Mac全局安裝插件報錯：Missing write access to /usr/local/lib/node_modules/webpack，使用sudo install -g pkgName@pkgVersion