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

呃，其實(shí)……並非如此。

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

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

我們遇到了一些問(wèn)題

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

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

要使用此項(xiàng)目，請(qǐng)按照以下步驟操作：

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

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

與全局安裝模塊相關(guān)的第二個(gè)主要問(wèn)題是，由於安裝了錯(cuò)誤的模塊版本，您可能會(huì)遇到衝突。以下兩個(gè)示例說(shuō)明了這一點(diǎn)：

• 您六個(gè)月前創(chuàng)建了您的項(xiàng)目，當(dāng)時(shí)您使用了最新版本的 Gulp。今天，有人克隆了您的項(xiàng)目的倉(cāng)庫(kù)並嘗試運(yùn)行 gulp 來(lái)構(gòu)建它，但遇到了錯(cuò)誤。這是因?yàn)榭寺∧?xiàng)目的人正在運(yùn)行較舊版本的 Gulp 或具有某些重大差異的較新版本的 Gulp。
• 您六個(gè)月前創(chuàng)建了一個(gè)使用 Gulp 的項(xiàng)目。從那時(shí)起，您轉(zhuǎn)到了其他項(xiàng)目並在您的機(jī)器上更新了 Gulp。現(xiàn)在您回到這個(gè)舊項(xiàng)目並嘗試運(yùn)行 gulp，您會(huì)遇到錯(cuò)誤，因?yàn)樽詮纳洗谓佑|該項(xiàng)目以來(lái)您已經(jīng)更新了 Gulp。現(xiàn)在，您被迫更新構(gòu)建過(guò)程以與新版本的 Gulp 一起使用，然後才能在項(xiàng)目上取得更多進(jìn)展，而不是將其推遲到更方便的時(shí)間。

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

關(guān)於安全性的簡(jiǎn)短說(shuō)明

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

例外情況

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

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

解決方案

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

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

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

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

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

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

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

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

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

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

更進(jìn)一步

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

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

因此，儘管我很想能夠?yàn)槊總€(gè)項(xiàng)目強(qiáng)制執(zhí)行特定版本的 Node 和 npm，但我無(wú)法想到一個(gè)好的方法來(lái)做到這一點(diǎn)。如果您認(rèn)為這是一個(gè)好主意並想出了一個(gè)好的解決方案，請(qǐng)?jiān)谠u(píng)論中告訴我們所有人。我很想看到一個(gè)足夠簡(jiǎn)單的解決方案，讓這成為一種標(biāo)準(zhǔn)做法！

結(jié)語(yǔ)

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

關(guān)於全局 NPM 模塊依賴項(xiàng)問(wèn)題的常見(jiàn)問(wèn)題解答 (FAQ)

什麼是全局 NPM 模塊依賴項(xiàng)問(wèn)題？

全局 NPM 模塊依賴項(xiàng)問(wèn)題是開(kāi)發(fā)人員在全局安裝 Node.js 包時(shí)遇到的一個(gè)常見(jiàn)問(wèn)題。當(dāng)安裝的全局包無(wú)法訪問(wèn)其本地安裝的依賴項(xiàng)時(shí)，就會(huì)出現(xiàn)此問(wèn)題。這會(huì)導(dǎo)致應(yīng)用程序功能出現(xiàn)錯(cuò)誤和問(wèn)題。該問(wèn)題是由於 Node.js 處理模塊解析的方式造成的，這對(duì)於開(kāi)發(fā)人員來(lái)說(shuō)可能非常複雜和令人困惑。

如何解決全局 NPM 模塊依賴項(xiàng)問(wèn)題？

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

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

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

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

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

為什麼會(huì)發(fā)生全局 NPM 模塊依賴項(xiàng)問(wèn)題？

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

我能否通過(guò)始終本地安裝包來(lái)避免全局 NPM 模塊依賴項(xiàng)問(wèn)題？

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

有什麼工具或包可以幫助我管理我的 Node.js 依賴項(xiàng)？

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

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

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

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

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

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

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

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