package.json與package-lock.json的區(qū)別及詳細(xì)解釋
package.json
記錄當(dāng)前項目所依賴模塊的版本信息,更新模塊時鎖定模塊的大版本號(版本號的第一位),不能鎖定后面的小版本,
package-lock.json
package-lock.json 是在 `npm install`時候生成一份文件。記錄了node_modules目錄下所有模塊(包)的名稱、版本號、下載地址、及這個模塊又依賴了哪些依賴。
兩者區(qū)別:
npm5以前
npm5以前,沒有package-lock.json這個文件。package.json文件會記錄你項目中所需要的所有模塊。當(dāng)你執(zhí)行npm install的時候,node會先從package.json文件中讀取所有dependencies信息,然后根據(jù)dependencies中的信息與node_modules中的模塊進(jìn)行對比,沒有的直接下載,已有的檢查更新。
因為package.json只能鎖定模塊的大版本號(版本號的第一位),不能鎖定后面的小版本,所以你每次重新npm install時候拉取的都是該大版本下面最新的版本。一般我們?yōu)榱朔€(wěn)定性考慮我們不能隨意升級依賴包,因為如果換包導(dǎo)致兼容性bug出現(xiàn)很難排查,這樣很容易出現(xiàn)問題,所以package-lock.json就是來解決包鎖定不升級問題的
另外,package.json文件只記錄你通過npm install方式安裝的模塊信息,而這些模塊所依賴的其他子模塊的信息不會記錄。
npm5以后
package-lock.json文件鎖定所有模塊的版本號,包括主模塊和所有依賴子模塊。當(dāng)你執(zhí)行npm install的時候,node從package.json文件讀取模塊名稱,從package-lock.json文件中獲取版本號,然后進(jìn)行下載或者更新。
因此,正因為有了package-lock.json文件鎖定版本號,所以當(dāng)你執(zhí)行npm install的時候,node不會自動更新package.json文件中的模塊,必須用npm install packagename@x.x.x(指定版本號)來進(jìn)行安裝才會更新,package-lock.json文件中的版本號也會隨著更新。
package-lock.json的作用
如果重新 npm install 的時候以及當(dāng)node_modules文件夾并不存在或被刪除時,需要用到npm install重新裝載全部依賴時,通過package-lock.json可以直接表明下載地址和相關(guān)依賴,就無需再從package.json逐個分析包的依賴項,因此會大大加快安裝速度,package-lock.json目的就是確保所有庫包與你上次安裝的完全一樣。
如果要升級package-lock.json里面的庫包
npm install XXX@x.x.x
補(bǔ)充:關(guān)于package-lock.json的詳細(xì)解釋
關(guān)于package-lock.json的解釋
npm官方文檔: http://caibaojian.com/npm/files/package.json.html
Node.js v8.0 后,自帶的 npm 也升級到了5.0的確帶來了不少便利,大概講一下 npm 5 的一些大的變化:
- 使用npm install xxx命令安裝模塊時,不再需要–save選項,會自動將模塊依賴信息保存到 package.json 文件;
- 安裝模塊操作(改變 node_modules 文件夾內(nèi)容)會生成或更新 package-lock.json 文件;
- 發(fā)布的模塊不會包含 package-lock.json 文件;
- 如果手動修改了 package.json 文件中已有模塊的版本,直接執(zhí)行npm install不會安裝新指定的版本,只能通過npm install xxx@yy更新
重新安裝模塊之所以快,是因為 package-lock.json 文件中已經(jīng)記錄了整個 node_modules 文件夾的樹狀結(jié)構(gòu),甚至連模塊的下載地址都記錄了,再重新安裝的時候只需要直接下載文件即可(這樣看起來 facebook 的 yarn 好像沒有啥優(yōu)勢了);
package-lock.json文件的產(chǎn)生:
- package.json文件下載到的依賴包可能在不同的情況下,各庫包的版本語義可能并不相同,有的庫包開發(fā)者并不嚴(yán)格遵守這一原則:相同大版本號的同一個庫包,其接口符合兼容要求。
- 產(chǎn)生問題:在不同時間或者不同npm下載源之下,下載的各依賴包版本可能有所不同,因此其依賴庫包行為特征也不同,有時候甚至完全不兼容。
- npm5開始提供自動生成package-lock.json文件的功能,為的是讓開發(fā)者知道只要你保存了源文件,到一個新的機(jī)器上、或者新的下載源,只要按照這個package-lock.json文件所標(biāo)識的具體版本下載依賴庫包,就能確保所有庫包與上次的安裝完全一樣;
- npm的下載源改為私服地址,這樣產(chǎn)生的package-lock.json文件的版本號是這個私服上設(shè)置好的版本號
以下是 package-lock.json 文件的例子:
package-lock.json是當(dāng) node_modules 或 package.json發(fā)生變化時自動生成的文件。這個文件主要功能是確定當(dāng)前安裝的包的依賴,以便后續(xù)重新安裝的時候生成相同的依賴,而忽略項目開發(fā)過程中有些依賴已經(jīng)發(fā)生的更新
{
"name": "test_pkg_lock",
"version": "1.0.0",
"lockfileVersion": 1,
"dependencies": {
"commander": {
"version": "2.9.0",
"resolved": "https://registry.npmjs.org/commander/-/commander-2.9.0.tgz",
"integrity": "sha1-nJkJQXbhIkDLItbFFGCYQA/g99Q="
},
"cssfilter": {
"version": "0.0.8",
"resolved": "https://registry.npmjs.org/cssfilter/-/cssfilter-0.0.8.tgz",
"integrity": "sha1-ZWTKzLqKdt2bS5IGaLn7f9pQ5Uw="
},
"graceful-readlink": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/graceful-readlink/-/graceful-readlink-1.0.1.tgz",
"integrity": "sha1-TK+tdrxi8C+gObL5Tpo906ORpyU="
},
"xss": {
"version": "0.2.18",
"resolved": "https://registry.npmjs.org/xss/-/xss-0.2.18.tgz",
"integrity": "sha1-bfX7XKKL3FHnhiT/Y/GeE+vXO6s="
}
}}
帶來速度的同時,npm 也挖了個大大的坑:
以后直接改 package.json 文件相應(yīng)模塊的版本號,再執(zhí)行npm install不會更新了(好可怕),你只能手動用npm install xxx@yy指定版本號來安裝,然后它會自動更新 package-lock.json 文件。直接執(zhí)行npm install時,如果不存在 package-lock.json 文件,它會根據(jù)安裝模塊后的 node_modules 目錄結(jié)構(gòu)來創(chuàng)建;如果已經(jīng)存在 package-lock.json 文件,則它只會根據(jù) package-lock.json 文件指定的結(jié)構(gòu)來下載模塊,并不會理會 package.json 文件
網(wǎng)上已經(jīng)有很多人反應(yīng)這個問題了:GitHub 上的 issue:package-lock.json file not updated after package.json file is changed
clean project with some deps in package.json.you run npm imodules are
installed and package-lock.json file is created.say you update module
A in package.json file.you run npm i. I would expect this updates the
package-lock.json file but it doesn’t. which results in module A not
being updated.
總結(jié)
到此這篇關(guān)于package.json與package-lock.json的區(qū)別及詳細(xì)解釋的文章就介紹到這了,更多相關(guān)package.json與package-lock.json內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
JavaScript中Object.values()的用法舉例
這篇文章主要給大家介紹了關(guān)于JavaScript中Object.values()的用法舉例,Object.values()是JavaScript中一個內(nèi)置的靜態(tài)函數(shù),用于返回一個對象中所有屬性值的數(shù)組,需要的朋友可以參考下2023-09-09
javascript 實現(xiàn)劃詞標(biāo)記劃詞搜索功能
在頁面中加上這串代碼就行了,同時還有搜索功能。2009-10-10
JavaScript實現(xiàn)鼠標(biāo)點擊后層展開效果的方法
這篇文章主要介紹了JavaScript實現(xiàn)鼠標(biāo)點擊后層展開效果的方法,可實現(xiàn)點擊文字緩慢展開層的效果,具有一定參考借鑒價值,需要的朋友可以參考下2015-05-05
使用 Jest 和 Supertest 進(jìn)行接口端點測試實例詳解
這篇文章主要介紹了使用 Jest 和 Supertest 進(jìn)行接口端點測試,結(jié)合實例形式詳細(xì)分析了使用 Jest 和 Supertest 進(jìn)行接口端點測試具體原理、操作技巧與相關(guān)注意事項,需要的朋友可以參考下2020-04-04
JavaScript實現(xiàn)讀取與輸出XML文件數(shù)據(jù)的方法示例
這篇文章主要介紹了JavaScript實現(xiàn)讀取與輸出XML文件數(shù)據(jù)的方法,結(jié)合實例形式分析了JavaScript基于ActiveXObject實現(xiàn)載入、讀取與輸出xml文件數(shù)據(jù)的相關(guān)操作技巧,需要的朋友可以參考下2018-06-06
js 獲取坐標(biāo) 通過JS得到當(dāng)前焦點(鼠標(biāo))的坐標(biāo)屬性
通過JS得到當(dāng)前焦點的坐標(biāo),如何實現(xiàn),接下來詳細(xì)介紹實現(xiàn)步驟,有需要的朋友可以參考下2013-01-01

