對(duì)于一個(gè)項(xiàng)目,常用的一些npm簡(jiǎn)單命令包含的功能有:初始化一個(gè)文件夾( npm init ),下載npm模塊( npm install ),創(chuàng)建測(cè)試( npm test ) 和自定義腳本( npm run )。但是,進(jìn)一步了解一些 npm 的使用技巧可以徹底改變你的日常開發(fā)任務(wù)。
注: 如果你需要關(guān)于初學(xué)npm的參考,可以參閱我們的初學(xué)者指南。如果你對(duì) npm 和 Yarn 之間的差異感到困擾,可以參閱我們發(fā)表的文章:Yarn vs npm:你需要知道的一切
獲取幫助
npm 文檔 和 CLI 命令行文檔 是非常不錯(cuò)地的學(xué)習(xí)資料,但需要通過瀏覽器訪問,這并不是很方便。因而可以通過命令行快速獲取所有可選項(xiàng):
npm help
此外,還能獲取特定 npm 命令的使用幫助:
npm help
例如:npm help install
另一種方式是通過下面的命令:
npm -h
npm 命令自動(dòng)完成
npm 通過bash提供了命令自動(dòng)完成功能(包括 Bash for Windows 10 ):
npm completion >> ~/.bashrc
//or Z shell
npm completion >> ~/.zshrc
重新加載shell配置文件:
source ~/.bashrc
現(xiàn)在,在終端注入 npm ins ,然后按下 tab 鍵就會(huì)出現(xiàn) install 了,不會(huì)再浪費(fèi)時(shí)間去全部輸入了。
修復(fù)全局模塊的權(quán)限
當(dāng)你試圖安裝全部模塊時(shí),類 Linux 系統(tǒng)可能會(huì)拋出權(quán)限錯(cuò)誤,可以在npm命令之前添加 sudo 來(lái)執(zhí)行,但這是一個(gè)較危險(xiǎn)的選擇。一個(gè)更高的解決方式是改變 npm 默認(rèn)的模塊安裝目錄:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
使用適當(dāng)?shù)奈谋揪庉嬈鲗⑾旅娴囊恍刑砑拥?~/.bashrc 或者 ~/.zshrc 文件中:
export PATH="$HOME/.npm-global/bin:$PATH"
重新加載配置文件(source ~/.bashrc),然后重新安裝npm到用戶所屬路徑:
npm install -g npm
這也會(huì)更新npm。
持續(xù)更新npm
你可以通過下面的命令顯示npm當(dāng)前的版本:
npm -v
如果有需要,可以通過下面的命令更新npm:
npm install -g npm
當(dāng) Node 的主版本 released 之后,你也可能需要重新構(gòu)建 C++ 擴(kuò)展:
npm rebuild
如果你需要管理多個(gè)版本的node.js和npm,可以考慮使用 n 或者 nvm。這有一篇關(guān)于 nvm 的文章:使用 nvm 安裝多版本的Node.js
定義默認(rèn)的 npm init
使用 npm init 初始化一個(gè)新的項(xiàng)目,這會(huì)提示你關(guān)于項(xiàng)目的更多細(xì)節(jié),并創(chuàng)建一個(gè) package.json 文件。
如果你厭倦了每次開始一個(gè)新的項(xiàng)目都需要重新輸入同樣的信息,可以使用 -y 標(biāo)記表示你能接受 package.json 文件的一堆默認(rèn)值:
npm init -y
或者你可以設(shè)置一些語(yǔ)義化的默認(rèn)值:
npm config set init.author.name
npm config set init.author.email
更精準(zhǔn)的模塊搜索
到目前為止,npm上已經(jīng)有超過350000個(gè)模塊了,并且每天還在持續(xù)增長(zhǎng)。盡管有很多非常棒的模塊,但是你還是想避免使用一些不受歡迎的、存在bug的或者無(wú)人維護(hù)的模塊。在 npmjs 和 Github 上搜索npm模塊是很實(shí)用但這還有一些其它選擇:
npms
npms 根據(jù)一個(gè)基于項(xiàng)目版本、模塊下載次數(shù)、最新更新日期、提交頻率、測(cè)試覆蓋率、文檔、貢獻(xiàn)者數(shù)量、issues數(shù)、star數(shù)、forks數(shù)和作者在社區(qū)的地位的綜合測(cè)量分?jǐn)?shù)進(jìn)行模塊排名。
npm Discover
npm Discover 定位于快速搜索和其它模塊通常一起使用的模塊,如 body-parser 通常和Express一起使用。
Packages by PageRank
Packages by PageRank 按照模塊的谷歌排名進(jìn)行搜索和排序。
Curated npm Lists
還一個(gè)選擇就是利用別人的搜索結(jié)果。當(dāng)需要一個(gè)健壯的解決方案時(shí),我經(jīng)常會(huì)參考 sindresorhus 的 Awesome Node.js。
管理你的模塊
你已經(jīng)安裝了一些模塊,看看都有啥:
npm list
(ls、la & ll 可以用作 list 的別名)
該命令會(huì)顯示所有模塊:(安裝的)模塊,子模塊以及子模塊的子模塊等??梢韵拗戚敵龅哪K層級(jí):
npm list --depth=0
打開一個(gè)模塊的主頁(yè):
npm home
這只有在你的系統(tǒng)能打開瀏覽器時(shí)有用–在服務(wù)端的系統(tǒng)上會(huì)失敗。同樣,可以打開一個(gè)模塊的 Github 倉(cāng)庫(kù):
npm repo
或者它的文檔:
npm docs
或者它目前的bugs列表:
npm bugs
npm list 會(huì)顯示和你已經(jīng)安裝地模塊的關(guān)聯(lián)模塊—這些沒有在 package.json文件中被引用。你可以單獨(dú) npm uninstall 每一個(gè)模塊或者全部移除它們:
npm prune
如果安裝模塊時(shí)你添加了 –production 標(biāo)記或者 NODE_ENV 被設(shè)置成 production,package.json 文件中被指定為 devDependencies 的模塊也會(huì)被移除。
鎖定依賴
默認(rèn)情況下,當(dāng)用 –save/-S 或者 –save-dev/-D 安裝一個(gè)模塊時(shí),npm 通過脫字符(^)來(lái)限定所安裝模塊的主版本號(hào)。例如,當(dāng)運(yùn)行 npm update 時(shí), ^1.5.1 允許安裝版本號(hào)大于 1.5.1 但小于 2.0.0 版本的模塊。
波浪號(hào)(~)字符是限定模塊的次要版本。例如,當(dāng)運(yùn)行 npm update 時(shí), ~1.5.1 允許安裝版本號(hào)大于 1.5.1 但小于 1.6.0 版本的模塊??梢詫⑿枰惭b的模塊版本前綴默認(rèn)設(shè)置成波浪號(hào)(~):
npm config set save-prefix="~"
對(duì)于那些偏執(zhí)的認(rèn)為任何更新(模塊的行為)會(huì)破壞系統(tǒng)的人,可以配置npm僅安裝精確版本號(hào)的模塊:
npm config set save-exact true
另一個(gè)選擇是,可以在項(xiàng)目中使用 shrinkwrap:
npm shrinkwrap
這會(huì)生成一個(gè) shrinkwrap.json 文件,該文件包含了你正在使用的模塊的指定版本。當(dāng)運(yùn)行 npm install 時(shí),該文件所指定的模塊版本會(huì)覆蓋 package.json 文件中所指定的版本。
找出過時(shí)的模塊
怎么知道一個(gè)模塊已經(jīng)更新了呢?我之前的方式是先列舉出項(xiàng)目所依賴的模塊(npm list –depth=0),然后在 npmjs.com 上找到該模塊,手動(dòng)檢查該模塊的版本是否已經(jīng)更新。這非常費(fèi)時(shí)。幸運(yùn)的是,有一個(gè)更簡(jiǎn)單的方式:
npm outdated
或者 npm outdated -g 來(lái)查找全局模塊。
你也可以查看一個(gè)獨(dú)立模塊的當(dāng)前版本:
npm list
也可以查看檢驗(yàn)當(dāng)前和歷史版本:
npm view versions
npm view 會(huì)顯示一個(gè)獨(dú)立模塊的所有信息,包括它的依賴、關(guān)鍵字、更新日期、貢獻(xiàn)者、倉(cāng)庫(kù)地址和許可證等。
使用開發(fā)中的模塊
當(dāng)你正在開發(fā)一個(gè)模塊時(shí),會(huì)經(jīng)常想在其它項(xiàng)目中嘗試使用或者在任何一個(gè)目錄運(yùn)行它(如果你的應(yīng)用支持),這時(shí)沒必要將其發(fā)布到 npm,并全局安裝—僅需在該模塊所在目錄使用下面的命令:
npn link
該命令會(huì)為模塊在全局目錄下創(chuàng)建一個(gè)符號(hào)鏈接。可以通過下面的命令查看模塊引用:
npm list -g --depth=0
或者:
npm outdated -g
現(xiàn)在,就可以從命令行運(yùn)行模塊或者通過 require 在任何項(xiàng)目中引入該模塊。
另一個(gè)選擇是,可以通過文件路徑在 package.json 文件中聲明對(duì)該模塊的依賴:
"dependencies": {
??"myproject": "file:../myproject/"
}
參考
10 Tips and Tricks That Will Make You an npm Ninja