6 npm（JavaScript 套件管理員）概述

---

---

6.1 npm 套件管理員

npm 註冊中心是託管 JavaScript 套件的實際標準。這些套件具有特定格式，稱為npm 套件。

因此，在 JavaScript 生態系統中，套件管理員是一個用於安裝 npm 套件的命令列工具，這些套件來自 npm 註冊中心或其他來源。

最受歡迎的套件管理員稱為npm，並與 Node.js 捆綁在一起。它的名稱最初代表「Node 套件管理員」。後來，當 npm 和 npm 註冊中心不僅用於 Node.js 套件時，定義被更改為「npm 不是套件管理員」（來源）。

還有其他流行的套件管理員，例如 yarn 和 pnpm。所有這些套件管理員預設使用 npm 註冊中心。

我們透過 shell 指令 npm 使用 npm，它提供多個子指令，例如 npm install。

6.2 取得 npm 說明

6.2.1 取得命令列說明

我們可以使用 npm 指令來解釋其本身：一方面，有選項 -h，可以在 npm 和 npm 指令後使用。它提供簡短的說明

npm -h        # brief explanation of `npm`
npm <cmd> -h  # brief explanation of `npm <cmd>`

另一方面，有指令 npm help，它提供較長的說明

npm help         # brief explanation of `npm` (same as `npm -h`)
npm help npm     # longer explanation of `npm`
npm help <cmd>   # longer explanation of `npm <cmd>`
npm help <topic> # longer explanation of <topic>

說明主題包括

• 資料夾
• npmrc
• package.json

6.2.2 取得線上說明

官方 npm 文件也可在線上取得。

6.3 常見的 npm 指令

以下是幾個常見的指令

• npm init 將目前目錄「初始化」為一個套件。亦即，它會在其中建立檔案 package.json。此指令在 §14.3.1「設定套件的目錄」 中說明。

• npm install 全域或區域安裝 npm 套件。它在 §13「安裝 npm 套件和執行 bin 腳本」 中說明。

• npm publish 將套件發佈至註冊表：它會建立新的套件或更新現有的套件。在 §14.5.3 “npm publish：將套件上傳至 npm 註冊表” 中有說明。

• npm run（為 npm run-script 的簡寫）執行套件腳本。套件腳本在 §15 “透過 npm 套件腳本執行跨平台任務” 中有說明。

• npm uninstall 移除了已安裝為全域或本地的套件。

• npm version 印出物件 process.versions，其中記錄了 Node.js 和 npm 的各種元件版本。

  {
    'my-package': '1.0.0', // current package
    npm: '8.15.0',
    node: '18.7.0',
    v8: '10.2.154.13-node.9',
    uv: '1.43.0', // libuv
    ···
    tz: '2022a', // version of tz database
    unicode: '14.0', // version of Unicode standard
    ···
  }

• npx 讓我們在不安裝的情況下執行套件中的 bin 腳本。在 §13.4 “npx：在不安裝的情況下執行 npm 套件中的 bin 腳本” 中有說明。

npm 文件中有 所有 npm 指令的清單。

6.4 npm 指令的縮寫

許多 npm 指令都有縮寫，例如

簡寫	完整指令
npm i	npm install
npm rm	npm uninstall
npm run	npm run-script

對於每個 npm 指令，npm 文件 也會列出其所有別名（包括縮寫）。