npm install 完全可以安裝離線包，但這需要你提前做好充分的準備工作。這是企業(yè)內(nèi)網(wǎng)開發(fā)、構建安全環(huán)境（air-gapped environments）和確保依賴穩(wěn)定性的核心技能。

核心原理是：

讓 npm 繞過網(wǎng)絡請求，直接從本地緩存或指定的本地文件/目錄中獲取包。

以下是幾種不同的離線安裝方法，每種方法適用于不同的場景：

方法一：使用 npm 的離線緩存（最常用、最推薦）

這是最標準的離線安裝方式。它利用了 npm 自身的緩存機制。

工作原理

• 在線準備：在一臺有網(wǎng)絡的機器上，運行 npm install 將所有依賴（包括子依賴）完整地下載到 npm 的全局緩存目錄（~/.npm）中。
• 轉(zhuǎn)移緩存：將整個緩存目錄打包，復制到離線機器上。
• 離線安裝：在離線機器上，通過環(huán)境變量指向這個準備好的緩存目錄，并使用 --offline 參數(shù)安裝。

詳細步驟

在線環(huán)境準備緩存：

# 1. 在聯(lián)網(wǎng)機器上，進入項目目錄，正常安裝所有依賴
cd my-project
npm install

# 2. 此時所有包的.tgz文件都已存儲在 ~/.npm 目錄中
# 3. 將整個 ~/.npm 緩存目錄打包拷貝到離線環(huán)境
tar -czf npm-cache.tar.gz ~/.npm

離線環(huán)境安裝：

# 1. 將打包的緩存文件解壓到離線機器的某個目錄，例如 /path/to/offline-cache/
tar -xzf npm-cache.tar.gz -C /path/to/offline-cache/

# 2. 設置環(huán)境變量，讓npm使用這個準備好的緩存
export npm_config_cache="/path/to/offline-cache/.npm"

# 3. 強制npm使用離線模式進行安裝
npm install --offline

• 優(yōu)點：能處理復雜的依賴樹，是管理整個項目依賴的最佳實踐。
• 缺點：需要提前準備整個緩存目錄，可能會很大。

方法二：直接安裝本地.tgz包文件

如果你只有一個單獨的離線包文件（.tgz 格式），可以直接安裝它。

操作步驟

# 在聯(lián)網(wǎng)機器上，打包某個包
npm pack electron
# 這會生成一個類似 electron-28.0.0.tgz 的文件

如何獲取 .tgz 文件？

從 npm registry 官網(wǎng)下載。

使用 npm pack 命令打包一個你已經(jīng)有的包：

# 在聯(lián)網(wǎng)機器上，打包某個包
npm pack electron
# 這會生成一個類似 electron-28.0.0.tgz 的文件

• 優(yōu)點：非常簡單直接，適合安裝單個獨立的包。
• 缺點：無法自動處理這個包所依賴的其他包。如果這個 .tgz 包有依賴，而你的離線環(huán)境沒有，安裝會失敗。

方法三：從本地文件系統(tǒng)鏈接（file:協(xié)議）

你可以將依賴包放在一個本地文件夾中（比如一個U盤或內(nèi)網(wǎng)文件共享），然后在 package.json 中直接指向它。

操作步驟

準備離線包目錄：在離線環(huán)境中，創(chuàng)建一個目錄（如 ./offline-packages/）存放所有你需要的包的 .tgz 文件。

修改 package.json：將依賴的版本號改為 file: 協(xié)議路徑。

{
  "dependencies": {
    "electron": "file:./offline-packages/electron-v28.0.0.tgz",
    "lodash": "file:./offline-packages/lodash-4.17.21.tgz"
  }
}

運行安裝：

npm install

• 優(yōu)點：配置清晰，版本管理方便。
• 缺點：需要手動管理 package.json 中的路徑，同樣可能無法處理嵌套依賴。

方法四：搭建離線鏡像倉庫（最專業(yè)）

對于大型團隊或企業(yè)，最徹底的方法是搭建一個內(nèi)網(wǎng)專用的 npm 鏡像倉庫。

常用工具：Verdaccio、nexus Repository Manager

工作流程：

• 在可聯(lián)網(wǎng)的機器上搭建 Verdaccio。
• 通過 Verdaccio 代理所有 npm 請求，它會自動緩存所有下載過的包。
• 將這臺機器上的 Verdaccio 存儲目錄打包，遷移到離線網(wǎng)絡。
• 在離線網(wǎng)絡中的機器上配置 npm registry 指向內(nèi)網(wǎng)的 Verdaccio 地址（如 http://internal-ip:4873/）。
• 此后，所有 npm install 命令都會從這個內(nèi)網(wǎng)鏡像獲取包。

優(yōu)點：對開發(fā)者最透明，體驗與聯(lián)網(wǎng)幾乎無異，能完美處理所有依賴。

缺點：搭建和維護有一定復雜度。

重要注意事項總結

1.處理嵌套依賴：方法一（緩存）和方法四（鏡像）是唯一能自動處理嵌套依賴的方法。方法二和方法三需要你手動下載所有子依賴的包，非常繁瑣。

2.Electron 等二進制包：對于像 electron 這樣包含平臺特定二進制文件的包，離線安裝需要額外步驟。除了 npm 緩存，你還需要：

• 提前下載好對應平臺的 Electron .zip 文件。
• 設置 ELECTRON_MIRROR 或 ELECTRON_OVERRIDE_DIST_PATH 環(huán)境變量來指向這些文件的存放位置。否則，安裝腳本依然會嘗試聯(lián)網(wǎng)下載二進制文件而導致失敗。

3.版本一致性：離線環(huán)境下，必須嚴格保證你準備的離線包版本與 package.json 中要求的版本完全匹配，否則安裝會失敗。

結論

答案是肯定的，npm install 能安裝離線包。 

其中，使用 --offline 參數(shù)并配合準備好的 npm 緩存目錄（方法一） 是最通用、最可靠的方式，適用于絕大多數(shù)項目離線部署的場景。

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

最新評論