了解 npm 的環(huán)境變量能讓你更自如地控制和定制 npm 的行為。

下面我將為你介紹一些常用的 npm 環(huán)境變量及其用法，并提供一些使用上的建議。

npm 環(huán)境變量詳解與使用指南

常用 npm 環(huán)境變量概覽

下表匯總了一些常用的 npm 環(huán)境變量及其典型用途：

核心環(huán)境變量詳解

1.npm_config_*變量

npm 的運行行為可以通過 npm_config_ 開頭的環(huán)境變量進行配置。

設置方式與優(yōu)先級：npm 獲取配置的順序從高到低是：命令行標志 (Command Line Flags) > 環(huán)境變量 (Environment Variables) > npmrc 文件 > 默認配置。這意味著通過命令行參數(shù)設置的選項會覆蓋環(huán)境變量。

npm_config_cache：這個變量用于覆蓋 npm 默認的緩存目錄路徑。這在離線開發(fā)（你需要指定一個預先準備好的緩存目錄）或希望將緩存放到特定磁盤（如空間更大的數(shù)據盤或更快的 SSD）時非常有用。使用時通常需配合 --offline 參數(shù)：

# 臨時設置緩存目錄并啟用離線模式
npm_config_cache="/opt/offline-resources/npm-cache" npm install --offline --optional=false

npm_config_offline：將其設置為 true 會強制 npm 在離線模式下工作，僅使用本地緩存，不嘗試任何網絡連接。等同于在命令后添加 --offline 參數(shù)。

其他常用 npm_config_ 變量：

• npm_config_registry：設置 npm 包的下載源。
• npm_config_prefix：設置全局安裝的根目錄。

2.npm_package_*變量

npm 會自動將你項目的 package.json 文件中的字段轉換為以 npm_package_ 開頭的環(huán)境變量2。

例如，package.json 中的 name 和 version 字段可以通過 npm_package_name 和 npm_package_version 訪問。

這在 npm scripts 中非常有用，可以讓腳本動態(tài)地獲取項目信息：

{
  "scripts": {
    "echo:name": "echo $npm_package_name",
    "echo:version": "echo $npm_package_version",
    "archive:coverage": "mkdir -p coverage_archive/$npm_package_version && cp -r coverage/* coverage_archive/$npm_package_version/"
  }
}

3.NODE_PATH

這是一個由 Node.js 本身識別的環(huán)境變量，而非 npm 專屬。它用于告訴 Node.js 除了當前項目的 node_modules 之外，還在哪些額外的目錄中查找模塊。

注意：從 Node.js v6 開始，NODE_PATH 被視為過時 (deprecated)，因為 Node.js 的模塊解析算法已經非常完善。通常，更推薦使用項目本地的 node_modules 或通過 npm link 進行開發(fā)。但在一些遺留項目或特殊環(huán)境中可能仍會用到。

4. 其他實用變量

npm_lifecycle_event：表示當前正在執(zhí)行的 npm script 的名稱（例如 install, start, test等）。這在編寫復雜的腳本時，可以讓你根據正在運行的生命周期事件執(zhí)行不同的操作。

如何查看所有環(huán)境變量

要查看當前 npm 運行時可用的所有環(huán)境變量（這是一個很長的列表），可以在你的項目目錄下運行：

npm run env

如果你只想查看與當前 package.json 內容相關的變量，可以使用：

npm run env | grep npm_package

如何使用環(huán)境變量

在 npm scripts 中使用

在 package.json 的 scripts 字段中，你可以直接通過 $變量名（Unix-like系統(tǒng)）或 %變量名%（Windows）來引用環(huán)境變量：

{
  "scripts": {
    "dev": "NODE_ENV=development node app.js",
    "test": "echo \"Testing package: $npm_package_name@$npm_package_version\"",
    "serve:coverage": "http-server coverage_archive/$npm_package_version -p $npm_package_config_port"
  },
  "config": {
    "port": 3000
  }
}

上面的例子中，npm_package_config_port 來自于 package.json 中 config 對象下的 port 字段。

在命令行中臨時設置

你可以在執(zhí)行命令前臨時設置環(huán)境變量，這只對當前命令生效：

# Unix-like 系統(tǒng) (Linux, macOS)
npm_config_cache=/tmp/cache npm install

# Windows (Command Prompt)
set npm_config_cache=C:\temp\cache && npm install

# Windows (PowerShell)
$env:npm_config_cache='C:\temp\cache'; npm install

在系統(tǒng)中持久化設置

如果你希望某個環(huán)境變量永久生效，可以將其添加到你的 shell 配置文件中（如 ~/.bashrc, ~/.zshrc, ~/.bash_profile）：

# 將以下內容添加到 ~/.bashrc 或類似文件末尾
export npm_config_cache=/home/yourusername/.npm-offline-cache

然后運行 source ~/.bashrc 使其立即生效，或重新打開終端窗口。

也可以在系統(tǒng)的環(huán)境變量設置界面（Windows）或全局配置文件（如 ~/.npmrc）中進行設置。

重要注意事項

• 變量名大小寫：大多數(shù) npm_config_ 環(huán)境變量不區(qū)分大小寫，但為了清晰和一致性，通常使用小寫。NODE_PATH 等傳統(tǒng)環(huán)境變量通常大寫。
• 配置優(yōu)先級：記住命令行參數(shù) > 環(huán)境變量 > npmrc 文件的優(yōu)先級順序。如果你在多個地方設置了同一個配置，優(yōu)先級高的會覆蓋優(yōu)先級低的。
• 離線模式需緩存完整：使用 npm_config_offline=true 或 --offline 時，務必確保所有依賴包已經存在于緩存中，否則安裝會失敗。
• 緩存目錄權限：如果你自定義了 npm_config_cache 目錄，請確保運行 npm 的用戶對該目錄有讀寫權限。
• NODE_PATH 的過時性：如前所述，優(yōu)先使用項目本地的 node_modules，而不是依賴 NODE_PATH，除非你有非常特殊的理由。

總結

以上為個人經驗，希望能給大家一個參考，也希望大家多多支持腳本之家。