【整理分享】前端開發必備的npm 常用指令

前端（vue）入門到精通課程：進入學習

npm來源設置

• 查詢目前來源設定

npm get registry

• 設定淘寶鏡像來源（淘寶鏡像新網域）

npm config set registry https://registry.npmmirror.com

舊款http://npm.taobao.org 和http://registry.npm.taobao .org 網域將於2022 年05 月31日零時起停止服務。所以舊命令也不要使用了：
npm config set registry http://registry.npm.taobao.org

• 還原預設來源

npm config set registry https://registry.npmjs.org

• 使用nrm管理來源

# 全域安裝nrm
npm install -g nrm
# 查看nrm來源清單(支援預設來源，淘寶來源，騰訊來源等)
nrm ls
# 切換來源(鏡像來源的名稱nrm ls是可以看到的)
nrm use taobao

• 在項目根目錄增加.npmrc文件，內容淘寶鏡像位址：

registry = https://registry.npmmirror.com

安裝依賴

• 全域安裝

# 安裝最新版本npm install -g xxx
 # 安裝指定版本npm install -g [email protected]

• 本地安裝（目前資料夾）

npm install xxx

• 專案依賴安裝， 並寫入package.json的dependencies中：

npm install –S xxx 
# 和上面效果一樣，預設：
npm install xxx

• 項目依賴安裝，並寫入package.json的devDependencies中：

npm install –D xxx

• 指定版本號

npm install [email protected]

• 項目本次安裝依賴，暫時使用淘寶鏡像

npm install --registry=https: //registry.npmmirror.com

• 安裝某個依賴套件（下面指令指定了版本@1.0.0），暫時使用淘寶鏡像：

npm install [email protected] --registry=https://registry.npmmirror.com

卸載依賴

• 卸載

npm uninstall <package-name>

• 卸載，並在package.json中移除：
  使用-S 或--save 標誌，則此操作也會移除package.json 檔案中的參考；
  如果套件是開發依賴項（列出在package.json 檔案的devDependencies 中），則必須使用-D 或--save-dev 標誌從檔案中移除。

npm uninstall -S <package-name>
npm uninstall -D <package-name>

• 卸載全域依賴

npm uninstall -g <package-name>

• 提示
  uninstall的別名：remove, rm, r, un, unlink這些都是npm uninstall的別名。

npm uninstall -S <package-name>
# 等價npm remove -S <package-name>
# 等價npm rm -S <package-name>

更新

• 先檢查更新

npm outdated

紅顏色標記的就是可以更新的包，黃色標示不可更新的包。

• 執行更新(只會更新補丁版本或次版本，不會更新主版本)
  如果不清楚主次版本，下面有版本號說明，請下拉。

npm update

• 更新主版本

# 1.安裝"npm-check-updates"模組npm install -g npm-check-updates  
# 2.檢查可更新的模組ncu  
npm-check-updates  
# 以上兩個指令都可檢查可更新模組。接下來更新package.json的依賴套件到最新版本：  

#升級package.json 檔案的dependencies 和devDependencies 中的所有版本ncu -u  
#以上指令執行，更新全部模組。但在實際開發中不建議一次全部更新，可以根據實際需要，更新指定的模組，並且可以根據作用範圍在後面加上-D、-S 或-g

方式二：

# 全域安裝npm-check
npm install -g npm-check
# 查看可更新的依賴npm-check
# 更新依賴npm-check -u

# 更新主版本的另一種方式就是先卸載，再重新安裝# 卸載npm uninstall xxx
# 重新安裝-最新版本npm install xxx
# 重新安裝-制定版本npm install [email protected]

查看

• 查看npm版本

npm -v

• 查看已安裝的套件版本
  

npm 套件名稱-v

• 查看npm幫助

npm help

• 查看npm使用的所有資料夾

npm help folders

• 檢視模組清單（查看本機已安裝模組的清單清單）

npm list
# 也可以使用縮寫ls
npm ls

• 查看全域安裝的套件

npm list -g --depth 0

• 查看某個套件的版本

npm list vue-cli

• 查看node模組的package.json資料夾

npm view moduleNames

• 檢視套件的依賴關係

npm view moudleName dependencies

• 檢視套件的來源檔案位址

npm view moduleName repository.url

• 檢視套件所依賴的Node的版本

npm view moduleName engines

• 查看目前套件的安裝路徑

npm root

• 檢視全域套件的安裝路徑

npm root -g

• 檢查套件是否已經過時

  此指令會列出所有已經過時的套件，可以及時進行套件的更新

npm outdated

• 存取npm的json資料夾

  一個npm套件是包含了package.json的資料夾，package.json描述了這個資料夾的結構。造訪npm的json資料夾的方法如下

npm help json

此指令會以預設的方式開啟一個網頁，如果變更了預設開啟程式則可能不會以網頁的形式開啟。

• 檢驗套件名稱是否已存在

  發佈一個npm套件的時候，需要檢驗某個套件名稱是否已存在

npm search packageName

# 也可以使用縮寫s 來取代search 
npm s packageName

npm 其他指令

npm cache clean # 清除npm的快取npm prune # 清除專案中沒有被使用的套件npm outdated # 檢查模組是否過時npm repo jquery # 會開啟預設瀏覽器跳到github中jquery的頁面npm docs jquery # 會開啟預設瀏覽器跳到github中jquery的頁面npm docs jquery # 會開啟預設瀏覽器跳到github中jquery的README.MD檔案資訊npm home jquery # 會開啟預設瀏覽器跳到github中jquery的主頁

npm依賴套件版本號

npm 版本號形式XYZ

表示：主版號.次版本號.修訂號，版本號遞增規則如下：

• X. 主版本號：當你做了不相容的API 修改，

• Y. 次版本號：當你做了向下相容的功能性新增，

• Z. 修訂號：當你做了向下相容的問題修正。

依賴函式庫版本號、符號

• 沒有任何符號

1.0.0
完全百分百匹配，當前庫/項目必須使用當前版本號，如果和其他依賴使用了相同庫不同版本，會在庫的資料夾下建立一個node_modules 資料夾存放它需要依賴的版本文件。

• ~號

不改變主版本號和次版本號，修訂號可以隨意更改例如~2.0.0 ，可以使用2.0.0、2.0.2 、2.0.9 的版本。

• ^號

不改變主版本號（主版號非0），此版本號和修訂號可以隨意更改例如^2.0.0 ，可以使用2.0.1、2.2.2 、2.9.9 的版本。

• *號

*表示任意版本對版本沒有限制， 一般不用"base": "*"

• >號碼

大於某個版本，表示只要大於這個版本的安裝包都行例如："node": "> 4.0.0"

• > =號

大於某個版本，表示只要大於或等於這個版本的安裝包都行例如："node": ">= 4.0.0"

• <號

小於某個版本，表示只要小於這個版本的安裝包都行例如："http-proxy-middleware": "<0.17.3"

• <=號碼

小於或等於某個版本，表示只要小於或等於這個版本的安裝套件都行例如："http-proxy-middleware": "<= 0.17.3"

• -號

-表示兩個版本號之間的版本"base": "1.0.1-1.5.9"
例如1.0.1-1.5.9 可以使用1.0.1到1.5.9之間的任意版本