本篇文章帶大家深度解析一下node的包和強(qiáng)大的包管理工具,希望對大家有所幫助!
node.js極速入門課程:進(jìn)入學(xué)習(xí)
什么是包
Node.js 中的
第三方模塊
又叫做包。就像
電腦
和計算機(jī)
指的是相同的東西,第三方模塊和包指的是同一個概念,只不過叫法不同。【相關(guān)教程推薦:nodejs視頻教程】
包從哪里來的?
不同于 Node.js 中的內(nèi)置模塊
與自定義模塊
,包是由第三方個人或團(tuán)隊開發(fā)出來的
,免費(fèi)供所有人使用。
在這里記筆記:免費(fèi)的?。。?/code>
為什么我們要用包?
由于 Node.js 的內(nèi)置模塊僅提供了一些
底層的 API
,導(dǎo)致在基于內(nèi)置模塊進(jìn)行項目開發(fā)的時,效率很低
。
包是基于內(nèi)置模塊封裝出來的,提供了更高級、更方便的 API,極大的提高了開發(fā)效率。 包和內(nèi)置模塊之間的關(guān)系,類似于jQuery 和 瀏覽器內(nèi)置 API
之間的關(guān)系。(jq是將瀏覽器內(nèi)置的api進(jìn)行了封裝
)
包從哪里下載?
國外有一家 IT 公司,叫做npm, Inc
. 這家公司旗下有一個超級牛的網(wǎng)站: https://www.npmjs.com ,它是全球最大的包共享平臺,你可以從這個網(wǎng)站上搜索到任何你需要的包!
怎么下載包
npm, Inc.
公司提供了一個包管理工具,我們可以使用這個包管理工具,從 https://registry.npmjs.org 服務(wù)器把需要的包下載到本地使用。
這個包管理工具的名字叫做 Node Package Manager(簡稱 npm 包管理工具
),這個包管理工具隨著 Node.js 的安裝,包一起被安裝到了用戶的電腦上。
我們可以在終端中輸入
npm -v
來查看npm包管理工具的版本號
注意 : 我們的npm版本可能不一樣,大家不要恐慌
npm初體驗
使用 npm 包管理工具,在項目中安裝格式化時間的包
moment
代碼示例:
const moment = require('moment')const dt = moment().format('YYYY-MM-DD')console.log(dt); // 2022-09-18
注意:這里的
YYYY-MM-DD
是年月日的符號標(biāo)識,在網(wǎng)站https://momentjs.com/docs中可以詳細(xì)的了解.
如果你想安裝自己需要的包,可以使用以下命令:npm install xxx
或者 npm i xxx
(這個是簡寫形式,更加的方便快捷)
初次裝包完成后,在項目文件夾下多一個叫做
node_modules
的文件夾和package-lock.json
的配置文件。
其中:
-
node_modules 文件夾
用來存放所有已安裝到項目中的包
。require() 導(dǎo)入第三方包時,就是從這個目錄中查找并加載包。 -
package-lock.json 配置文件
用來記錄 node_modules 目錄下的每一個包的下載信息,例如包的名字、版本號、下載地址等
。
注意:我們不要手動修改
node_modules
或package-lock.json
文件中的任何代碼,npm 包管理工具會自動維護(hù)它們。
默認(rèn)情況下,使用 npm install 命令安裝包的時候,
會自動安裝最新版本的包
。如果需要安裝指定版本的包,可以在包名之后,通過@
符號指定具體的版本
代碼示例:
在這里將會解決大家一直困惑的問題,
這個版本號那一串?dāng)?shù)字到底是啥子意思
,在這里黑馬哥良心的教學(xué)讓我直呼好家伙!真心詳細(xì)!!!(好好看,好好學(xué))
包的版本號是以“點分十進(jìn)制
”形式進(jìn)行定義的,總共有三位數(shù)字
,例如 2.24.0
其中每一位數(shù)字所代表的的含義如下:
-
第1位數(shù)字:
大版本
(比如:我們所玩的王者榮耀每過幾個月都會有大版本更新,那么的化第一位數(shù)字就會發(fā)生變化,大家下次觀察一波) -
第2位數(shù)字:
功能版本
(比如:王者榮耀的某個版本添加了新的功能,又叫小更新
) -
第3位數(shù)字:
Bug修復(fù)版本
(比如:修復(fù)了閃退的bug,修復(fù)了人物模型的失真bug…)
版本號提升的規(guī)則:
只要前面的版本號增長了,則后面的版本號歸零
包管理配置文件
npm 規(guī)定,在項目根目錄中
,必須提供一個叫做 package.jso
n 的包管理配置文件。用來記錄與項目有關(guān)的一些配置信息。例如:
-
項目的
名稱、版本號、描述
等 -
項目中
都用到了哪些包
-
哪些包只在開發(fā)期間會用到
-
那些包在
開發(fā)
和部署
時都需要用到
在這里先給大家舉一個例子:我們在進(jìn)行多人項目開發(fā)時候,我們把自己寫的代碼交到碼云上,我
們總不能把node_modules
安裝的依賴也提交上去啊,所以我們不把node_modules
提交上去,因為第三方模塊的所占的體積過大,經(jīng)常會出現(xiàn)我們的代碼總共才1M,第三方包都占30M,所以我們進(jìn)行剔除.
剔除方法:
在.gitignore
文件中輸入node_modules
即可!
在項目根目錄
中,創(chuàng)建一個叫做 package.json
的配置文件,即可用來記錄項目中安裝了哪些包。從而方便剔除node_modules
目錄之后,在團(tuán)隊成員之間共享項目的源代碼。
注意:今后在項目開發(fā)中,一定要把 node_modules
文件夾,添加到 .gitignore
忽略文件中。
npm 包管理工具提供了一個快捷命令,可以在執(zhí)行命令時所處的目錄中,快速創(chuàng)建 package.json
這個包管理配置文件:npm init -y
注意:
上述命令只能在英文的目錄下
成功運(yùn)行!所以,項目文件夾的名稱一定要使用英文命名
,不要使用中文,不能出現(xiàn)空格。
運(yùn)行npm install
命令安裝包的時候,npm 包管理工具會自動把包的名稱和版本號
,記錄到package.json
中。
{ "name": "3", "version": "1.0.0", "description": "", "main": "index.js", "scripts": { "test": "echo "Error: no test specified" && exit 1" }, "keywords": [], "author": "", "license": "ISC", "dependencies": { "art-template": "^4.13.2", "jquery": "^3.6.1", "moment": "^2.22.2" }}
package.json 文件中,有一個 dependencies
節(jié)點,專門用來記錄您使用 npm install 命令安裝了哪些包
。例如:我們上面的代碼中的"art-template": "^4.13.2","jquery": "^3.6.1","moment": "^2.22.2"
,說明了我們安裝了art-template
、jquery
、moment
這三個包!
當(dāng)我們從gitee上拉下來一個項目代碼,里面是沒有node_modules
,這就需要我們自己去安裝依賴,需要先把所有的包下載到項目中,才能將項目運(yùn)行起來。否則項目就不會跑起來!
那我們怎么做才能讓項目跑起來呢?別著急,我們只需在終端中運(yùn)行npm install(npm i)
就行了!這里運(yùn)行這個代碼的目的是一次性安裝我們需要的所有依賴!
可以運(yùn)行 npm uninstal
l 命令,來卸載指定的包,比如,我們需要卸載moment
包,我們可以執(zhí)行代碼:npm uninstall moment
注意:npm uninstall
命令執(zhí)行成功后,會把卸載的包,自動從 package.json 的 dependencies 中移除掉
如果某些包只在項目開發(fā)階段
會用到,在項目上線之后不會用到,則建議把這些包記錄到 devDependencies
節(jié)點中。
與之對應(yīng)的,如果某些包在開發(fā)和項目上線之后都需要用到
,則建議把這些包記錄到dependencies
節(jié)點中
你可以使用如下的命令,將包記錄到 devDependencies
節(jié)點中:
//安裝指定的包,并且記錄到 devDependencies 節(jié)點中npm i 包名 -D// 上部代碼是簡寫形式,下部的代碼是完整寫法:npm install 包名 --save-dev
到這里,你就想問一個問題,那我怎么知道我安裝的這個包需不需要放在
devDependencies
呢?
一般情況下我們?nèi)pm網(wǎng)站中搜索你需要的包,它會提示你該包是否需要記錄到devDependencies
中!
解決下包速度慢的問題
不難發(fā)現(xiàn),我們在安裝包的時候它的速度也太慢了吧?為什么會發(fā)生這種情況呢?
因為:在使用 npm 下包的時候,默認(rèn)從國外的 https://registry.npmjs.org/ 服務(wù)器進(jìn)行下載,此時,網(wǎng)絡(luò)數(shù)據(jù)的傳輸需要經(jīng)過漫長的海底光纜
,因此下包速度會很慢。
為了解決下載速度慢的問題,淘寶在國內(nèi)搭建了一個服務(wù)器,專門把國外官方服務(wù)器上的包同步到國內(nèi)的服務(wù)器
,然后在國內(nèi)提供下包的服務(wù)。從而極大的提高了下包的速度。
鏡像(Mirroring
)是一種文件存儲形式
,一個磁盤上的數(shù)據(jù)在另一個磁盤上存在一個完全相同的副本即為鏡像。
我們已經(jīng)知道了淘寶鏡像可以幫助我們快速的下載包,那么怎么才能切換到淘寶鏡像源呢?
在終端中執(zhí)行以下三步:
-
首先查看我們當(dāng)前的鏡像源:
npm config get registry
-
將下包的鏡像源切換為淘寶鏡像源:
npm config set registry=https://registry.npmmirror.com/
-
查看鏡像源是否下載成功 :
npm config get registry
我們?nèi)绻扇〕R?guī)的切換鏡像源的方法,未免有點繁瑣,為了更方便的切換下包的鏡像源,我們可以安裝
nrm
這個小工具,利用 nrm 提供的終端命令,可以快速查看和切換下包的鏡像源
。
-
將
nrm
安裝為全局可用的工具 :npm i nrm -g
-
查看所有的鏡像源 :
nrm ls
-
將下載包的鏡像源切換為 taobao 鏡像 :
nrm use taobao
顯示這樣的話,就說明我們切換成功啦!
包的分類
使用 npm 包管理工具下載的包,共分為兩大類,分別是:1. 項目包
2. 全局包
那些被安裝到項目的 node_modules
目錄中的包,都是項目包
。
項目包又分為兩類,分別是:開發(fā)依賴包
(被記錄到 devDependencies
節(jié)點中的包,只在開發(fā)期間
會用到)核心依賴包
(被記錄到 dependencies
節(jié)點中的包,在開發(fā)期間和項目上線
之后都會用到)
在執(zhí)行 npm install
命令時,如果提供了 -g
參數(shù),則會把包安裝為全局包
。
全局包會被安裝到 C:Users用戶目錄AppDataRoamingnpmnode_modules
目錄下。
注意:
只有
工具性質(zhì)的包
,才有全局安裝的必要性。因為它們提供了好用的終端命令。判斷某個包是否需要全局安裝后才能使用,可以
參考官方提供的使用說明
即可。
i5ting_toc
是一個可以把 md 文檔轉(zhuǎn)為 html 頁面
的小工具(這個真的是嘎嘎好用
,比如,如果我們在網(wǎng)上找學(xué)習(xí)資源的時候,部分會把筆記記為md文檔,我們使用瀏覽器打開md文檔布局特別的難以接受~),使用步驟如下:
# 將 i5ting_toc 安裝為全局包 npm i -g i5ting_toc # 調(diào)用 i5ting_toc ,輕松實現(xiàn) md 轉(zhuǎn) html 的功能 i5ting_toc -f 要轉(zhuǎn)的md文件路徑 -o
上述代碼中
-o
的意思是,我們將在默認(rèn)的瀏覽器中打開這個轉(zhuǎn)化后的md文件
規(guī)范的包結(jié)構(gòu)
在清楚了包的概念、以及如何下載和使用包之后
,接下來,我們深入了解一下包的內(nèi)部結(jié)構(gòu)
。
一個規(guī)范的包,它的組成結(jié)構(gòu),必須符合以下 3 點要求
:
-
包必須以
單獨(dú)的目錄
而存在 -
包的頂級目錄下要必須包含
package.json
這個包管理配置文件 -
package.json
中必須包含name,version,main
這三個屬性,分別代表包的名字、版本號、包的入口
舉例:
小結(jié)
?本篇文章,詳細(xì)的解析了node中包的概念和npm,npm在日常開發(fā)中根本離不開,在框架中,也要使用npm去安裝架構(gòu),所以npm的學(xué)習(xí)必須是要透徹的,不要糊弄過去