如何使用 npm 管理 NodeJS 包 | Linux 中國

這將在專案的根目錄中建立一個名為 node_modules 的目錄（如果它不存在的話），併在其中下載包。

讓我們檢查 pachage.json 檔案。

$ cat package.json 
{
 "name": "demo",
 "version": "1.0.0",
 "description": "demo nodejs app",
 "main": "index.js",
 "scripts": {
 "test": "echo \"Error: no test specified\" && exit 1"
 },
 "author": "",
 "license": "ISC",
 "dependencies": {
 "commander": "^2.13.0"
 }
}

你會看到添加了依賴檔案，版本號前面的插入符號 ( ^ ) 表示在安裝時，npm 將取出它可以找到的最高版本的包。

$ ls node_modules/
commander

package.json 檔案的優點是，如果你的專案目錄中有 package.json 檔案，只需鍵入 npm install，那麼 npm 將檢視檔案中列出的依賴關係並下載它們。你甚至可以與其他開發人員共享它或將其推送到你的 GitHub 倉庫。因此，當他們鍵入 npm install 時，他們將獲得你擁有的所有相同的包。

你也可能會註意到另一個名為 package-lock.json 的檔案，該檔案確保在專案安裝的所有系統上都保持相同的依賴關係。

要在你的程式中使用已安裝的包，使用實際程式碼在專案目錄中建立一個 index.js（或者其他任何名稱）檔案，然後使用以下命令執行它：

$ node index.js

在全域性安裝包

如果你想使用一個包作為命令列工具，那麼最好在全域性安裝它。這樣，無論你的當前目錄是哪個目錄，它都能正常工作。

$ npm install async -g
+ async@2.6.0
added 2 packages in 4.695s

或者

$ npm install async --global

要安裝特定版本的包，我們可以：

$ npm install async@2.6.0 --global

更新 NodeJS 模組

要更新本地包，轉到 package.json 所在的專案目錄並執行：

$ npm update

然後，執行以下命令確保所有包都更新了。

$ npm outdated

如果沒有需要更新的，那麼它傳回空。

要找出哪一個全域性包需要更新，執行：

$ npm outdated -g --depth=0

如果沒有輸出，意味著所有包都已更新。

更新單個全域性包，執行：

$ npm update -g <package-name>

更新所有的全域性包，執行：

$ npm update -g

列出 NodeJS 模組

列出本地包，轉到專案目錄並執行：

$ npm list
demo@1.0.0 /home/sk/demo
└── commander@2.13.0

如你所見，我在本地安裝了 commander 這個包。

要列出全域性包，從任何位置都可以執行以下命令：

$ npm list -g

示例輸出：

/home/sk/.nvm/versions/node/v9.4.0/lib
├─┬ async@2.6.0
│ └── lodash@4.17.4
└─┬ npm@5.6.0
 ├── abbrev@1.1.1
 ├── ansi-regex@3.0.0
 ├── ansicolors@0.3.2
 ├── ansistyles@0.1.3
 ├── aproba@1.2.0
 ├── archy@1.0.0
[...]

該命令將列出所有模組及其依賴關係。

要僅僅列出頂級模組，使用 -depth=0 選項：

$ npm list -g --depth=0
/home/sk/.nvm/versions/node/v9.4.0/lib
├── async@2.6.0
└── npm@5.6.0

尋找 NodeJS 模組

要搜尋一個模組，使用 npm search 命令：

npm search <search-string>

例如：

$ npm search request

該命令將顯示包含搜尋字串 request 的所有模組。

移除 NodeJS 模組

要刪除本地包，轉到專案目錄並執行以下命令，這會從 node_modules 目錄中刪除包：

$ npm uninstall <package-name>

要從 package.json 檔案中的依賴關係中刪除它，使用如下所示的 save 選項：

$ npm uninstall --save <package-name>

要刪除已安裝的全域性包，執行：

$ npm uninstall -g <package>

清除 npm 快取

預設情況下，npm 在安裝包時，會將其副本儲存在 $HOME 目錄中名為 .npm 的快取檔案夾中。所以，你可以在下次安裝時不必再次下載。

檢視快取模組：

$ ls ~/.npm

隨著時間的推移，快取檔案夾會充斥著大量舊的包。所以不時清理快取會好一些。

從 npm@5 開始，npm 快取可以從 corruption 問題中自行修複，並且保證從快取中提取的資料有效。如果你想確保一切都一致，執行：

$ npm cache verify

清除整個快取，執行：

$ npm cache clean --force

檢視 npm 配置

要檢視 npm 配置，鍵入：

$ npm config list

或者：

$ npm config ls

示例輸出：

; cli configs
metrics-registry = "https://registry.npmjs.org/"
scope = ""
user-agent = "npm/5.6.0 node/v9.4.0 linux x64"
; node bin location = /home/sk/.nvm/versions/node/v9.4.0/bin/node
; cwd = /home/sk
; HOME = /home/sk
; "npm config ls -l" to show all defaults.

$ npm config get prefix
/home/sk/.nvm/versions/node/v9.4.0