Node 包管理器 (npm) 為 Web 開發(fā)人員提供了許多便捷的 JavaScript 模塊，極大地簡化了應(yīng)用程序依賴項的查找和管理。它也方便開發(fā)者創(chuàng)建和發(fā)布自己的模塊，其他開發(fā)者只需使用 npm install -g your-tool 即可輕松獲取并使用。聽起來很完美，對吧？

呃，其實……并非如此。

關(guān)鍵要點(diǎn)

• 過度使用 -g 選項安裝 npm 模塊會導(dǎo)致問題，因為即使項目依賴于全局模塊，這些模塊也不會列為項目的依賴項。這會增加其他使用該應(yīng)用程序的人員的工作量，并可能導(dǎo)致版本沖突。
• 為避免全局 npm 模塊依賴項帶來的問題，建議在安裝模塊時移除 -g，并替換為 --save-dev。這會將模塊保存為開發(fā)依賴項，并確保在運(yùn)行 npm install 時安裝它。
• 在本地安裝依賴項后，任何打算從命令行運(yùn)行的腳本都將放置在 ./node_modules/.bin/ 目錄下。使用 npm 腳本可以簡化此過程，并允許使用較短的命令運(yùn)行模塊的本地版本。
• 雖然可能有點(diǎn)多余，但建議將 Node 和 npm 作為項目的依賴項，并將其本地安裝到項目中。但是，這可能很復(fù)雜，因為 Node 在每個操作系統(tǒng)上都不相同，而且沒有簡單的方法可以保證每個人都將 Node 和 npm 的本地副本路徑添加到他們的 PATH 環(huán)境變量中。

我們遇到了一些問題

我不會說永遠(yuǎn)不要使用 -g 選項安裝 npm 模塊，但我必須說，過度使用它會導(dǎo)致問題。我認(rèn)為我們應(yīng)該減少使用全局模塊安裝，尤其是在構(gòu)建、測試或代碼檢查工具（如 Gulp、Karma、JSHint 等）的情況下，原因如下：本文主要討論 Gulp，因為它非常流行，而且讀起來朗朗上口，但如果您不喜歡 Gulp，只需在腦海中將其替換為您喜歡的任何工具即可。

首先，全局模塊不會列為項目的依賴項，即使您的項目依賴于它們，這也會增加其他使用您的應(yīng)用程序的人員的工作量。您知道需要使用 Gulp 來準(zhǔn)備項目的生產(chǎn)環(huán)境，因此您全局安裝并使用它。當(dāng)其他人想要開始使用或處理您優(yōu)秀的開源項目時，他們不能只鍵入 npm install 然后開始工作。您最終需要在 README 文件中添加說明，例如：

要使用此項目，請按照以下步驟操作：

• git clone 倉庫
• 運(yùn)行 npm install
• 運(yùn)行 npm install -g gulp
• 運(yùn)行 gulp 進(jìn)行構(gòu)建

我看到了兩個問題：首先，您增加了全局安裝 Gulp 的額外步驟；其次，您直接運(yùn)行 gulp。我看到一個本可以避免的額外步驟（全局安裝 Gulp），并且我看到用戶需要知道您的應(yīng)用程序使用 Gulp 來構(gòu)建項目。本文主要討論第一個問題，雖然第二個問題不是那么嚴(yán)重，但如果您最終切換工具，則需要更新說明。稍后我將討論的解決方案應(yīng)該可以解決這兩個問題。

與全局安裝模塊相關(guān)的第二個主要問題是，由于安裝了錯誤的模塊版本，您可能會遇到?jīng)_突。以下兩個示例說明了這一點(diǎn)：

• 您六個月前創(chuàng)建了您的項目，當(dāng)時您使用了最新版本的 Gulp。今天，有人克隆了您的項目的倉庫并嘗試運(yùn)行 gulp 來構(gòu)建它，但遇到了錯誤。這是因為克隆您項目的人正在運(yùn)行較舊版本的 Gulp 或具有某些重大差異的較新版本的 Gulp。
• 您六個月前創(chuàng)建了一個使用 Gulp 的項目。從那時起，您轉(zhuǎn)到了其他項目并在您的機(jī)器上更新了 Gulp?，F(xiàn)在您回到這個舊項目并嘗試運(yùn)行 gulp，您會遇到錯誤，因為自從上次接觸該項目以來您已經(jīng)更新了 Gulp?，F(xiàn)在，您被迫更新構(gòu)建過程以與新版本的 Gulp 一起使用，然后才能在項目上取得更多進(jìn)展，而不是將其推遲到更方便的時間。

這些問題都可能非常嚴(yán)重。但是，正如我之前所說，我不會籠統(tǒng)地說永遠(yuǎn)不要全局安裝某些東西。有些例外情況。

關(guān)于安全性的簡短說明

默認(rèn)情況下，在某些系統(tǒng)上，全局安裝 npm 模塊需要提升的權(quán)限。如果您發(fā)現(xiàn)自己正在運(yùn)行類似 sudo npm install -g a-package 的命令，則應(yīng)更改此命令。我們的 npm 初學(xué)者指南將向您展示如何操作。

例外情況

那么，您可以全局安裝什么呢？簡而言之：任何您的項目不依賴的東西。例如，我安裝了一個名為 local-web-server 的全局模塊。每當(dāng)我只需要查看瀏覽器中的一些 HTML 文件時，我都會運(yùn)行 ws（這是 local-web-server 的命令），它會將當(dāng)前文件夾設(shè)置為 localhost:8000 的根目錄，然后我可以在瀏覽器中打開那里的任何文檔并對其進(jìn)行測試。

我還遇到過想要壓縮不屬于項目一部分的 JavaScript 文件的情況，或者至少不屬于允許我設(shè)置正式構(gòu)建過程的項目的情況（出于愚蠢的“公司”原因）。為此，我安裝了 uglify-js，我可以輕松地在幾秒鐘內(nèi)從命令行壓縮任何腳本。

解決方案

既然我們知道問題可能出現(xiàn)在哪里，我們該如何預(yù)防呢？您需要做的第一件事是在安裝模塊時移除 -g。您應(yīng)該將其替換為 --save-dev，以便您可以將模塊保存為開發(fā)依賴項，并且在有人運(yùn)行 npm install 時始終會安裝它。這只會解決我前面提到的一個次要問題，但這只是一個開始。

您需要知道的是，當(dāng)您在本地安裝依賴項時，如果它有任何打算從命令行運(yùn)行的腳本，它們將被放置在 ./node_modules/.bin/ 目錄中。因此，現(xiàn)在，如果您只是在本地安裝 Gulp，您可以通過在命令行中鍵入 ./node_modules/.bin/gulp 來運(yùn)行它。當(dāng)然，沒有人想輸入所有這些內(nèi)容。您可以使用 npm 腳本解決此問題。

在您的 package.json 文件中，您可以添加一個類似于以下內(nèi)容的 scripts 屬性：

{
    ...
    "scripts": {
        "gulp": "gulp"
    }
}

現(xiàn)在，您可以隨時運(yùn)行 npm run gulp 來運(yùn)行 Gulp 的本地版本。npm 腳本會在檢查 PATH 環(huán)境變量之前查找 ./node_modules/.bin/ 目錄中可執(zhí)行命令的本地副本。如果需要，您甚至可以通過在這些參數(shù)之前添加 -- 來將其他參數(shù)傳遞給 Gulp，例如 npm run gulp -- build-dev 等效于 gulp build-dev。

您仍然需要鍵入比全局使用 Gulp 更多的內(nèi)容，但這很糟糕，但有兩種方法可以解決這個問題。第一種方法（也解決了前面提到的一個問題）是使用 npm 腳本創(chuàng)建別名。例如，您不一定要將您的應(yīng)用程序綁定到 Gulp，因此您可以創(chuàng)建運(yùn)行 Gulp 但不提及 Gulp 的腳本：

{
    ...
    "scripts": {
        "build": "gulp build-prod",
        "develop": "gulp build-dev"
    }
}

這樣，您可以使對 Gulp 的調(diào)用更短，并且可以使您的腳本保持通用性。通過保持通用性，您可以隨時透明地刪除 Gulp 并將其替換為其他內(nèi)容，而沒有人需要知道（除非他們處理構(gòu)建過程，在這種情況下，他們應(yīng)該已經(jīng)知道它，并且可能應(yīng)該參與遷移離開 Gulp 的討論）?；蛘?，您甚至可以在其中添加一個 postinstall 腳本，以便在有人運(yùn)行 npm install 后立即自動運(yùn)行構(gòu)建過程。這將大大簡化您的 README 文件。此外，通過使用 npm 腳本，任何克隆您項目的人都應(yīng)該在 package.json 文件中直接獲得關(guān)于您在項目上運(yùn)行的所有過程的簡單且直接的文檔。

除了使用 npm 腳本外，還有另一個技巧可以讓您使用命令行工具的本地安裝：相對 PATH。我將 ./node_modules/.bin/ 添加到我的 PATH 環(huán)境變量中，因此只要我在項目的根目錄中，我就可以通過鍵入命令的名稱來訪問命令工具。我從我寫的另一篇文章的評論中學(xué)到了這個技巧（感謝 Gabriel Falkenberg）。

這些技巧不能完全替代您想要使用 Gulp 等工具的每種情況，它們確實需要一些工作才能設(shè)置，但我確實認(rèn)為將這些工具列為您的依賴項應(yīng)該是一種最佳實踐。這將防止版本沖突（這首先是依賴項管理器的主要原因之一），并將有助于簡化其他人獲取您的項目所需的步驟。

更進(jìn)一步

這可能有點(diǎn)多余，但我認(rèn)為 Node 和 npm 也是您的項目的依賴項，它們有幾個不同的版本可能會沖突。如果您想確保您的應(yīng)用程序?qū)γ總€人都有效，那么您需要某種方法來確保用戶也安裝了正確的 Node 和 npm 版本。

您可以將 Node 和 npm 的本地副本安裝到您的項目中！但這并不能解決所有問題。首先，Node 在每個操作系統(tǒng)上都不相同，因此每個人仍然需要確保他們下載與他們的操作系統(tǒng)兼容的版本。其次，即使有一種方法可以安裝通用的 Node，您也需要確保每個人都有一個簡單的方法可以從他們的命令行訪問 Node 和 npm，例如確保每個人都將 Node 和 npm 本地副本的路徑添加到他們的 PATH 環(huán)境變量中。沒有簡單的方法可以保證這一點(diǎn)。

因此，盡管我很想能夠為每個項目強(qiáng)制執(zhí)行特定版本的 Node 和 npm，但我無法想到一個好的方法來做到這一點(diǎn)。如果您認(rèn)為這是一個好主意并想出了一個好的解決方案，請在評論中告訴我們所有人。我很想看到一個足夠簡單的解決方案，讓這成為一種標(biāo)準(zhǔn)做法！

結(jié)語

我希望您現(xiàn)在能夠理解將工具列為項目的版本化依賴項的重要性。我還希望您愿意為在您自己的項目中實施這些實踐而付出努力，以便我們可以將這些實踐作為標(biāo)準(zhǔn)推廣。除非您有更好的主意，否則請說出來，讓全世界都知道！

關(guān)于全局 NPM 模塊依賴項問題的常見問題解答 (FAQ)

什么是全局 NPM 模塊依賴項問題？

全局 NPM 模塊依賴項問題是開發(fā)人員在全局安裝 Node.js 包時遇到的一個常見問題。當(dāng)安裝的全局包無法訪問其本地安裝的依賴項時，就會出現(xiàn)此問題。這會導(dǎo)致應(yīng)用程序功能出現(xiàn)錯誤和問題。該問題是由于 Node.js 處理模塊解析的方式造成的，這對于開發(fā)人員來說可能非常復(fù)雜和令人困惑。

如何解決全局 NPM 模塊依賴項問題？

有幾種方法可以解決全局 NPM 模塊依賴項問題。最有效的方法之一是本地安裝包，而不是全局安裝。這確保了該包可以訪問其所有依賴項。另一種方法是使用 npm link 命令，它會在全局包及其本地依賴項之間創(chuàng)建一個符號鏈接。這允許全局包訪問其依賴項，就像它們?nèi)职惭b一樣。

全局和本地安裝 Node.js 包有什么區(qū)別？

全局安裝 Node.js 包時，它會安裝在您系統(tǒng)的中央位置，所有 Node.js 應(yīng)用程序都可以訪問它。另一方面，當(dāng)您本地安裝包時，它會安裝在您當(dāng)前項目的 node_modules 目錄中，并且只有該項目可以訪問它。雖然全局安裝很方便，但它可能會導(dǎo)致全局 NPM 模塊依賴項問題。

什么是 npm link 命令以及它是如何工作的？

npm link 命令是由 npm 提供的工具，用于在全局包及其本地依賴項之間創(chuàng)建符號鏈接。當(dāng)您在包的目錄中運(yùn)行 npm link 時，它會從全局 node_modules 目錄到本地包創(chuàng)建一個符號鏈接。這允許全局包訪問其依賴項，就像它們?nèi)职惭b一樣。

為什么會發(fā)生全局 NPM 模塊依賴項問題？

全局 NPM 模塊依賴項問題是由于 Node.js 處理模塊解析的方式造成的。當(dāng)全局安裝包時，Node.js 會在全局 node_modules 目錄中查找其依賴項。但是，如果依賴項是本地安裝的，Node.js 則找不到它們，從而導(dǎo)致全局 NPM 模塊依賴項問題。

我能否通過始終本地安裝包來避免全局 NPM 模塊依賴項問題？

是的，避免全局 NPM 模塊依賴項問題最有效的方法之一是始終本地安裝包。這確保了這些包可以訪問其所有依賴項。但是，這可能并不總是實用或方便，特別是如果您需要在多個項目中使用該包時。

有什么工具或包可以幫助我管理我的 Node.js 依賴項？

是的，有幾個工具和包可以幫助您管理您的 Node.js 依賴項。例如，npm 本身提供了幾個命令，例如 npm install、npm update 和 npm outdated，可以幫助您管理您的依賴項。還有 Yarn 和 Greenkeeper 等第三方工具，它們提供了額外的功能。

不解決全局 NPM 模塊依賴項問題有哪些風(fēng)險？

如果不解決全局 NPM 模塊依賴項問題，可能會導(dǎo)致應(yīng)用程序功能出現(xiàn)錯誤和問題。它還會使管理和更新依賴項變得困難，從而導(dǎo)致潛在的安全風(fēng)險和過時的包。

全局 NPM 模塊依賴項問題會影響我的應(yīng)用程序的性能嗎？

是的，全局 NPM 模塊依賴項問題可能會影響應(yīng)用程序的性能。如果包無法訪問其依賴項，則它可能無法正?；蛴行У剡\(yùn)行。這可能會導(dǎo)致應(yīng)用程序出現(xiàn)性能問題和錯誤。

如何檢查包是全局安裝還是本地安裝？

您可以使用 npm list 命令檢查包是全局安裝還是本地安裝。如果您運(yùn)行 npm list -g，它將顯示所有全局安裝的包。如果您在項目的目錄中運(yùn)行 npm list，它將顯示該項目本地安裝的所有包。

以上是如何解決全局NPM模塊依賴性問題的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！