nodejs進階教程,小白繞道!!! npm使用技巧和最佳實踐 前提:請確保全裝了node.js npm的最佳實踐 npm install是最常見的npm cli命令,但是它還有更多能力!接下來你會瞭解npm是如何在應用的整個生命周期幫助你的-從創建一個項目到開發和部署整個生命周期 認識npm 在開 ...
nodejs進階教程,小白繞道!!!
npm使用技巧和最佳實踐
前提:請確保全裝了node.js
npm的最佳實踐
npm install
是最常見的npm cli命令,但是它還有更多能力!接下來你會瞭解npm是如何在應用的整個生命周期幫助你的-從創建一個項目到開發和部署整個生命周期
認識npm
在開始之前,我們先來看看一些查看正在運行的npm版本的命令
npm version
獲取當前npm cli正在使用的版本,你可以執行命令 npm version
,這條命令除了返回版本外,還可以返回很多信息-當前包的版本,你正在使用的node.js的版本,openSSL或者V8的版本,以我本地安裝的node為例,結果如下:
npm help
和大多數的命令行工具一樣,npm也有一個內置的幫助函數, 可以獲取命令的描述和提要,比入我們想看看npm test命令是做什麼的,執行 npm help test
1 使用 npm init
創建新項目
使用 npm init
命令可以幫助你互動式地創建 package.json
文件,會彈出項目名稱和描述的問題,有一個快速的解決方法 npm init--yes
(或者簡寫 npm init-y
),那麼就不會彈出任何問題了,僅僅是使用預設配置創建一個 package.json
, 使用下麵的命令,你可以配置這些預設配置
npm config set init.author.name YOUR_NAME
npm config set init.author.email YOUE_EMAIL
2 查找正確的npm包
查找正確的npm包相當具有挑戰性-有成千上萬的包可供選擇,因此選擇正確的npm 包很令人苦惱了,然而,我們可以選擇一個模塊幫助我們發送HTTP請求 有一個網站可以幫助我們簡單地完成這個任務,它就是npms.io,它會展示包的質量,受歡迎度,和維護性,這些是通過一個模塊是否更新了依賴,是否有提示配置,是否做了測試覆蓋,最近有沒有提交記錄來綜合計算得出的
3 檢查npm包
一旦我們找到了我們的模塊(在我們的例子中是一個request模塊),我們應該看一下文檔,查看issues,以便更好地瞭解我們即將引入到應用中的包,不要忘記你使用的npm包越多,你的項目的風險就越高
如果你想在cli中打開這個模塊的首頁,執行
npm home request
打開模塊的issues
npm bugs request
或者你只是想查看模塊的git倉庫,執行下麵的命令
npm repo request
4 保存依賴
npm採用semver進行控制
所謂SEMVER,指的是語義化版本,其規則概述如下: 版本格式:主版本號.次版本號.修訂號,版本號遞增規則如下:
- 主版本號:新的架構調整,不相容老版本
- 次版本號:新增功能,相容老版本
- 修訂號:修複bug,相容老版本。
一旦你決定將第三方包引入你的項目,你必須安裝和保存它,最常見的命令是 npm install some-package
,如果你想自動將包信息添加進 package.json
文件,你需要執行 npm install some-package--save
npm預設會帶著'^’這個首碼保存你的包,具體的安裝規則如下:
^version
相容某個版本
版本號中最左邊的非0數字的右側可以任意
如果缺少某個版本號,則這個版本號的位置可以任意
如:^1.1.2 ,表示>=1.1.2<2.0.0,
可以是1.1.2,1.1.3,.....,1.1.n,1.2.n,.....,1.n.n
如:^0.2.3 ,表示>=0.2.3 <0.3.0,
可以是0.2.3,0.2.4,.....,0.2.n
如:^0.0,表示 >=0.0.0 <0.1.0,
可以是0.0.0,0.0.1,.....,0.0.n
這也意味著當你下次執行 npm install
的時候,即使主版本沒有更改,次版本或者修訂版本發生了改變,你的這個模塊會重裝,你可以執行下麵的命令修改安裝包版本規則 npm configsetsave-prefix='~'
這個包首碼的安裝規則如下:
~version
大概匹配某個版本
如果minor版本號指定了,那麼minor版本號不變,而patch版本號任意
如果minor和patch版本號未指定,那麼minor和patch版本號任意
如:~1.1.2,表示>=1.1.2 <1.2.0,可以是1.1.2,1.1.3,.....,1.1.n
如:~1.1,表示>=1.1.0 <1.2.0
如:~1,表示>=1.0.0<2.0.0,
可以是1.0.0,1.0.1,.....,1.1.n,1.2.n,.....,1.n.n
如果你想保存指定的版本號,執行 npm configsetsave-exacttrue
5 鎖定依賴
上面已經介紹過了,npm採用語義化的版本號 semver 進行控制,讓開發過程中依賴的獲取和升級變得非常容易,但不嚴格的版本號控制,也帶來了不確定性
- npm建議使用semver版本,但是部分包不遵循semver;
- package.json 可以使用精確的版本號控制你的直接依賴包,但第三方依賴的包無法管理;
- 在開發階段執行得到的包的版本,和後續部署時得到的可能是不一致的,更不可控的是,你依賴的第三方包也有這樣的情況會導致潛在的上線風險。
可以用 npm shrinkwrap
解決這個問題,這條命令會生成一個npm-shrinkwrap.json,這個文件裡面不僅包含了安裝在你機器上的指定版本的包,而且還有包的指定版的依賴包,一旦在項目的根目錄下有這個文件,你執行 npm install
命令會重新生成一個相同的依賴樹
6 檢查項目的依賴包有無更新
npm有一個內置的工具方法命令 npm outdated
可以檢查過時的包,在你項目下運行`npm outdated'即可,但是手動執行檢查更新命令就很煩了,有一個可以自動執行包更新檢查的工具Greenkeeper,有興趣的童鞋可以戳進鏈接瞭解。
7 開發包
在本地開發npm包的時候,我們可以使用 npm link
命令,將npm模塊鏈接到對應的運行項目中去,方便地對模塊進行調試和測試
舉個例子來說明是什麼意思以及怎麼使用吧
我們現在有兩個項目,分別是npm-link-module和npm-link-test,其中npm-link-module是我們要開發的npm包,npm-link-test用來測試我們開發的包
在npm-link-module下執行 npm init-y
生成一個預設的包配置文件package.json,在目錄下新建index.js如下,寫個簡單的日期轉換函數
function formateTime(date) {
let year = date.getFullYear();
let month = date.getMonth() + 1;
let day = date.getDay();
month = month < 10 ? '0' + month : month;
day = day < 10 ? '0' + day : day;
return year + '-' + month + '-' + day;
}
module.exports = formateTime
然後執行 npm link
, 執行命令後,npm-link-module會根據package.json上的配置,被鏈接到全局,路徑是 {prefix}/lib/node_modules/<package>
,這是官方文檔上的描述,我們可以使用npm config get prefix命令獲取到prefix的值(我使用的是windows,實際被鏈接到的路徑是 {prefix}/node_modules/<package>
) 我們可以看到,已經在這個目錄下麵生成了一個npm-link-module的快捷方式
再進入npm-link-test,執行 npm init-y
生成包文件,接著執行 npm link npm-link-module
可以看到在這個項目的node_modules目錄下生產了一個npm-link-module的快捷方式 現在npm-link-test這個項目就可以引用這個 npm-link-module
這個模塊了
我們在npm-link-test的目錄下新建index.js文件,內容如下
let formateTime = require('npm-link-module');
let date = new Date();
console.log(formateTime(date));
然後執行node index.js,可以看到命令行已經列印出函數的執行結果了
然後,我們修改下npm-link-module中的index.js文件的日期函數,返回結果就修改成返回斜線格式的日期
return year + '/' + month + '/' + day;
再回到npm-link-test目錄下執行index.js,可以看到,返回結果已經變成了斜線的日期
看到了吧,所有對npm-link-module的修改會被直接映射到npm-link-test/node_modules/npm-link-module
說明一下,這個nodejs進階教程計劃寫10篇左右,現在心中有大致的框架,所以準備邊寫邊梳理,寫完會將教程目錄列出來
下麵是我的個人前端公眾號,歡迎大家掃碼關註,第一時間獲取教程的更新信息